Search

Agentic Search

Describe the people to find in plain language: the prompt is read into People Search filters, then the matching full profiles are returned as a People Search page. The filters applied and anything the prompt asked for that no filter covers are returned at data.interpretation. Pass metadata.nextCursor back as cursor with the same prompt for the next page: a prompt keeps the filters it was read into for 24 hours, so every page runs on the same filters. A cursor sent with filters other than the ones that produced it returns 400 and costs 0 credits. Send filters only through the prompt; to set them explicitly, use /v2/search/people. A prompt no filter can be read from returns 422 NO_FILTERS_INTERPRETED and costs 0 credits. Credits: 1 per page for the search itself, even when no profile matches, plus 1 per profile delivered. A prompt refused before the search costs 0.

post/v2/search/people/prompt

Request

  • Base URL
    https://api.reversecontact.com
  • Auth
    HTTP bearer

Request body

promptstring required

Plain-language description of the people to find, in any language: at least 3 characters and at most 1000 tokens (about 4000 characters of English text)

cursorstring

Opaque cursor returned in metadata.nextCursor. Send it with the same prompt: it only works with the filters that produced it.

perPageinteger

Results per page (1-100, default 25)

Example request

{
  "prompt": "VP Sales in Paris at software companies with 50 to 200 employees",
  "perPage": 25
}

Response

People search results with the interpreted filters

successtrue required
errorunknown required

Changes

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