ScraperCity logo

AutoLeads Lookalike Groups API API Documentation

AutoLeads Lookalike Groups API

Send your customers' websites or work emails. We read each site and return as many lookalike groups as your list supports: businesses like your customers, each with ready-to-run Lead, Local Business or E-commerce Database filters, a match count and the best tool to reach them. Runs in the background: POST starts a job, GET returns its progress and the groups. $0.01 per site we can read, from your credits when the job finishes; sites we can't read are free. Your balance must cover $0.01 x every site before it starts. One upload at a time. Works on every plan, trials included.

$0.01 per site read, on every planPOST /api/v1/autoleads/lookalike

Parameters

NameTypeRequiredDescription
domainsarrayRequiredYour customers' websites, URLs or work emails (mike@acme.com reads acme.com and looks up Mike's job title). Personal emails (gmail.com, ...) are skipped. At least 3 company sites; no upper limit beyond your balance.Example: ["acme.com", "mike@globex.com", "https://initech.com"]
idstringOptionalGET only: the job id POST returned. The job has status (running, done, failed), percent, and when done, groups.Example: 3f2c9a1e-...
formatstringOptionalGET only: csv returns the finished job as a CSV, one row per site: whether it was read, what it sells and to whom, industry, keywords, size, country, the contacts from your upload with their titles, and its group.Example: csv

Examples

Start a job

curl -X POST "https://app.scrapercity.com/api/v1/autoleads/lookalike" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["acme.com", "mike@globex.com", "initech.com"]}'

Check it and get the groups

curl "https://app.scrapercity.com/api/v1/autoleads/lookalike?id=JOB_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
# Each group has name, description, sites (your customers in it), database, filters, count and tool.
# Send its filters to that database's API to pull the leads.

Download every site as a CSV

curl "https://app.scrapercity.com/api/v1/autoleads/lookalike?id=JOB_ID&format=csv" \
  -H "Authorization: Bearer YOUR_API_KEY" -o lookalike.csv

Use Cases

  • •Find more businesses like your best customers
  • •See which kinds of customers you have, grouped by what they sell and who buys
  • •Get ready-to-run database searches for each group

Best Practices

  • •More customers give more groups; a group needs at least 3 of your sites
  • •A 402 answer gives required and available: add credits and send it again
  • •A 409 answer means an upload is already running; its job_id is in the answer
  • •Poll every 10 to 30 seconds; a 600-site list takes a few minutes

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.