{"openapi":"3.1.0","info":{"title":"TAM Graph","description":"Find any type of company, at scale. POST /v1/find describes the companies you need in plain English and an agent searches 75+ datasets and the live web until the list is complete (delivered by email, usually within 24 hours). Ask for people instead of companies and you get contacts: one row per person, with title and email. The underlying datasets — company graph, local businesses, ecommerce stores, startups, SaaS, Product Hunt launches, newsletter/podcast sponsors, agencies, email-format intelligence — are also queryable directly. Flat rate, no seats, no per-record pricing, no credits; the email finder is included and unlimited under fair use. Auth: X-API-Key header.","version":"1.0"},"paths":{"/v1/find":{"post":{"summary":"Find","description":"Queue an agent-run company or contact search.\n\nDescribe the companies you need in plain English. An agent works the\nrequest across every dataset and the live web until the list is complete,\nthen emails it — usually within 24 hours. Poll GET /v1/find/{job_id} for\nstatus. Ask for people at those companies (a role or job title) and the\nlist comes back as contacts: one row per person, with title and email.","operationId":"find_v1_find_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/find/{job_id}":{"get":{"summary":"Find Status","description":"Status of one search you submitted. 404 for jobs you don't own.","operationId":"find_status_v1_find__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/find/{job_id}/csv":{"get":{"summary":"Find Csv","description":"Download the finished list of one of your searches as CSV.","operationId":"find_csv_v1_find__job_id__csv_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/find/{job_id}/results":{"get":{"summary":"Find Results Json","description":"The finished list as paginated JSON. Cursor-paginate with the returned\nnext_cursor; /csv returns the same list in one download.","operationId":"find_results_json_v1_find__job_id__results_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/datasets":{"get":{"summary":"List Datasets","description":"Machine-readable catalog: datasets, sizes, allowed filters, hints.","operationId":"list_datasets_v1_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/search/{dataset}":{"post":{"summary":"Search","description":"Search one dataset. Cursor-paginate with the returned next_cursor;\nthere is no page-depth limit.","operationId":"search_v1_search__dataset__post","parameters":[{"name":"dataset","in":"path","required":true,"schema":{"type":"string","title":"Dataset"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/company/{domain}":{"get":{"summary":"Company","description":"Merged view of one company across every dataset, keyed by domain.","operationId":"company_v1_company__domain__get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/email-pattern/{domain}":{"get":{"summary":"Email Pattern","description":"Email intelligence for a domain: verified naming pattern, known\ngeneric inboxes, and MX records.","operationId":"email_pattern_v1_email_pattern__domain__get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"FindBody":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":10,"title":"Query","description":"Plain-English description of the companies you need"},"notify_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notify Email","description":"Where to send the finished list; defaults to your account email"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Target number of rows; defaults to the complete matching set up to the row cap"}},"type":"object","required":["query"],"title":"FindBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"SearchBody":{"properties":{"filters":{"type":"object","title":"Filters"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":25},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"type":"object","title":"SearchBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}