Start a Live Data search
Starts a Live Data search that finds contacts matching the filters and adds them as prospects (optionally moving them into a sequence and/or lists). Consumes credits from the Reply credit pool per resulting contact. Returns the created search’s id; track its progress via GET /v3/live-data/searches/{id}.
Authorizations
Authenticate every request with a Bearer token. Pass your Reply API key in the
Authorization header:
Authorization: Bearer <your-api-key>Get your API key from the Reply dashboard: Settings → API Key.
Body
Configuration for a Live Data search that adds found contacts as prospects.
Account- and contact-level filter configuration for a Live Data search.
Most collections are capped at 25 items. accountKeywords and contactKeywords are always present and non-null in responses even when empty ({ "values": [], "type": "or" }).
Number of contacts to find and add
x >= 1When true, contacts without an email address are still added
Maximum contacts to add per company. Optional; defaults to 1 when omitted.
x >= 1Sequence to move the found contacts into
Prospect lists to add the found contacts to
Optional reference URL used to seed the search
When true, enrich phone numbers during the search
Response
Search started
Id of the created search; poll GET /v3/live-data/searches/{id}.