find-leads

Run a table's search again

Re-run the persisted search into the same table. Existing rows are matched on the provider's identifier and update in place; only genuinely new matches add rows. A search saved under filters this API no longer accepts answers 422 against query: open it, fix the filters, and save it again.

post/find-leads/tables/{table_id}/search/run/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/find-leads/tables/{table_id}/search/run/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

table_idstring uuid required

Query parameters

max_new_rowsinteger nullable

The most rows this run may add, and so charge for, however many new matches it finds. Leave it out to add every new match within the search's row limit.

Response

Successful Response

import_status'running' | 'success' | 'failed'

Where one run of a table's search stands.

running while rows are still being added, then success or failed.

people_skippedinteger

People the request left out because another of the workspace's tables already has them. A run that continues in the background goes on skipping them.

provider_noticesstring[]

What the data source said about the rows the request added, in the words to show beside them; see the create response. A run that continues in the background can add more, and the table's search runs carry every one.

rows_createdinteger required

Rows the request itself added.

rows_wantedinteger

Rows the import set out to add in all.

run_idstring uuid nullable

The run row recording this import, when the search is persisted.

skip_limit_reachedboolean

Whether the search stopped looking after skipping as many people as one search may, so fewer rows may be added than asked for.

total_matchedinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.