# HelloWork Job Listings Scraper

> HelloWork Job Listings Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured job listing data from HelloWork.fr by keyword and location, returning detailed job records including title, company, salary, and skills.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-f903ce2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PDDGlhAmMi6pDLe8rssQ6

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-f903ce2f -d '<json body>'
```

Example prompt: Search HelloWork for up to 50 full-stack developer job listings in Lyon, visiting each offer page for salary ranges and required skills, and return all the structured results.

## When to prefer this

Use this endpoint when you need structured job listing data specifically from HelloWork.fr, the major French-language job board. Prefer it over generic web scrapers when you want normalized job fields (title, company, salary, skills) without building your own parser. It is especially useful for French market job intelligence, recruiting research, or labor market analysis targeting France.

## Known failure modes

- No results found for keyword/location combination — returns empty items array, no charge
- HelloWork blocks or rate-limits the scraper — may return partial results or error
- Invalid startUrl format causes scraper to fail before collecting records
- max_pages set too low to reach results_wanted threshold — returns fewer records than requested
- Network timeout on detail page collection when collectDetails is true

## How this service works

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

## Output

A JSON object containing a count of matched jobs and an array of job records, each with fields such as URL, jobId, title, company, location, companyUrl, companyLogo, and listPageUrl. When collectDetails is enabled, additional fields like salary range, required skills, dates, and full description are included. The product field is always '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-f903ce2f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)