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.
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 selected cap applies 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.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required 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_limit | Optional | Optional integer result cap applied to each input URL. The default is 100, the minimum is 1, and the maximum is 2000. |
How to Use
Submit prepared jobs-page URLs, poll the asynchronous task, and process every returned result page.
- Prepare public LinkedIn URLs whose path begins with /jobs/ and retain any useful query parameters.
- POST urls and results_limit to /v1/linkedin/company-jobs, then save task_id.
- Poll /v1/tasks/{task_id} until the task reaches a terminal status.
- 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 trueBest 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 discovered public listing records into review, deduplication, alerting, or downstream analysis workflows.
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.
Related APIs
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 Post Comments API — Collect public comments exposed with a known LinkedIn post, including text, author context, timestamps, relationship IDs, and visible likes and reply counts.
- LinkedIn Profile Posts API — Discover public posts associated with LinkedIn profile URLs, with 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.
- LinkedIn Search People API — Discover candidate public profiles from LinkedIn people-search URLs, returning normalized identity, description, images, location, website, account signals, and available metrics.
- LinkedIn Search Posts API — Discover Google-indexed public LinkedIn posts by keyword and optional date string, returning normalized content, authors, media, tags, timestamps, and visible engagement.