Search

Search jobs

Searches LinkedIn job postings using structured filters. To search from a pasted LinkedIn jobs URL instead, use POST .../search. Job description text is never returned.

post/v1/{account_id}/search/jobs

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/search/jobs
  • 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-100, default 25).

cursorstring

Opaque pagination cursor returned from a previous response.

Request body

keywordsstring

Full-text keyword search in job postings.

sort_by'relevance' | 'date'

Sort order: relevance (default) or date (newest first).

date_postedinteger

Filter to jobs posted within N days (positive integer). Snapped UP to the nearest supported window: 1 = past day, 2-7 = past week, 8+ = past month (clamped, no window beyond 30 days is available).

regionstring

Opaque region ID.

locationstring[]

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

location_within_areanumber

Search radius around the location, in kilometers. Snapped to the nearest supported bucket: 0, 8, 16, 40, 80, or 160 km (ties round up).

industrystring[]

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

senioritystring[]

Filter by seniority levels.

functionstring[]

Job function slugs (lowercase letters only, e.g. 'engineering').

rolestring[]

Opaque role IDs.

job_typestring[]

Filter by employment type.

companystring[]

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

presencestring[]

Filter by work arrangement.

easy_applyboolean

Filter to jobs with LinkedIn Easy Apply enabled.

under_10_applicantsboolean

Filter to jobs with fewer than 10 applicants.

in_your_networkboolean

Filter to jobs at companies in your network.

benefitsstring[]

Filter by offered benefits. Valid values: medical_insurance, vision_insurance, dental_insurance, 401(k), pension_plan, commuter_benefits.

commitmentsstring[]

Filter by company commitments. Valid values: career_growth_and_learning, diversity_equity_and_inclusion, environmental_sustainability, social_impact, work_life_balance.

has_verificationsboolean

Filter to jobs with LinkedIn verification badges.

fair_chance_employerboolean

Filter to fair-chance employers.

Response

A page of job postings matching the filters. Job description text is never returned.

object'job_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.