> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenrows.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Zenrows HTTP API serves Fetch and Extract (extract=auto) at https://api.zenrows.com/v1/, Crawl at https://api.zenrows.com/v1/crawls, and Batch at https://async.api.zenrows.com/v1. Fetch, Extract, Crawl and Batch are described in OpenAPI 3.1 at https://www.zenrows.com/openapi.json and listed in the RFC 9727 API catalog at https://www.zenrows.com/.well-known/api-catalog. Every endpoint also has its own page under /api-reference with its schema. Use the spec for exact parameter names and types. Crawl's endpoints, parameters and errors are also at https://docs.zenrows.com/crawl/endpoints.md. To call Zenrows from an agent, connect the MCP server at https://mcp.zenrows.com/mcp. To search these docs from an agent, connect the docs MCP server at https://docs.zenrows.com/mcp. Agent skills for Zenrows are published at https://github.com/ZenRows/cli and install with `npx skills add ZenRows/cli`.

# Jobs: search, careers pages and postings

> Get job listings from Indeed and company careers pages as structured data with Zenrows, and pull every job's details at scale.

Job data powers labor-market research, recruiting tools and salary benchmarks. This page covers three jobs: searching a job board, listing every opening a company publishes, and getting each posting's details in bulk. All of it uses public job pages.

**Uses:** [Fetch](https://docs.zenrows.com/fetch/api-reference.md) with [Adaptive Stealth Mode](https://docs.zenrows.com/fetch/features/adaptive-stealth-mode.md) (`mode=auto`), [Extract](https://docs.zenrows.com/extract/introduction.md) (`extract=auto`), [Crawl](https://docs.zenrows.com/crawl/introduction.md), [Batch](https://docs.zenrows.com/batch/introduction.md), [`css_extractor`](https://docs.zenrows.com/fetch/features/css-extractor)

## Ask your AI agent

With the [Zenrows MCP server](https://docs.zenrows.com/mcp/overview.md) connected to Claude, Cursor or any MCP client, paste this prompt. Your agent picks the right Zenrows tools and settings on its own.

```text theme={"theme":"css-variables"}
Use Zenrows to get every job on https://www.indeed.com/jobs?q=data+engineer&l=Austin%2C+TX
as a visitor from the US. Give me a table of title, company, location and pay, sorted by highest pay.
```

## Search Indeed for jobs

Send an Indeed search URL with `extract=auto`. `parsed.job_listings` holds one entry per job card, with its title, company, location, pay and job key. `extract_fields` keeps only the fields you read.

```python Python (Requests) theme={"theme":"css-variables"}
import requests

params = {
    "apikey": "YOUR_ZENROWS_API_KEY",
    "url": "https://www.indeed.com/jobs?q=data+engineer&l=Austin%2C+TX",
    "mode": "auto",
    "proxy_country": "us",
    "extract": "auto",
    "extract_fields": "job_listings.title,job_listings.company_name,job_listings.location,job_listings.benefits,job_listings.job_key",
}

response = requests.get("https://api.zenrows.com/v1/", params=params, timeout=180)
response.raise_for_status()
listings = response.json()["parsed"]["job_listings"]

print(len(listings), "jobs")
for job in listings[:3]:
    print(job)
```

```bash cURL theme={"theme":"css-variables"}
curl "https://api.zenrows.com/v1/?apikey=YOUR_ZENROWS_API_KEY&url=https%3A%2F%2Fwww.indeed.com%2Fjobs%3Fq%3Ddata%2Bengineer%26l%3DAustin%252C%2BTX&mode=auto&proxy_country=us&extract=auto&extract_fields=job_listings.title%2Cjob_listings.company_name%2Cjob_listings.location%2Cjob_listings.benefits%2Cjob_listings.job_key"
```

## Example output

```text theme={"theme":"css-variables"}
17 jobs
{'benefits': ['$224,000 - $279,000 a year', 'Full-time'], 'company_name': 'FluidStack', 'job_key': '188476d650f66c02', 'location': 'Austin, TX', 'title': 'Data Engineer'}
{'benefits': ['$48.08 - $61.06 an hour'], 'company_name': 'Charles Schwab', 'job_key': '0faf084eb66178a8', 'location': 'Hybrid work in Austin, TX', 'title': 'Data Engineer'}
{'benefits': ['Full-time'], 'company_name': 'Aristocrat', 'job_key': '199478155925e9d0', 'location': 'Austin, TX 78757', 'title': 'Data Engineer'}
```

Pay and job type arrive together in `benefits`, as Indeed shows them on the card. Omit `extract_fields` to also get each card's `snippet`, `detail_url` and `company_logo_url`, plus `search_context` with the query and location.

## List every opening on a company careers page

Many companies publish openings on a hosted job board. Point [Crawl](https://docs.zenrows.com/crawl/setup.md) at the board and keep only job URLs with `include_patterns`. This example collects GitLab's openings from its Greenhouse board:

```python Python (Requests) theme={"theme":"css-variables"}
import time
import requests

API = "https://api.zenrows.com/v1/crawls"
headers = {"X-API-Key": "YOUR_ZENROWS_API_KEY"}

crawl = requests.post(API, headers=headers, json={
    "url": "https://job-boards.greenhouse.io/gitlab",
    "depth": 1,
    "include_patterns": ["/gitlab/jobs/"],
    "max_items": 500,
}, timeout=60).json()
crawl_id = crawl["crawl_id"]

job_urls, cursor = [], None
while True:
    params = {"cursor": cursor} if cursor else {}
    body = requests.get(f"{API}/{crawl_id}", headers=headers, params=params, timeout=60).json()
    job_urls += [result["url"] for result in body["results"]]
    if body["next_cursor"] is None:
        break
    cursor = body["next_cursor"]
    if not body["results"]:
        time.sleep(5)

print(body["status"], body["coverage"])
print(len(job_urls), "job URLs")
print("\n".join(job_urls[:3]))
```

```text theme={"theme":"css-variables"}
completed {'pages_fetched': 1, 'pages_failed': 0, 'items_found': 50}
50 job URLs
https://job-boards.greenhouse.io/gitlab/jobs/8883003002
https://job-boards.greenhouse.io/gitlab/jobs/8565469002
https://job-boards.greenhouse.io/gitlab/jobs/8855883002
```

`depth: 1` reads the links on the board itself. The crawl fetched one page, so it cost one Fetch request. The same pattern works on any careers page: set `include_patterns` to the path its job links share.

## Get every job's details with Batch

Send the job URLs to one [Batch](https://docs.zenrows.com/batch/developer-guide-restapi.md) job and pick the fields with `css_extractor`. On Greenhouse boards, the title is the `h1` and the location is `.job__location`:

```python Python (Requests) theme={"theme":"css-variables"}
import json, time
import requests

API = "https://async.api.zenrows.com/v1"
headers = {"X-API-Key": "YOUR_ZENROWS_API_KEY"}

job_urls = [
    "https://job-boards.greenhouse.io/gitlab/jobs/8883003002",
    "https://job-boards.greenhouse.io/gitlab/jobs/8565469002",
    "https://job-boards.greenhouse.io/gitlab/jobs/8855883002",
]  # or the job_urls list from the crawl above

selectors = {"title": "h1", "location": ".job__location"}

job = requests.post(f"{API}/jobs", headers=headers, json={
    "type": "regular",
    "status": "closed",
    "zenrows_params": {"mode": "auto", "css_extractor": json.dumps(selectors)},
    "tasks": [{"url": url} for url in job_urls],
}, timeout=60).json()
job_id = job["job_id"]

while True:
    run = requests.get(f"{API}/jobs/{job_id}", headers=headers, timeout=60).json()["latest_run"]
    if run["status"] in ("completed", "failed", "stopped"):
        break
    time.sleep(10)
print(run["status"], run["stats"])

results = requests.get(f"{API}/jobs/{job_id}/results", headers=headers,
                       params={"status": "successful"}, timeout=60).json()
for row in results["results"]:
    print(requests.get(row["result_url"], timeout=60).json())
```

```text theme={"theme":"css-variables"}
completed {'total': 3, 'completed': 3, 'successful': 3, 'failed': 0, 'spend': {'credits': 3, 'cost': 0.003}}
{'location': 'Remote, United States', 'title': 'Senior Product Manager, CRM & GTM Systems'}
{'location': 'Remote, United States', 'title': 'Director, Analytics Engineering'}
{'location': 'Remote, US', 'title': 'Senior AI Engineer'}
```

Add `.job__description` to the selectors for the full posting text, or set `response_type: "markdown"` instead of `css_extractor` to feed each posting to an LLM.

## Customize it

| Change | How |
| - | - |
| Another role or city on Indeed | Change `q` and `l` in the search URL |
| The next page of Indeed results | Add `start=10`, `start=20` to the search URL |
| Jobs from another country | Use that country's Indeed site with a matching `proxy_country`, see [Proxy country](https://docs.zenrows.com/fetch/features/proxy-country.md) |
| Many searches at once | Put one search URL per task in a [Batch](https://docs.zenrows.com/academy/scrape-from-a-list-of-urls.md) job with `extract=auto` in `zenrows_params` |
| New postings every morning | Run the crawl each morning and submit the job URLs it finds as a new Batch job. A [scheduled job](https://docs.zenrows.com/academy/batch/scheduled-jobs.md) replays a fixed URL list, so it suits pages whose URLs don't change |
| Postings as markdown for an LLM | `response_type=markdown`, see [Markdown for LLMs](https://docs.zenrows.com/academy/fetch/markdown-for-llms.md) |

## Troubleshooting

* **`job_listings` is shorter than the page you see**: Indeed shows a page of cards per request. Request the next pages with `start=10`, `start=20`.
* **`REQS004` with an "Available fields" list**: the field names differ on this kind of page. Pick names from the list in the error, or omit `extract_fields`. See [REQS004](https://docs.zenrows.com/api-error-codes.md#REQS004).
* **The crawl returns no job URLs**: the pattern doesn't match the board's links. Open the board, copy one job link, and use the path segment it shares with the others.
* **A Batch task comes back empty**: that page uses different markup. Open it, adjust the selector, and submit those URLs as a new job with the new selector. A rerun keeps the job's original settings, see [Retry failed requests](https://docs.zenrows.com/academy/retry-failed-requests.md).

## Related recipes

> [card] [Crawl a website from a start URL](https://docs.zenrows.com/academy/scrape-and-crawl-from-a-seed-url.md)
>
> Discover every page behind one start URL.

> [card] [Scrape a list of URLs](https://docs.zenrows.com/academy/scrape-from-a-list-of-urls.md)
>
> Batch jobs from the API, SDKs and CLI.

> [card] [Get structured JSON from any page](https://docs.zenrows.com/academy/extract/auto-extraction.md)
>
> How extract=auto and prepared domains work.

> [card] [Detect changes on any page and get alerted](https://docs.zenrows.com/academy/pipelines/change-detection.md)
>
> Get alerted when new postings appear.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.