Nyne.ai

Start async person search by company name, role, geography, and person name. Returns requestId for polling. Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later offset or cursor pages of the same search, pass parentRequestId with unchanged search parameters. Valid continuation pages still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable search.

Changed on
post/nyne/person/search

Request

Request body

querystring required

Natural language search query (max 1000 chars)

limitinteger

Max results per request (default: 10, max: 100)

offsetinteger

Starting position in results (default: 0, max: 999). For later pages of the same logical search, keep search filters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

cursorstring

Pagination token from a previous response. For continuation billing, keep search filters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

request_idstring

Nyne request ID to continue fetching from the same search. For Orthogonal continuation billing, also pass top-level parentRequestId from the first /v1/run response.

force_newboolean

Force fresh search even if cached (default: false)

typestring

Search tier: light (fastest), medium, premium (best quality). Default: premium

show_emailsboolean

Include email addresses in results (default: false)

show_phone_numbersboolean

Include phone numbers in results (default: false)

require_emailsboolean

Only return profiles with emails (default: false)

require_phone_numbersboolean

Only return profiles with phones (default: false)

require_phones_or_emailsboolean

Only return profiles with phone OR email (default: false)

insightsboolean

Include AI-generated relevance insights (default: false, not available for light)

high_freshnessboolean

Prioritize recently updated profiles (default: false, not available for light)

profile_scoringboolean

Include AI relevance scoring (default: false)

callback_urlstring

URL to receive results via webhook

custom_filtersobject

Structured filters (locations, industries, titles, etc.)

Response

Successful response

Changes