> ## 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.
# Scrape Indeed jobs
> Search Indeed and extract structured job listings with full descriptions and salaries
Searches [Indeed](https://www.indeed.com/) by job title(s) and location(s) and returns structured job listings — title, company, location, salary, job type, and the full job description.
Pass one or more `titles_query` values and one or more `locations` (one search is run per location). Select the market with `country`, which picks the matching regional Indeed site.
The pipeline runs asynchronously. Use the returned `request_id` to [poll for results](/api-reference/endpoint/get-indeed-jobs-status).
**Timing guidance:** Most searches finish within a minute. Fetching each job's full description (`include_job_details`, on by default) adds time per job. Poll every 15–30 seconds.
## How it works
1. Builds the Indeed search from `titles_query`, `locations`, and `country`, plus optional `job_types`, `max_age_days` (recency), and `radius`
2. Pages through the search results up to `rows`, de-duplicating by job
3. When `include_job_details` is true (default), fetches each job's page for the full description and precise salary
4. When `include_company_details` is true (off by default), also fetches the company page for size / website when available
5. Returns structured job listings (company, search URLs, totals, and the jobs array)
Provide at least one `titles_query` and at least one `location`. `radius` only applies when a location is set.
## Response
The request is accepted immediately and returns a `request_id` — no jobs are returned here. Poll [Get Indeed job scrape status](/api-reference/endpoint/get-indeed-jobs-status) with that id to retrieve the results.
```json theme={null}
{
"request_id": "run_indeed_abc123",
"status": "QUEUED"
}
```
## OpenAPI
````yaml openapi.json POST /v1/scrape-indeed-jobs/async
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:
post:
tags:
- scrape-indeed-jobs
summary: Scrape Indeed Jobs
operationId: scrape_indeed_jobs_v1_scrape_indeed_jobs_async_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IndeedJobsRequest'
example:
titles_query: Software Engineer
locations:
- Remote
country: United States
rows: 25
job_types:
- full-time
max_age_days: 7
required: true
responses:
'202':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/IndeedJobsResponse'
example:
request_id: run_indeed_abc123
status: QUEUED
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
components:
schemas:
IndeedJobsRequest:
properties:
titles_query:
anyOf:
- type: string
- items:
type: string
type: array
title: Titles Query
description: >-
Job title(s) to search. A single string, or an array joined into one
`(A) OR (B)` keyword search.
locations:
items:
type: string
type: array
title: Locations
description: >-
Cities, regions, or countries to search; one search is run per
location.
country:
type: string
enum:
- Afghanistan
- Albania
- Algeria
- American Samoa
- Andorra
- Angola
- Anguilla
- Antarctica
- Antigua and Barbuda
- Argentina
- Armenia
- Aruba
- Australia
- Austria
- Azerbaijan
- Bahamas
- Bahrain
- Bangladesh
- Barbados
- Belarus
- Belgium
- Belize
- Benin
- Bermuda
- Bhutan
- Bolivia
- Bonaire, Sint Eustatius and Saba
- Bosnia and Herzegovina
- Botswana
- Bouvet Island
- Brazil
- British Indian Ocean Territory
- Brunei Darussalam
- Bulgaria
- Burkina Faso
- Burundi
- Cabo Verde
- Cambodia
- Cameroon
- Canada
- Cayman Islands
- Central African Republic
- Chad
- Chile
- China
- Christmas Island
- Cocos (Keeling) Islands
- Colombia
- Comoros
- Congo
- Congo, The Democratic Republic of the
- Cook Islands
- Costa Rica
- Croatia
- Cuba
- Curaçao
- Cyprus
- Czechia
- Côte d'Ivoire
- Denmark
- Djibouti
- Dominica
- Dominican Republic
- Ecuador
- Egypt
- El Salvador
- Equatorial Guinea
- Eritrea
- Estonia
- Eswatini
- Ethiopia
- Falkland Islands (Malvinas)
- Faroe Islands
- Fiji
- Finland
- France
- French Guiana
- French Polynesia
- French Southern Territories
- Gabon
- Gambia
- Georgia
- Germany
- Ghana
- Gibraltar
- Greece
- Greenland
- Grenada
- Guadeloupe
- Guam
- Guatemala
- Guernsey
- Guinea
- Guinea-Bissau
- Guyana
- Haiti
- Heard Island and McDonald Islands
- Holy See (Vatican City State)
- Honduras
- Hong Kong
- Hungary
- Iceland
- India
- Indonesia
- Iran
- Iraq
- Ireland
- Isle of Man
- Israel
- Italy
- Jamaica
- Japan
- Jersey
- Jordan
- Kazakhstan
- Kenya
- Kiribati
- Kuwait
- Kyrgyzstan
- Laos
- Latvia
- Lebanon
- Lesotho
- Liberia
- Libya
- Liechtenstein
- Lithuania
- Luxembourg
- Macao
- Madagascar
- Malawi
- Malaysia
- Maldives
- Mali
- Malta
- Marshall Islands
- Martinique
- Mauritania
- Mauritius
- Mayotte
- Mexico
- Micronesia, Federated States of
- Moldova
- Monaco
- Mongolia
- Montenegro
- Montserrat
- Morocco
- Mozambique
- Myanmar
- Namibia
- Nauru
- Nepal
- Netherlands
- New Caledonia
- New Zealand
- Nicaragua
- Niger
- Nigeria
- Niue
- Norfolk Island
- North Korea
- North Macedonia
- Northern Mariana Islands
- Norway
- Oman
- Pakistan
- Palau
- Palestine, State of
- Panama
- Papua New Guinea
- Paraguay
- Peru
- Philippines
- Pitcairn
- Poland
- Portugal
- Puerto Rico
- Qatar
- Romania
- Russian Federation
- Rwanda
- Réunion
- Saint Barthélemy
- Saint Helena, Ascension and Tristan da Cunha
- Saint Kitts and Nevis
- Saint Lucia
- Saint Martin (French part)
- Saint Pierre and Miquelon
- Saint Vincent and the Grenadines
- Samoa
- San Marino
- Sao Tome and Principe
- Saudi Arabia
- Senegal
- Serbia
- Seychelles
- Sierra Leone
- Singapore
- Sint Maarten (Dutch part)
- Slovakia
- Slovenia
- Solomon Islands
- Somalia
- South Africa
- South Georgia and the South Sandwich Islands
- South Korea
- South Sudan
- Spain
- Sri Lanka
- Sudan
- Suriname
- Svalbard and Jan Mayen
- Sweden
- Switzerland
- Syria
- Taiwan
- Tajikistan
- Tanzania
- Thailand
- Timor-Leste
- Togo
- Tokelau
- Tonga
- Trinidad and Tobago
- Tunisia
- Turkmenistan
- Turks and Caicos Islands
- Tuvalu
- Türkiye
- Uganda
- Ukraine
- United Arab Emirates
- United Kingdom
- United States
- United States Minor Outlying Islands
- Uruguay
- Uzbekistan
- Vanuatu
- Venezuela
- Vietnam
- Virgin Islands, British
- Virgin Islands, U.S.
- Wallis and Futuna
- Western Sahara
- Yemen
- Zambia
- Zimbabwe
- Åland Islands
title: Country
description: >-
Selects Indeed's regional host (e.g. United Kingdom ->
uk.indeed.com). Countries without a dedicated host use
www.indeed.com.
default: United States
rows:
type: integer
maximum: 100
minimum: 1
title: Rows
description: >-
Maximum number of jobs to return (1-100). Page through them on the
status endpoint with limit/offset.
default: 25
radius:
anyOf:
- type: integer
minimum: 0
- type: 'null'
title: Radius
description: Search radius (miles) around each location.
job_types:
anyOf:
- items:
type: string
enum:
- full-time
- part-time
- contract
- temporary
- internship
type: array
- type: 'null'
title: Job Types
description: Filter by employment type (the first is applied as Indeed's `jt`).
max_age_days:
anyOf:
- type: integer
minimum: 1
- type: 'null'
title: Max Age Days
description: Only return jobs posted within the last N days (Indeed `fromage`).
include_job_details:
type: boolean
title: Include Job Details
description: >-
Fetch each job's detail page for the full description/salary
(slower; one fetch per job).
default: true
include_company_details:
type: boolean
title: Include Company Details
description: >-
Also fetch each company's page for size/website when available
(slower and less reliable; company rating/review count are returned
without it).
default: false
type: object
required:
- titles_query
title: IndeedJobsRequest
IndeedJobsResponse:
properties:
request_id:
type: string
title: Request Id
status:
type: string
title: Status
default: QUEUED
type: object
required:
- request_id
title: IndeedJobsResponse
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
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
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
````