Import rows
Sendrows to Create leads to import many leads into a list in one call.
id. A small import finishes inside the request. A larger one runs in the background: follow it with List or get jobs, passing the import’s id, until status is done, failed or cancelled, and read rows_imported, rows_skipped and rows_failed for the counts.
idempotency_key when you retry so a retry never imports twice.
Find new prospects
Prospecting is a preview then import flow.- Run a search.
POST /api/v1/public/searchesreturns a preview and adds nothing to your leads. - Read the results.
GET /api/v1/public/searches/{search_id}?lead_list_id=...returns the same preview again. - Import the ones you want.
POST /api/v1/public/leadswith thesearch_idand the keys you chose.
Run a search
Describe who you want in plain words, or send filters yourself.type picks the kind of search:
The response holds the preview
id (use it as search_id), the results, a cursor for the next page and total_matches. Each person has a prospect_key; each place has an id.
Import the results
place_ids instead of prospect_keys. lookup_email and lookup_phone find contact details and cost credits, and only when something is found. Searching and importing follow your plan’s monthly prospect allowance; an empty balance answers 402.