Recruiter: Search

Search for people on the Recruiter surface.

Search LinkedIn members using Recruiter filters. The POST body carries the (all-optional) people-search filter set. Pagination is driven by the limit (1-100) and cursor query params. Requires a Recruiter seat.

post/v1/{account_id}/recruiter/search/people

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/recruiter/search/people
  • 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-100). Defaults to 25.

Request body

keywordsstring

Free-text keyword search. Trimmed before use; never persisted.

spotlightsstring[]

Filter by candidate spotlight tags.

load_saved_searchstring

Load filters from a saved search id.

load_custom_filterstring

Load filters from a saved custom-filter id.

save_searchstring

Persist this search under a name on the LinkedIn side.

save_custom_filterstring

Persist this filter set under a name on the LinkedIn side.

network_distancestring[]

Filter by network distance.

locationstring[]

Resolved LOCATION parameter ids.

postal_codestring

A postal code to search around.

postal_code_radiusnumber

Radius (in the substrate's own unit) around postal_code.

job_titlestring[]

Resolved JOB_TITLE parameter ids.

occupationstring[]

Resolved OCCUPATION parameter ids.

skillsstring[]

Resolved SKILL parameter ids.

companystring[]

Resolved COMPANY parameter ids.

current_companystring[]

Resolved CURRENT_COMPANY parameter ids.

past_companystring[]

Resolved company parameter ids for past employers.

company_sizestring[]

Filter by company size bucket.

degreestring[]

Resolved DEGREE parameter ids.

workplace_typestring[]

Filter by workplace type (e.g. ON_SITE, REMOTE, HYBRID).

schoolstring[]

Resolved SCHOOL parameter ids.

field_of_studystring[]

Resolved FIELD_OF_STUDY parameter ids.

employment_typestring[]

Filter by employment type.

graduation_yearinteger[]

Filter by one or more graduation years.

industrystring[]

Resolved INDUSTRY parameter ids.

senioritystring[]

Filter by seniority level.

spoken_languagestring[]

Resolved SPOKEN_LANGUAGE parameter ids.

profile_languagestring[]

Filter by the profile's display language.

projectstring

Resolved PROJECT parameter id.

job_functionstring[]

Resolved JOB_FUNCTION parameter ids.

first_namestring

Filter by first name (trimmed before use; never persisted).

last_namestring

Filter by last name (trimmed before use; never persisted).

recently_joinedboolean

Filter to members who recently joined LinkedIn.

is_military_veteranboolean

Filter to members who self-identify as military veterans.

hide_previously_viewedboolean

Exclude profiles already viewed.

groupstring[]

Resolved GROUP parameter ids.

is_past_applicantboolean

Filter to members who previously applied.

notesstring

Filter by an existing note's content (trimmed before use; never persisted).

tagsstring[]

Resolved TAG parameter ids.

Response

Recruiter people search results, matching any supplied filters. Requires a Recruiter seat.

object'recruiter_people_search_result' required

Response type discriminator.

cursorstring

Opaque cursor for the next page. Absent when there are no more results.

total_countnumber

Total number of matching results, when the platform returns it.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

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