# HelloWork Job Listings Scraper

> HelloWork Job Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured job listing data from HelloWork.fr based on keyword, location, or a pre-filtered search URL

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/hellowork?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hellowork-job-listings-scraper-efa1ebfb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B2ujJi-2pz7GqRAqGULXV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hellowork-job-listings-scraper-efa1ebfb -d '<json body>'
```

Example prompt: Search HelloWork for data engineer jobs in Lyon, collect up to 60 results across up to 15 pages, and include full details like salary, required skills, and job description for each posting.

## When to prefer this

Use this endpoint when you need structured job listing data specifically from HelloWork.fr, particularly for French-language or France-based job markets. Prefer this over generic scrapers when you need HelloWork-specific fields (job ID, company logo, salary ranges) or want to leverage HelloWork's existing search filters via a pre-filtered startUrl. Best suited for recruitment analytics, job board aggregation, or market research focused on France.

## Known failure modes

- Empty results if keyword or location returns no HelloWork matches — not charged
- HelloWork blocking or rate-limiting the scraper may return fewer results than requested
- Invalid startUrl format may cause the scrape to fail or return unexpected results
- Very high max_pages or results_wanted values may significantly increase latency
- Network timeout if HelloWork is temporarily unavailable

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of job listing items, each containing fields such as job URL, job ID, title, company name, location, company URL, company logo, list page URL, and optionally (when collectDetails is true) pay range, required skills, full description, and posting dates. Also includes a product identifier ('hellowork').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keyword": {
   "type": "string",
   "default": "developpeur",
   "description": "Role, skill or phrase to search for."
  },
  "location": {
   "type": "string",
   "default": "Paris",
   "description": "City, region or country to search within."
  },
  "startUrl": {
   "type": "string",
   "description": "Optional HelloWork search results URL with filters applied. Overrides keyword and location."
  },
  "max_pages": {
   "type": "integer",
   "default": 20,
   "minimum": 1,
   "description": "Maximum number of result pages to scan. Each page normally shows 30 jobs."
  },
  "collectDetails": {
   "type": "boolean",
   "default": true,
   "description": "Visit each offer page for dates, pay ranges, skills and full description. Turn off for faster list records."
  },
  "results_wanted": {
   "type": "integer",
   "default": 50,
   "minimum": 1,
   "description": "Stop after this many unique job records across all search pages."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "jobId": null,
    "title": null,
    "company": null,
    "location": null,
    "companyUrl": null,
    "companyLogo": null,
    "listPageUrl": null
   }
  ],
  "product": "hellowork"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hellowork-job-listings-scraper-efa1ebfb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)