> ## 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 Indeed job scrape status
> Poll the status and results of an Indeed 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. Searches that fetch full descriptions take a little longer than listing-only ones.
## Example responses
```json theme={null}
{
"request_id": "run_indeed_abc123",
"status": "RUNNING",
"result": null,
"started_at": "2026-06-29T07:30:00.000Z",
"finished_at": null
}
```
```json theme={null}
{
"request_id": "run_indeed_abc123",
"status": "COMPLETED",
"result": {
"company": "Indeed",
"url": "https://www.indeed.com/jobs?q=Software+Engineer&l=Remote&filter=0",
"search_urls": [
"https://www.indeed.com/jobs?q=Software+Engineer&l=Remote&filter=0"
],
"total_found": 250,
"jobs_returned": 25,
"pages_scraped": 3,
"jobs": [
{
"job_title": "Software Engineer",
"company_name": "Acme",
"location": "Remote",
"city": "Austin",
"remote_policy": "remote",
"job_type": "Full-time",
"salary_min": 100000,
"salary_max": 130000,
"salary_currency": "USD",
"salary_period": "year",
"job_description": "Build and ship things ...",
"job_url": "https://www.indeed.com/viewjob?jk=abc123",
"company_rating": 4.2,
"posted_at": "2026-06-26"
}
],
"limit": 25,
"offset": 0,
"has_more": true
},
"started_at": "2026-06-29T07:30:00.000Z",
"finished_at": "2026-06-29T07:33:00.000Z"
}
```
```json theme={null}
{
"request_id": "run_indeed_jkl012",
"status": "FAILED",
"result": null,
"started_at": "2026-06-29T07:30:00.000Z",
"finished_at": "2026-06-29T07:30:09.000Z"
}
```
## OpenAPI
````yaml openapi.json GET /v1/scrape-indeed-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-indeed-jobs/async/{request_id}:
get:
tags:
- scrape-indeed-jobs
summary: Get Scrape Indeed Jobs Status
operationId: >-
get_scrape_indeed_jobs_status_v1_scrape_indeed_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/IndeedJobsStatusResponse'
example:
request_id: run_indeed_abc123
status: COMPLETED
result:
company: Indeed
url: >-
https://www.indeed.com/jobs?q=Software+Engineer&l=Remote&filter=0
search_urls:
- >-
https://www.indeed.com/jobs?q=Software+Engineer&l=Remote&filter=0
total_found: 250
jobs_returned: 25
pages_scraped: 3
jobs:
- job_title: Software Engineer
company_name: Acme
location: Remote
city: Austin
remote_policy: remote
job_type: Full-time
salary_min: 100000
salary_max: 130000
salary_currency: USD
salary_period: year
job_description: Build and ship things ...
job_url: https://www.indeed.com/viewjob?jk=abc123
company_rating: 4.2
posted_at: '2026-06-26'
limit: 25
offset: 0
has_more: true
started_at: '2026-06-29T07:30:00.000Z'
finished_at: '2026-06-29T07:33:00.000Z'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
components:
schemas:
IndeedJobsStatusResponse:
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/IndeedResult'
- 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: IndeedJobsStatusResponse
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
IndeedResult:
properties:
company:
anyOf:
- type: string
- type: 'null'
title: Company
url:
anyOf:
- type: string
- type: 'null'
title: Url
search_urls:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Search Urls
total_found:
anyOf:
- type: integer
- type: 'null'
title: Total Found
jobs_returned:
anyOf:
- type: integer
- type: 'null'
title: Jobs Returned
pages_scraped:
anyOf:
- type: integer
- type: 'null'
title: Pages Scraped
jobs:
anyOf:
- items:
$ref: '#/components/schemas/JobPosting'
type: array
- type: 'null'
title: Jobs
warnings:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Warnings
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: IndeedResult
description: Indeed job-board scrape result shape.
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
JobPosting:
properties:
job_title:
anyOf:
- type: string
- type: 'null'
title: Job Title
location:
anyOf:
- type: string
- type: 'null'
title: Location
city:
anyOf:
- type: string
- type: 'null'
title: City
country:
anyOf:
- type: string
- type: 'null'
title: Country
job_type:
anyOf:
- type: string
- type: 'null'
title: Job Type
remote_policy:
anyOf:
- type: string
- type: 'null'
title: Remote Policy
department:
anyOf:
- type: string
- type: 'null'
title: Department
salary_min:
anyOf:
- type: number
- type: 'null'
title: Salary Min
salary_max:
anyOf:
- type: number
- type: 'null'
title: Salary Max
salary_currency:
anyOf:
- type: string
- type: 'null'
title: Salary Currency
salary_period:
anyOf:
- type: string
- type: 'null'
title: Salary Period
min_years_of_experience:
anyOf:
- type: integer
- type: 'null'
title: Min Years Of Experience
requirements:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Requirements
nice_to_have:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Nice To Have
benefits:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Benefits
job_description:
anyOf:
- type: string
- type: 'null'
title: Job Description
hiring_manager_name:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Name
hiring_manager_email:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Email
hiring_manager_phone:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Phone
job_url:
anyOf:
- type: string
- type: 'null'
title: Job Url
ats_system:
anyOf:
- type: string
- type: 'null'
title: Ats System
posted_at:
anyOf:
- type: string
- type: 'null'
title: Posted At
application_deadline:
anyOf:
- type: string
- type: 'null'
title: Application Deadline
company_name:
anyOf:
- type: string
- type: 'null'
title: Company Name
additionalProperties: true
type: object
title: JobPosting
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
````