{ "openapi": "3.0.1", "info": { "title": "HelloWork Jobs Scraper", "description": "Scrape live job listings from HelloWork.com, one of France's largest job boards. Search by keyword, browse by region/city or by sector, and filter by contract type, work time, salary, and posted date.", "version": "1.0", "x-build-id": "f5yWPXvKxF2CSLfxM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~hellowork-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-hellowork-jobs-scraper", "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/crawlerbros~hellowork-jobs-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-hellowork-jobs-scraper", "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/crawlerbros~hellowork-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-hellowork-jobs-scraper", "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" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text keyword search (job title, skill, company, etc.) (mode=search). Can be combined with the filters below.", "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 to browse jobs in. Required for mode=byLocation unless `city` is set; optional filter on other modes.", "default": "" }, "city": { "title": "City (mode=byLocation)", "type": "string", "description": "French city or commune name to browse jobs in (e.g. `Lyon`, `Bordeaux`). Takes priority over `region` when both are set. Required for mode=byLocation unless `region` is set; optional filter on other modes.", "default": "" }, "sector": { "title": "Sector (mode=bySector)", "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" ], "type": "string", "description": "Industry sector to browse jobs in. Required for mode=bySector unless `jobFunction` is set; optional filter on other modes.", "default": "" }, "jobFunction": { "title": "Job function / métier (mode=bySector)", "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" ], "type": "string", "description": "Job function (métier) to browse jobs in. Alternative/complement to `sector` for mode=bySector; optional filter on other modes.", "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": [ "0-1y", "2-3y", "4-5y", "6-10y", "gt10y", "unknown" ], "enumTitles": [ "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 }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of job listings to emit.", "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 } } }, "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 } } } } } } } } } }