# TAM Graph

Flat-rate, unlimited company data API built for AI agents. No credits, no
seats, no per-record pricing. Base URL: https://api.tamgraph.com

## Auth
Pass your API key in the `X-API-Key` header on every request. Get a free
key (2,500 records/day) instantly at https://api.tamgraph.com/login — no card
required. Paid plans at https://api.tamgraph.com/dashboard: Starter $49/month
(50,000 records/month) or Unlimited $249/month (no record caps, fair use
500,000 records/day).

## Endpoints
- GET /v1/datasets — catalog of datasets with sizes, allowed filters, and
  query hints. Read this first; it is machine-readable.
- POST /v1/search/{dataset} — body: {"filters": {...}, "limit": 25,
  "cursor": null}. Datasets: companies (36M global companies), local (2.3M
  US local businesses with emails), places (4.9M Google Maps places),
  ecommerce (2.9M online stores with revenue estimates and installed apps),
  startups (1.7M companies with funding data), saas (170k SaaS companies).
  Filters support exact values, lists (OR), and _gte/_lte suffixes on
  numeric/date fields. Unknown filter fields return 400 with the allowed
  list. Paginate by passing next_cursor back as cursor; no depth limit.
- GET /v1/company/{domain} — merged record for one company across all
  datasets, including generic emails and email pattern when known.
- GET /v1/email-pattern/{domain} — email naming pattern (e.g. first.last),
  generic inboxes, MX records.

## Example
curl -X POST https://api.tamgraph.com/v1/search/ecommerce \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"filters": {"platform": "Shopify", "country": "US", "monthly_sales_gte": 100000}, "limit": 5}'

## Notes
- Responses omit empty fields. All company records share one core schema
  (domain, name, linkedin_url, country, region, locality, industry,
  employee_range/employee_count, founded, emails, socials) plus a
  dataset-specific extension block (local / ecommerce / startup / saas).
- Usage is metered on records returned — requests that return zero results
  are free. Rate limits: 60/min free, 120/min Starter, 300/min Unlimited.
- Query timeout: 20s.
- OpenAPI spec: https://api.tamgraph.com/openapi.json