Resolve search filter IDs

Resolves human-readable terms (e.g. 'software development') to opaque filter IDs for structured search filters. type selects the category; keywords is required for every type. Paginate with cursor until it returns null.

get/v1/{account_id}/search/parameters

Request

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

Path parameters

account_idstring required

The linked LinkedIn account to search on behalf of.

Query parameters

Parameter type to resolve. Non-classic types (e.g. GROUPS, SALES_INDUSTRY) are rejected.

keywordsstring required

Human term to resolve to opaque filter IDs (e.g. 'software development'). Required for every type, including EMPLOYMENT_TYPE.

offsetinteger

Zero-based pagination offset; a numeric fallback for cursor (default 0).

limitinteger

Number of parameters to return (1-100, default 10).

cursorstring

Opaque pagination cursor returned from a previous response.

Response

A list of matching filter IDs for use in structured search. Each item maps a human-readable label to an opaque ID.

object'search_parameter_list' required

Response type discriminator.

cursorstring nullable required

Opaque pagination cursor for the next page, or null when this is 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.