{ "openapi": "3.0.1", "info": { "title": "HelloWork France Job Listings & Salary Filter Scraper", "description": "Search HelloWork.com by keyword, region, city, sector or job function, and filter by contract type, remote-work frequency, experience level, company type and disclosed salary range.", "version": "1.0", "x-build-id": "ttW7DK9FHDnNc0eEf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vexaloom-labs~hellowork-france-job-listings-and-salary-filter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vexaloom-labs-hellowork-france-job-listings-and-salary-filter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/vexaloom-labs~hellowork-france-job-listings-and-salary-filter/runs": { "post": { "operationId": "runs-sync-vexaloom-labs-hellowork-france-job-listings-and-salary-filter", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/vexaloom-labs~hellowork-france-job-listings-and-salary-filter/run-sync": { "post": { "operationId": "run-sync-vexaloom-labs-hellowork-france-job-listings-and-salary-filter", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byLocation", "bySector", "byUrls" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "One or more free-text keyword searches (mode=search). Each query runs with the same filters; duplicate jobs are removed.", "items": { "type": "string" }, "default": [] }, "region": { "title": "Region (mode=byLocation)", "enum": [ "", "Auvergne-Rhône-Alpes", "Bourgogne-Franche-Comté", "Bretagne", "Centre-Val de Loire", "Corse", "Grand Est", "Hauts-de-France", "Île-de-France", "Normandie", "Nouvelle-Aquitaine", "Occitanie", "Pays de la Loire", "Provence-Alpes-Côte d'Azur", "Guadeloupe", "Martinique", "Guyane", "La Réunion", "Mayotte" ], "type": "string", "description": "French administrative region. Required for mode=byLocation unless `city` is set; also usable as a filter on other modes.", "default": "" }, "city": { "title": "City (mode=byLocation)", "type": "string", "description": "French city or commune (e.g. `Lyon`, `Bordeaux`). Takes priority over `region`; also usable as a filter on other modes.", "default": "" }, "sectors": { "title": "Sectors", "uniqueItems": true, "type": "array", "description": "One or more industry sectors (mode=bySector, optional filter elsewhere).", "items": { "type": "string", "enum": [ "Agri_peche", "BTP", "Banq_assur_finan", "Distrib_commerce", "Energie_envir", "Enseign_forma", "Immo", "Ind_aero", "Ind_agro", "Ind_auto_meca_nav", "Ind_hightech_telecom", "Ind_manufact", "Ind_petro", "Ind_pharma_bio_chim", "Inform_SSII", "Media_internet_com", "Resto", "Sante_social", "Serv_entreprise", "Serv_pers_part", "Serv_public_autre", "Serv_public_collec_terri", "Serv_public_etat", "Serv_public_hosp", "Tourism_hotel_loisir", "Transport_logist" ], "enumTitles": [ "Agriculture / Pêche", "BTP", "Banque / Assurance / Finance", "Distribution / Commerce de gros", "Energie / Environnement", "Enseignement / Formation", "Immobilier", "Industrie Aéronautique / Aérospatial", "Industrie Agro-alimentaire", "Industrie Auto / Méca / Navale", "Industrie high-tech / Telecom", "Industrie Manufacturière", "Industrie Pétrolière / Pétrochimie", "Industrie Pharmaceutique / Biotechn. / Chimie", "Informatique / ESN", "Média / Internet / Communication", "Restauration", "Santé / Social / Association", "Services aux Entreprises", "Services aux Personnes / Particuliers", "Service public autres", "Service public des collectivités territoriales", "Service public d'état", "Service public hospitalier", "Tourisme / Hôtellerie / Loisirs", "Transport / Logistique" ] }, "default": [] }, "jobFunctions": { "title": "Job functions / métiers", "uniqueItems": true, "type": "array", "description": "One or more job functions (mode=bySector, optional filter elsewhere).", "items": { "type": "string", "enum": [ "Achat", "Assistanat_admin_accueil", "BTP_gros_second_oeuvre", "Bureau_etude_R_D", "Commercial_particulier", "Commercial_professionnel", "Commercial_technico_com", "Commercial_vendeur", "Compta_gestion_finance_audit", "Dir_management_resp", "Dir_resp_centre_profit", "Import_export_inter", "Informatique_dev", "Informatique_dev_hard", "Informatique_syst_info", "Informatique_syst_reseaux", "Ingenierie_agro_agri", "Ingenierie_chimie_pharma_bio", "Ingenierie_electro_tech", "Ingenierie_meca_aero", "Ingenierie_telecom", "Juridique_droit", "Logistique_metiers_transport", "Marketing_com_graphisme", "Metiers_fonction_publique", "Negociation_gest_immo", "Production_gestion", "Production_operateur", "Qualite_securite_environnement", "RH_Personnel_Formation", "Restauration_hotellerie_tourisme", "SAV_Hotline", "Sante_social", "Services_pers_entreprises" ], "enumTitles": [ "Achat", "Assistanat / Adm. ventes / Accueil", "BTP / Gros Oeuvre / Second Oeuvre", "Bureau d'Etudes / R&D / BTP archi", "Commercial auprès des particuliers", "Commercial auprès des professionnels", "Commercial / Technico-commercial", "Commercial / Vendeur en magasin", "Compta / Gestion / Finance / Audit", "Métiers de la distribution / Management", "Direction / Resp. Co. et Centre de Profit", "Import / Export / International", "Informatique / Développement", "Informatique / Dével. Hardware", "Informatique / Systèmes d'Information", "Informatique / Systèmes / Réseaux", "Ingénierie / Agro / Agri", "Ingénierie / Chimie / Pharmacie / Bio.", "Ingénierie / Electro-tech. / Automat.", "Ingénierie / Mécanique / Aéron.", "Ingénierie / Telecoms / Electronique", "Juridique / Droit", "Logistique / Métiers du Transport", "Marketing / Communication / Graphisme", "Métiers de la Fonction Publique", "Négociation / Gestion immobilière", "Production / Gestion / Maintenance", "Production / Opérateur / Manoeuvre", "Qualité / Hygiène / Sécurité / Environnement", "RH / Personnel / Formation", "Restauration / Tourisme / Hôtellerie / Loisirs", "SAV / Hotline / Téléconseiller", "Santé / Social", "Services à la personne / aux entreprises" ] }, "default": [] }, "contractTypes": { "title": "Contract type", "uniqueItems": true, "type": "array", "description": "Filter by one or more contract types (optional, all modes).", "items": { "type": "string", "enum": [ "CDI", "CDD", "Travail_temp", "Stage", "Alternance", "Independant", "Franchise", "Associe", "Fonctionnaire", "Freelance", "Stage_de_lycee" ], "enumTitles": [ "CDI (permanent contract)", "CDD (fixed-term contract)", "Intérim (temp work)", "Stage (internship)", "Alternance (apprenticeship)", "Indépendant (self-employed)", "Franchise", "Associé (partner)", "Fonctionnaire (civil servant)", "Freelance", "Stage de lycée (high-school internship)" ] }, "default": [] }, "remoteWork": { "title": "Remote work (télétravail)", "uniqueItems": true, "type": "array", "description": "Filter by disclosed remote-work (télétravail) frequency (optional, all modes).", "items": { "type": "string", "enum": [ "Complet", "Partiel", "Occasionnel", "Pas_teletravail" ], "enumTitles": [ "Télétravail complet (fully remote)", "Télétravail partiel (hybrid remote)", "Télétravail occasionnel (occasional remote)", "Pas de télétravail (no remote work)" ] }, "default": [] }, "employmentType": { "title": "Employment time (temps de travail)", "uniqueItems": true, "type": "array", "description": "Filter by employment schedule -- full-time vs part-time (optional, all modes).", "items": { "type": "string", "enum": [ "ft", "pt", "np" ], "enumTitles": [ "Temps plein (full-time)", "Temps partiel (part-time)", "Non précisé (unspecified)" ] }, "default": [] }, "experienceLevels": { "title": "Experience level required", "uniqueItems": true, "type": "array", "description": "Filter by the years of experience the employer asks for (optional, all modes).", "items": { "type": "string", "enum": [ "deb", "0-1y", "2-3y", "4-5y", "6-10y", "gt10y", "unknown" ], "enumTitles": [ "Débutants acceptés (débutant / no experience required)", "0-1 year (débutants accepted)", "2-3 years", "4-5 years", "6-10 years", "10+ years", "Not specified" ] }, "default": [] }, "companyTypes": { "title": "Company type", "uniqueItems": true, "type": "array", "description": "Filter by the type of hiring organization (optional, all modes).", "items": { "type": "string", "enum": [ "Entreprises", "Cabinet_recr", "SSII", "Travail_temporaire", "Centre_formation" ], "enumTitles": [ "Direct employer", "Recruitment agency", "IT services company (ESN)", "Temp staffing agency", "Training center" ] }, "default": [] }, "csrLabels": { "title": "CSR / sustainability label", "uniqueItems": true, "type": "array", "description": "Filter to employers holding a specific CSR (corporate social responsibility) certification (optional, all modes).", "items": { "type": "string", "enum": [ "_10556393", "_b64a8fe7", "_9ffe5c83", "_3a9a1663", "_a2f6a46f", "_2d67f571", "_79347e6b", "_e7ce5995", "_7b05b6d4", "d5bab309073b" ], "enumTitles": [ "B Corp", "Ecocert 26000", "EcoVadis", "Engagé RSE", "For Life", "Lucie 26000", "PME+", "Positive Company", "Responsible Care", "Safe Place" ] }, "default": [] }, "minSalary": { "title": "Minimum annual salary (EUR)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include jobs whose disclosed salary meets this yearly gross EUR floor (optional, all modes). Matches HelloWork's own \"Salaire minimum\" slider (0-100,000, steps of 1,000).", "default": 0 }, "radiusKm": { "title": "Search radius in km (mode=byLocation with city)", "enum": [ "0", "5", "10", "20", "50" ], "type": "string", "description": "Widen or narrow the search radius around `city` (ignored when only `region` is set -- HelloWork's radius filter only applies to a specific city/commune).", "default": "20" }, "postedWithin": { "title": "Posted within", "enum": [ "all", "h", "d", "w", "m" ], "type": "string", "description": "Only include jobs posted within this time window (optional, all modes).", "default": "all" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Result ordering.", "default": "relevance" }, "salaryOnly": { "title": "Only offers with disclosed salary", "type": "boolean", "description": "Only include job listings that disclose a salary range (optional, all modes).", "default": false }, "superRecruiterOnly": { "title": "Only \"super recruiter\" offers", "type": "boolean", "description": "Only include job listings from HelloWork-verified \"super recruiter\" companies (optional, all modes).", "default": false }, "exactMatchesOnly": { "title": "Only exact keyword matches", "type": "boolean", "description": "Drop HelloWork similar-result cards (\"LO-Moteur-Approchant\"). Useful for narrow technical queries.", "default": false }, "includeDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Open each job page for description, skills, structured salary, exact dates and location. Adds one request per job.", "default": true }, "includeCompanyProfile": { "title": "Include company profile", "type": "boolean", "description": "Add headquarters, founding year, employee range, revenue and telework policy when the employer page exposes them. Requires includeDetails. Adds one request per unique company.", "default": false }, "incrementalMode": { "title": "Incremental runs (only new or changed jobs)", "type": "boolean", "description": "Keep state per `stateKey` and emit only new, updated or reappeared jobs. Unchanged jobs are updated in state and skipped.", "default": false }, "stateKey": { "title": "Incremental state key", "type": "string", "description": "Required when `incrementalMode` is on. Reuse the same key across scheduled runs.", "default": "" }, "startUrls": { "title": "Start URLs (mode=byUrls)", "type": "array", "description": "HelloWork search-result URLs and/or job detail URLs. Mixed lists are allowed; duplicates are removed. Enter one URL per row in the Console (the request-list editor wraps it as `{\"url\": \"...\"}`); via the API, send `{\"url\": \"...\"}` objects.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "HelloWork search-result or job detail URL." } }, "required": [ "url" ] }, "default": [] }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on emitted job listings (1–10,000).", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }