linkedin/
company-jobs

The LinkedIn Company Jobs API discovers public LinkedIn job listings from prepared /jobs/ URLs with normalized role, company, location, employment, experience, remote, salary, and timing fields.

LinkedIn Company Jobs API

Jobs page input
Per-URL limit
Canonical job records
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

LinkedIn Company Jobs

LinkedIn company jobs are public listings with title, company, location, employment type, experience level, remote status, salary, and timing information. These fields support job tracking, role comparison, hiring research, and structured job directories.

LinkedIn Company Jobs API Features

  • Jobs page discoverySubmit one or more public LinkedIn URLs whose paths begin with /jobs/ and collect the listings surfaced for each prepared page.
  • Limit per inputSet results_limit from 1 to 2000; the LinkedIn Company Jobs API applies the selected cap independently to every URL in the request.
  • Canonical job recordsReceive stable job, company, location, salary, publication, expiry, and collection fields rather than source-specific nesting.
  • Nullable source fidelityKeep fields null when a listing does not publicly expose values such as salary, remote status, experience level, or exact location.

LinkedIn Company Jobs API Parameters

ParametersRequiredDescription
urlsRequiredRequired list of public http or https LinkedIn URLs. Each host must be linkedin.com or a LinkedIn subdomain, and each path must begin with /jobs/.
results_limitOptionalOptional integer result cap applied to each input URL. The default is 100, the minimum is 1, and the maximum is 2000.

How to Use the LinkedIn Company Jobs API

Submit prepared jobs-page URLs to the LinkedIn Company Jobs API, poll the asynchronous task, and process every returned result page.

  1. Prepare public LinkedIn URLs whose path begins with /jobs/ and retain any useful query parameters.
  2. POST urls and results_limit to /v1/linkedin/company-jobs, then save task_id.
  3. Poll /v1/tasks/{task_id} until the task reaches a terminal status.
  4. On success, process data.results.items and follow next_cursor whenever has_more is true.
curl -X POST "https://api.socq.ai/v1/linkedin/company-jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/jobs/microsoft-jobs/"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

LinkedIn Company Jobs API Use Cases

  • Selected employer monitoring: Revisit prepared company-oriented jobs URLs and compare the public listings returned at different collection times.
  • Role catalogue enrichment: Add normalized company, location, employment, experience, remote, salary, and date fields to a public job catalogue.
  • Hiring-page research: Compare returned role mixes across selected jobs pages while retaining every source URL and collection timestamp.
  • Workflow intake: Feed public listing records from the LinkedIn Company Jobs API into review, deduplication, alerting, or downstream analysis workflows.

LinkedIn Company Jobs API Pro Tips

  • Keep meaningful query parameters in prepared URLs because they may influence which listings the page exposes.
  • Deduplicate by stable job id or listing URL when overlapping jobs pages return the same opening.
  • Treat an empty result for one URL as a collection outcome, not proof that an employer has no open roles.
  • Use structured job search when you need explicit keyword or location controls instead of prepared page URLs.
  • Keep published_at, expires_at, and collected_at distinct so listing time is not confused with retrieval time.

Beyond the LinkedIn Company Jobs API, use these APIs when you need a different type of public LinkedIn data.

  • LinkedIn Profiles API — Normalize public profile identity, roles, location, visible audience counts, experience, education, and skills from profile URLs.
  • LinkedIn Companies API — Normalize public company descriptions, websites, logos, visible audience and employee counts, industries, locations, and specialties.
  • LinkedIn Posts API — Collect public post text, authors, visible engagement, media, publication time, type, and hashtags from supported URLs.
  • LinkedIn Jobs API — Normalize public job titles, companies, descriptions, locations, qualifications, employment details, application links, and available salary fields.
  • LinkedIn Company Posts API — Discover public posts from LinkedIn company-page URLs with text, author context, media, hashtags, timestamps, and visible engagement.
  • LinkedIn Search Jobs API — Search public LinkedIn jobs from a required location and optional filters, returning normalized role, company, place, employment, experience, remote, salary, and timing fields.

Explore other platforms

Combine LinkedIn data with public data from other supported social platforms.

LinkedIn Company Jobs API — FAQ

LinkedIn Company Jobs API is a programmatic interface for discovering public job listings from prepared LinkedIn /jobs/ URLs. It returns normalized role, company, location, employment, experience, remote, salary, and timing fields for the listings surfaced at collection time.

Each value must be a complete http or https URL on linkedin.com or a LinkedIn subdomain, with a path that begins with /jobs/. Ordinary /company/ profile URLs do not pass validation.

The integer limit applies separately to each URL. For example, a limit of 20 allows up to 20 returned listings per submitted jobs page.

No. An empty collection only means that no supported public listings were returned for that URL at that time.

No. The endpoint returns public listing data and does not apply to roles, contact recruiters, or expose private recruiting analytics.

Each returned job record costs 0.5 SocQ credits, with no base charge. An empty result set has no result charge, and actual usage may exceed the estimate when permitted.