HelloWork API

Search HelloWork job offers in France and pull salaries, contracts, skills and descriptions as JSON.

The API.SH HelloWork API turns public job offers on hellowork.com, one of France's major job boards, into structured JSON. Search by keyword and location with the site's filters for contract, date posted, experience, remote work, full or part time, employer type, function, sector, radius and minimum salary, 30 jobs a page. Then open an offer for its salary or HelloWork's estimate, sector, job family, skills, full description, profile sought, benefits, recruitment steps and where to apply.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

HelloWork job search

GET https://api.api.sh/hellowork/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the HelloWork API

French job market and salary research

Search a job title across regions with with_salary set and collect salary ranges by contract and location.

/search

Job board aggregation

Pull fresh offers posted in the last 24 hours for your sectors and show them in your own job board or newsletter.

/search /job

Skills demand analysis

Open offers in a job family to collect required skills and the profile sought, and track which skills employers ask for.

/job

Recruitment lead generation

List companies hiring for a function in a department to find employers with open roles for staffing or HR software sales.

/search

Remote work tracking

Filter by remote and working time to measure how many French offers allow télétravail in each sector.

/search

HelloWork data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

HelloWork API endpoints and prices

Every HelloWork endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

HelloWork job search

/hellowork/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

HelloWork job details

/hellowork/v1/job

$1 · $2 PAYG

1 credit

Call the HelloWork API

HelloWork job search: GET https://api.api.sh/hellowork/v1/search

curl "https://api.api.sh/hellowork/v1/search?q=d%C3%A9veloppeur" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/hellowork/v1/search",
    params={"q": "développeur"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/hellowork/v1/search");
url.searchParams.set("q", "développeur");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/hellowork/v1/search", "q", "développeur")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "HelloWork" and "HelloWork job search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for HelloWork data

Public data only: no HelloWork login, cookies or account needed
One key and one response shape for HelloWork and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official HelloWork API

HelloWork has an official ATS Partner API that lets applicant tracking systems receive applications and sync their status, using partner credentials. It does not provide open job search data. API.SH returns public HelloWork job offers as JSON with no partner account.

Instead of building your own HelloWork scraper alongside ones for Indeed France, APEC or Meteojob, call one API.SH key and get one JSON shape at a fixed price per call.

HelloWork API questions

What HelloWork data can I get?+

Job search with contract, date, experience, remote, working time, employer type, function, sector, radius and salary filters (/hellowork/v1/search), and one offer with salary, skills, description, profile sought, benefits and recruitment steps (/hellowork/v1/job).

How much does the HelloWork API cost?+

Every HelloWork endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /hellowork/v1/job at 1 credit each.

Is there an official HelloWork API?+

Yes, the HelloWork ATS Partner API, which lets recruiters' ATS software receive and track applications. It is for partners and does not offer job search data. API.SH covers public job offers.

Do I need a HelloWork account or login?+

No. API.SH reads public HelloWork pages only. No endpoint uses a login, cookies or anyone's account.

Is there a free HelloWork API?+

API.SH is a paid API, but every account gets 1,000 free credits every month to test HelloWork searches and offers. That is 1,000 calls to /hellowork/v1/job at 1 credit each.

Is this the Japanese Hello Work?+

No. This is hellowork.com, the French job board. Hello Work in Japan is a public employment service and is not covered here.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /hellowork/v1/search with q set to développeur and location set to Lyon. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.