Skip to content
Examples

Update Settings

Configure LinkedIn Jobs Scraper settings

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POSThttps://api.lobstr.io/v1/squids/{squid_hash}

Configure your LinkedIn Jobs Scraper squid settings.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Must be application/json. Value: application/json

Squid Parameters

Parameter Type Default Description
date_posted string Any time Only return jobs posted within this time window. Applied on top of your URL, unless the URL already carries a date filter. One of: Any time, Past month, Past week, Past 24 hours.
job_type string Any Filter by employment type. Applied on top of your URL. NB: LinkedIn's new AI search treats this as search intent (like typing it in the search box), so close matches may occasionally appear. One of: Any, Full-time, Part-time, Contract, Temporary, Internship, Volunteer, Other.
experience_level string Any Filter by required experience level. Applied on top of your URL. NB: LinkedIn's new AI search treats this as search intent (like typing it in the search box), so close matches may occasionally appear. One of: Any, Internship, Entry level, Associate, Mid-Senior level, Director, Executive.
workplace_type string Any Filter by workplace arrangement. Applied on top of your URL. NB: LinkedIn's new AI search treats this as search intent (like typing it in the search box), so close matches may occasionally appear. One of: Any, On-site, Remote, Hybrid.
easy_apply boolean false Only return jobs that can be applied to directly on LinkedIn. Applied on top of your URL, unless the URL already carries this filter.
under_10_applicants boolean false Only return jobs with fewer than 10 applicants. Applied on top of your URL, unless the URL already carries this filter.
distance string Any distance Maximum search radius around the location in the URL. Applied unless the URL already carries a distance. One of: Any distance, 5 miles, 10 miles, 25 miles, 50 miles, 100 miles.
sort_by string Relevance How results are ordered. Most recent sorts by listing time. Applied unless the URL already carries a sort. One of: Relevance, Most recent.
exclude_job_titles string — Comma-separated words. Jobs whose title contains any of them are skipped before collection, so they never consume credits (e.g. senior, manager, director).
exclude_companies string — Comma-separated company names. Jobs posted by these companies are skipped before collection, so they never consume credits (e.g. Randstad, Adecco).
max_results int 1000 Max number of jobs to scrape per search. NB: LinkedIn displays up to 1,000 jobs per search URL, no more. To collect more, split your search by location or keyword.
max_unique_results_per_run int — Maximum number of unique results retrieved across all tasks in the entire run. Leave empty for unlimited.
fetch_since fetch_since — Only collect jobs posted after this threshold (based on posted_at) — applied directly in the LinkedIn search, so filtered-out jobs cost nothing. Use a relative duration (24h, 7d, 2w) or an absolute date (YYYY-MM-DD HH:MM:SS). NB: LinkedIn exposes posting dates with daily granularity.
fetch_since_timezone string — Timezone for interpreting an absolute fetch_since date (e.g. Europe/Paris). Ignored for relative values.
job_details boolean false Paid add-on. Visit each job posting page to collect the full description, structured salary, seniority, industries, recruiter and apply link. When off, you get the fields shown in the search results only. Free when the task input is a single job URL, since that posting page is already scraped in full. Costs 1 extra credit per job.
company_details boolean false Paid add-on. Visit each hiring company's LinkedIn page to collect website, industry, headcount, followers, founding year, headquarters and specialties. Costs 1 extra credit per job.

Code Examples

curl -X POST https://api.lobstr.io/v1/squids/YOUR_SQUID_HASH \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date_posted": "Past week",
    "job_type": "Full-time",
    "experience_level": "Mid-Senior level",
    "workplace_type": "Remote",
    "max_results": 500,
    "job_details": true
  }'

Response

201
{"params": {"date_posted": "Past week", "job_type": "Full-time", "experience_level": "Mid-Senior level", "workplace_type": "Remote", "max_results": 500, "job_details": true}}