FlatSearch API Documentation

https://flatsearchapi.com

# FlatSearch API — Complete Technical Reference

You are integrating the FlatSearch Live B2B Web & Dealer Intelligence API (https://flatsearchapi.com).

## Base URL
https://flatsearchapi.com

## Authentication
Every request requires:
- Content-Type: application/json
- X-API-Key: sp_live_... (Production) or sp_test_... (Developer Sandbox)

## 8 Production Endpoints Summary
1. POST /v1/dealers/find — Regional dealer discovery with direct phone verification & cited website evidence.
2. POST /v1/dealers/export — Streamed standardized CSV export formatted for Clay and Google Sheets.
3. POST /v1/company/enrich — Company profile: firmographics, SEC Form D, DNS MX records, and tech stack.
4. POST /v1/company/enrich/batch — Concurrent enrichment for up to 50 company domains.
5. POST /v1/search/fast — Synthesized search answer with inline source citations.
6. POST /v1/search/sources — Raw link & snippet extraction with normal and fast modes.
7. POST /v1/search/extended — Deep multi-query research with agentic intent verification.
8. POST /v1/extract — Clean token-efficient Markdown extraction from any public URL.

## Billing
Each plan includes a number of requests per endpoint group (search; research and dealers; pages and companies).
After that, each successful request is charged to the prepaid balance; with no balance left, requests return 403 USAGE_LIMIT_EXCEEDED.

Use exponential backoff (1s, 2s, 4s) when handling 429 or 503 HTTP responses.

curl -X POST https://flatsearchapi.com/v1/dealers/find \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{
    "query": "industrial pump distributors",
    "location": "Houston, TX",
    "limit": 10
  }'

{
  "query": "industrial pump distributors",
  "location": "Houston, TX",
  "total_found": 1,
  "dealers": [
    {
      "status": "success",
      "schema_version": 3,
      "domain": "airindustrialworks.com",
      "name": "Air Industrial Works, LLC (Pumps in Stock)",
      "phone": "(832) 301-3959",
      "emails": ["[email protected]"],
      "location": {
        "verified_address": "5946 S Loop E, Houston, TX 77033, USA",
        "street": "5946 S Loop E",
        "city": "Houston",
        "state": "TX",
        "postcode": "77033",
        "coordinates": { "lat": 29.6890756, "lng": -95.3296457 }
      },
      "ai_qualification": {
        "icp_fit": "HIGH",
        "fit_reason": "Stocking master distributor of industrial centrifugal, sump, and AODD diaphragm pumps with immediate Houston field dispatch."
      },
      "evidence": {
        "phone": "https://airindustrialworks.com",
        "source_urls": ["https://airindustrialworks.com/brands"]
      },
      "technographics": {
        "email_provider": "Rackspace Hosted Email (mx2.emailsrvr.com)",
        "detected_saas_tools": { "AI / LLMs": [], "Sales & CRM": ["QuickBooks Enterprise"] }
      }
    }
  ]
}

curl -X POST https://flatsearchapi.com/v1/dealers/export \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{
    "query": "CNC tooling dealers",
    "location": "Chicago, IL",
    "limit": 50
  }' \
  --output chicago_tooling_dealers.csv

curl -X POST https://flatsearchapi.com/v1/company/enrich \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{"domain": "fcxperformance.com"}'

{
  "status": "success",
  "domain": "fcxperformance.com",
  "name": "FCX Performance",
  "phone": "(214) 320-3604",
  "location": {
    "street": "9010 John W. Carpenter Fwy",
    "city": "Dallas",
    "state": "TX",
    "country": "United States",
    "coordinates": { "lat": 32.8264, "lng": -96.8822 }
  },
  "technographics": {
    "email_provider": "Mimecast Secure Gateway",
    "detected_saas_tools": {
      "AI / LLMs": ["Anthropic (Claude Enterprise)"],
      "Engineering & Product": ["Atlassian (Jira / Confluence)"]
    }
  },
  "hiring_intent": {
    "is_actively_hiring": true,
    "active_postings_count": 14,
    "departments": ["Field Engineering", "Inside Sales"]
  }
}

curl -X POST https://flatsearchapi.com/v1/company/enrich/batch \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{
    "companies": [
      {"domain": "elitepumps.net"},
      {"domain": "gcpumpinc.com"},
      {"domain": "airindustrialworks.com"}
    ]
  }'

curl -X POST https://flatsearchapi.com/v1/search/fast \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{"query": "Next.js 15 ERR_TOO_MANY_REDIRECTS iron-session subdomains"}'

curl -X POST https://flatsearchapi.com/v1/search/sources \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{
    "query": "Apple M4 chip architecture specifications",
    "num_results": 5,
    "mode": "fast",
    "categories": "general"
  }'

curl -X POST https://flatsearchapi.com/v1/search/extended \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{
    "query": "Compare Blackwell B200 vs Nvidia H200 GPU architecture, memory bandwidth, and availability timeline",
    "stream": false
  }'

curl -X POST https://flatsearchapi.com/v1/extract \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sp_live_YOUR_KEY" \
  -d '{"url": "https://news.ycombinator.com"}'