Search

Agentic Organization Search

Describe the organizations to find in plain language: the prompt is read into Organization Search filters, then the matching full organization profiles are returned as an Organization 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. Send filters only through the prompt; to set them explicitly, use /v2/search/organizations. 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 organization matches, plus 1 per organization delivered. A prompt refused before the search costs 0.

post/v2/search/organizations/prompt

Request

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

Request body

promptstring required

Plain-language description of the organizations 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": "Software companies in Berlin with 200 to 500 employees, founded after 2015",
  "perPage": 25
}

Response

Organization search results with the interpreted filters

successtrue required
errorunknown required

Changes

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