Search

Search people

Searches LinkedIn profiles using structured filters. To search from a pasted LinkedIn search URL instead, use POST .../search. limit/cursor/offset live in query params; filters in the request body.

post/v1/{account_id}/search/people

Request

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

Path parameters

account_idstring required

The linked LinkedIn account to search on behalf of.

Query parameters

offsetinteger

Zero-based pagination offset (default 0).

limitinteger

Maximum results per page (1-50, default 10).

cursorstring

Opaque pagination cursor returned from a previous response.

Request body

keywordsstring

Full-text keyword search across all profile fields.

industrystring[]

Opaque industry IDs from GET .../search/parameters?type=INDUSTRY.

locationstring[]

Opaque location IDs from GET .../search/parameters?type=LOCATION.

current_companystring[]

Opaque current company IDs from GET .../search/parameters?type=COMPANY.

past_companystring[]

Opaque past company IDs from GET .../search/parameters?type=COMPANY.

schoolstring[]

Opaque school IDs from GET .../search/parameters?type=SCHOOL.

servicestring[]

Opaque service IDs from GET .../search/parameters?type=SERVICE.

connections_ofstring[]

Filter to connections of the given members. Array of opaque member IDs from GET .../search/parameters?type=RELATION.

followers_ofstring[]

Filter to followers of the given members. Array of opaque member IDs from GET .../search/parameters?type=PEOPLE.

network_distancenumber[]

Filter by network distance: 1 = 1st degree, 2 = 2nd degree, 3 = 3rd degree.

profile_languagestring[]

Filter by profile language codes.

open_to_volunteeringboolean

Filter to profiles open to volunteering opportunities.

Response

A page of people matching the filters. Each item carries the LinkedIn id, name, headline, location, and connection distance when available, plus a visibility field that says whether the result names someone you can act on. LinkedIn does not disclose every profile to every viewer: which ones it discloses depends on the connected LinkedIn account's own subscription level, so a page can contain results that carry no identity and cannot be read back. Those come back with visibility hidden, and notices[] summarises the page.

object'people_search_result' required

Response type discriminator.

cursorstring nullable required

Opaque next-page cursor; null on the last page.

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.