Recruiter: Search

Search from a pasted Recruiter URL

Search using a pasted Recruiter search, talent-pool, or applicant URL; nothing else in the body. The response is a recruiter_people_search_result, recruiter_job_applicant_list, or recruiter_pipeline_candidate_list, depending on the kind of URL pasted. Requires a Recruiter seat.

post/v1/{account_id}/recruiter/search

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/recruiter/search
  • Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) whose Recruiter seat performs the search.

Query parameters

cursorstring

Opaque pagination cursor from a previous response. Omit for the first page.

limitinteger

Number of results to return (1-5000; the effective cap depends on the URL kind). Defaults to 25.

Request body

urlstring required

A pasted Recruiter search, talent-pool, or applicant URL. Content, forwarded verbatim, never persisted.

Response

One of three branches, determined by the pasted URL's own kind: recruiter_people_search_result (people/search URL), recruiter_job_applicant_list (applicant/pipeline-channel URL), or recruiter_pipeline_candidate_list (talent-pool/pipeline-view URL, added 2026-07-09; SDK cross-check). Requires a Recruiter seat.

OR
OR

Changes

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