> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automindz.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Get LinkedIn job scrape status
> Poll the status and results of a LinkedIn job search
Poll until `status` is `COMPLETED` or `FAILED`. The `result` field is populated on completion.
Page through the returned jobs with the `limit` (1–50, default 25) and `offset` query params; the response echoes `limit`, `offset`, and `has_more`.
**Polling guidance:** Check every 15–30 seconds. Most searches complete within 1–4 minutes; enabling per-job detail fetches on large `rows` takes longer.
## Example responses
```json theme={null}
{
"request_id": "run_abc123xyz",
"status": "RUNNING",
"result": null,
"started_at": "2026-05-15T10:00:00Z",
"finished_at": null
}
```
```json theme={null}
{
"request_id": "run_abc123xyz",
"status": "COMPLETED",
"result": {
"titles_query": "Account Executive",
"locations": ["United States"],
"country": "United States",
"search_urls": [
"https://www.linkedin.com/jobs-guest/jobs/api/seeMoreJobPostings/search?keywords=Account%20Executive&location=United%20States"
],
"total_found": 50,
"jobs_scraped": 48,
"successful_scrapes": 46,
"failed_scrapes": 2,
"jobs": [
{
"title": "Account Executive",
"company_name": "Acme Corp",
"company_url": "https://www.linkedin.com/company/acme",
"location": "New York, NY",
"job_url": "https://www.linkedin.com/jobs/view/3901234567",
"linkedin_job_id": "3901234567",
"description": "We are hiring an Account Executive to...",
"posted_at": "2026-05-10",
"posted_time_ago": "5 days ago",
"applications_count": "47 applicants",
"apply_url": "https://acme.com/careers/ae",
"apply_type": "external",
"salary": "$90,000 - $120,000",
"seniority_level": "Mid-Senior level",
"employment_type": "Full-time",
"job_function": "Sales",
"industries": "Software Development",
"company_size": "201-500 employees",
"company_website": "https://acme.com",
"headquarters": "New York, NY"
}
]
},
"started_at": "2026-05-15T10:00:00Z",
"finished_at": "2026-05-15T10:02:31Z"
}
```
```json theme={null}
{
"request_id": "run_def456uvw",
"status": "COMPLETED",
"result": {
"titles_query": "Account Executive",
"locations": ["Antarctica"],
"country": "Antarctica",
"search_urls": [
"https://www.linkedin.com/jobs-guest/jobs/api/seeMoreJobPostings/search?keywords=Account%20Executive&location=Antarctica"
],
"total_found": 0,
"jobs_scraped": 0,
"successful_scrapes": 0,
"failed_scrapes": 0,
"jobs": []
},
"started_at": "2026-05-15T10:00:00Z",
"finished_at": "2026-05-15T10:00:48Z"
}
```
```json theme={null}
{
"request_id": "run_jkl012mno",
"status": "FAILED",
"result": null,
"started_at": "2026-05-15T10:00:00Z",
"finished_at": "2026-05-15T10:00:09Z"
}
```
## OpenAPI
````yaml openapi.json GET /v1/scrape-linkedin-jobs/async/{request_id}
openapi: 3.1.0
info:
title: Automindz API
version: 0.1.0
servers:
- url: https://api.automindz.co
description: Production
security: []
paths:
/v1/scrape-linkedin-jobs/async/{request_id}:
get:
tags:
- scrape-linkedin-jobs
summary: Get Scrape Linkedin Jobs Status
operationId: >-
get_scrape_linkedin_jobs_status_v1_scrape_linkedin_jobs_async__request_id__get
parameters:
- name: request_id
in: path
required: true
schema:
type: string
description: The `run_...` id returned by the scrape endpoint.
title: Request Id
description: The `run_...` id returned by the scrape endpoint.
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
description: Max jobs to return (pagination page size).
default: 25
title: Limit
description: Max jobs to return (pagination page size).
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
description: Number of jobs to skip (pagination offset).
default: 0
title: Offset
description: Number of jobs to skip (pagination offset).
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/LinkedInJobsStatusResponse'
example:
request_id: run_linkedin_abc123
status: COMPLETED
result:
titles_query:
- Account Executive
- Sales Manager
locations:
- United States
country: United States
search_url: >-
https://www.linkedin.com/jobs/search/?keywords=Account+Executive+OR+Sales+Manager&location=United+States&f_TPR=r86400&f_JT=F&f_WT=2%2C3&f_E=3%2C4
search_urls:
- >-
https://www.linkedin.com/jobs/search/?keywords=Account+Executive+OR+Sales+Manager&location=United+States&f_TPR=r86400&f_JT=F&f_WT=2%2C3&f_E=3%2C4
total_found: 3
jobs_scraped: 1
successful_scrapes: 1
failed_scrapes: 0
jobs:
- title: Account Executive
job_url: https://www.linkedin.com/jobs/view/1234567890
linkedin_job_id: '1234567890'
company_name: Example Co
company_url: https://www.linkedin.com/company/example-co
company_id: example-co
location: New York, NY
description: Own new business pipeline and close customer accounts.
seniority_level: Associate
employment_type: Full-time
industries: Software Development
apply_url: https://example.com/jobs/account-executive
apply_type: external
started_at: '2026-05-22T12:30:00.000Z'
finished_at: '2026-05-22T12:31:00.000Z'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
components:
schemas:
LinkedInJobsStatusResponse:
properties:
request_id:
type: string
title: Request Id
status:
type: string
title: Status
description: 'Run lifecycle: `QUEUED`, `RUNNING`, `COMPLETED`, or `FAILED`.'
result:
anyOf:
- $ref: '#/components/schemas/LinkedInJobsResult'
- type: 'null'
description: Populated only when `status` is `COMPLETED`; null otherwise.
started_at:
anyOf:
- type: string
- type: 'null'
title: Started At
finished_at:
anyOf:
- type: string
- type: 'null'
title: Finished At
type: object
required:
- request_id
- status
title: LinkedInJobsStatusResponse
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
LinkedInJobsResult:
properties:
titles_query:
anyOf:
- type: string
- items:
type: string
type: array
- type: 'null'
title: Titles Query
company_url:
anyOf:
- type: string
- type: 'null'
title: Company Url
locations:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Locations
country:
anyOf:
- type: string
- type: 'null'
title: Country
search_url:
anyOf:
- type: string
- type: 'null'
title: Search Url
search_urls:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Search Urls
total_found:
type: integer
title: Total Found
default: 0
jobs_scraped:
type: integer
title: Jobs Scraped
default: 0
successful_scrapes:
type: integer
title: Successful Scrapes
default: 0
failed_scrapes:
type: integer
title: Failed Scrapes
default: 0
jobs:
items:
$ref: '#/components/schemas/LinkedInJob'
type: array
title: Jobs
errors:
anyOf:
- {}
- type: 'null'
title: Errors
message:
anyOf:
- type: string
- type: 'null'
title: Message
limit:
anyOf:
- type: integer
- type: 'null'
title: Limit
offset:
anyOf:
- type: integer
- type: 'null'
title: Offset
has_more:
anyOf:
- type: boolean
- type: 'null'
title: Has More
additionalProperties: true
type: object
title: LinkedInJobsResult
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
LinkedInJob:
properties:
title:
anyOf:
- type: string
- type: 'null'
title: Title
job_url:
anyOf:
- type: string
- type: 'null'
title: Job Url
linkedin_job_id:
anyOf:
- type: string
- type: 'null'
title: Linkedin Job Id
company_url:
anyOf:
- type: string
- type: 'null'
title: Company Url
company_name:
anyOf:
- type: string
- type: 'null'
title: Company Name
company_id:
anyOf:
- type: string
- type: 'null'
title: Company Id
location:
anyOf:
- type: string
- type: 'null'
title: Location
description:
anyOf:
- type: string
- type: 'null'
title: Description
criteria:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Criteria
posted_at:
anyOf:
- type: string
- type: 'null'
title: Posted At
posted_time_ago:
anyOf:
- type: string
- type: 'null'
title: Posted Time Ago
applications_count:
anyOf:
- type: string
- type: 'null'
title: Applications Count
apply_url:
anyOf:
- type: string
- type: 'null'
title: Apply Url
apply_type:
anyOf:
- type: string
- type: 'null'
title: Apply Type
poster_name:
anyOf:
- type: string
- type: 'null'
title: Poster Name
poster_profile_url:
anyOf:
- type: string
- type: 'null'
title: Poster Profile Url
poster_headline:
anyOf:
- type: string
- type: 'null'
title: Poster Headline
salary:
anyOf:
- type: string
- type: 'null'
title: Salary
seniority_level:
anyOf:
- type: string
- type: 'null'
title: Seniority Level
employment_type:
anyOf:
- type: string
- type: 'null'
title: Employment Type
job_function:
anyOf:
- type: string
- type: 'null'
title: Job Function
industries:
anyOf:
- type: string
- type: 'null'
title: Industries
sector:
anyOf:
- type: string
- type: 'null'
title: Sector
company_size:
anyOf:
- type: string
- type: 'null'
title: Company Size
company_website:
anyOf:
- type: string
- type: 'null'
title: Company Website
headquarters:
anyOf:
- type: string
- type: 'null'
title: Headquarters
specialties:
anyOf:
- type: string
- type: 'null'
title: Specialties
additionalProperties: true
type: object
title: LinkedInJob
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
````