Guides
Use cases
Market-size dashboards
Feed live counts into your BI tool: one /count call per segment, with countBy set to the measure you chart (company for distinct companies), or an array of measures to get several for the same segment. GET /api/v1/lead-generation/state-default-counts adds per-state totals for a map. Counts are cached for five minutes, so a dashboard that refreshes often stays cheap. See Company Data Search and State Totals.
AI-assisted targeting
Let a rep describe the ideal customer in their own words, send it to /ai-criteria, show the filters it returns, and count them. When the audience looks right, save it in Audience Builder so the whole team and your agents can reuse it. See AI Search and Saved Criteria.
Enrich your own list
- 1
Upload the file
POST /api/v1/lead-generation/uploadswith the file name, its columns and the rows, up to 10,000 rows and 60 MB. - 2
Map the columns
POST /api/v1/lead-generation/uploads/:uploadId/mappingsays which column is the company name, domain, email and so on. - 3
Start a run
POST /api/v1/lead-generation/runswith theuploadId. Optionally check credits withPOST /api/v1/lead-generation/mcp/credits/previewfirst. - 4
Enrich it
POST /api/v1/lead-generation/runs/:runId/enrich-jobs, then check the job about once a minute until it completes. - 5
Read the results
GET /api/v1/lead-generation/runs/:runId/results?mode=enrichreturns every enriched row.
The Uploads, Runs, Enrichment and Results references have each body in full.
Lookalike prospects
After enrichment, POST /api/v1/lead-generation/runs/:runId/cross-match-counts counts how many records in each dataset match your upload, to help you pick where to look (free, 10 calls a minute), and POST /api/v1/lead-generation/runs/:runId/gtmscoop-analysis-jobs with a prospectCount from 1 to 5,000 finds new prospects that look like your list. The count is reserved from the monthly record allowance (2,500 on Starter, 10,000 on Growth) and settled to what the analysis delivers. Read them with results?mode=ai, or file them as a saved list. See AI Analysis.
CRM sync
Connect Salesforce or HubSpot once in the web app, then pull up to 5,000 contacts at a time into an upload with POST /api/v1/:provider/enrich-sync (20 syncs an hour) and enrich them like any list. Send enriched records or prospects back out with POST /api/v1/:provider/push to any of 11 tools: Salesforce, HubSpot, Zoho CRM, Apollo, Instantly, Clay, Notion, Slack, Microsoft Teams, ClickHouse, Snowflake. See CRM Connect and Send to Tools.
Agents and copilots
Give Claude, ChatGPT, Claude Code or Cursor live audience counts, enrichment and your unlocked lists through the MCP server. The agent runs the same operations these docs describe, under your plan's limits.
Partner integrations
Companies that embed audience search in their own product get a partner key from the GTM Scoop team, sent in x-api-key on the audience search routes. See API keys and authentication or book a call to talk about a partnership.