How to use ScraperCity

The core pattern: start, poll, download

Every scraper follows the same three steps. Send your API key as a Bearer token on all requests.

POST /api/v1/scrape/{tool}        -> { runId }
GET  /api/v1/scrape/status/{runId} -> { status, handled, outputUrl }
GET  /api/downloads/{runId}        -> CSV file

Status moves from RUNNING to SUCCEEDED, FAILED, or CANCELLED. Most tools return within minutes. See the full reference in the API docs.

Build lists that do not miss people

1. Define the audience: company, role, location, and how many you want.
2. Search broadly, then narrow. A wide search plus a filter beats a narrow search that drops matches.
3. Check result counts before you export, so cost stays predictable.
4. Validate emails before you send, whatever the source.
5. For named accounts, pull everyone at the domain and let the agent pick by title.

Error codes