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.
POST /api/v1/autoleads/lookalikeParameters
| Name | Type | Required | Description |
|---|---|---|---|
domains | array | Required | Your 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"] |
id | string | Optional | GET only: the job id POST returned. The job has status (running, done, failed), percent, and when done, groups.Example: 3f2c9a1e-... |
format | string | Optional | GET 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.