{
  "openapi": "3.0.1",
  "info": {
    "title": "HelloWork Jobs Scraper: French Jobs, Salary and France Travail",
    "description": "Scrape HelloWork job offers by keyword and place, plus France Travail (Pole emploi) as a second source: one row per job with company, city, contract, salary min and max, telework, posted date, full description, skills and ROME code. No login, no API key.",
    "version": "0.1",
    "x-build-id": "swUu8FNPwKdHvH71n"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~hellowork-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~hellowork-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-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/themineworks~hellowork-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-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",
        "properties": {
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Job titles or keywords, one per line, as you would type them in the HelloWork search box. Example: comptable, développeur, infirmier, chef de projet. Each keyword is one search on each source you pick. Up to 100 searches per run.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Place",
            "type": "string",
            "description": "City, postal code, departement or region in France, for example Paris, Lyon, 33000, 69, Gironde or Bretagne. Leave empty for all of France. Used by every keyword search."
          },
          "sources": {
            "title": "Job sites",
            "type": "array",
            "description": "Which sites to search. HelloWork is the default. Add France Travail (formerly Pole emploi, the public employment service, which also lists offers from partner sites) to search it with the same keywords, place and filters. Same price per job on both.",
            "items": {
              "type": "string",
              "enum": [
                "hellowork",
                "francetravail"
              ],
              "enumTitles": [
                "HelloWork",
                "France Travail"
              ]
            },
            "default": [
              "hellowork"
            ]
          },
          "maxItems": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "The most jobs to return for each keyword on each site, or for each search link, 1 to 5,000. HelloWork shows 30 jobs a page; France Travail shows 20 and serves at most 1,000 for one search. Example: 200.",
            "default": 50
          },
          "includeDetails": {
            "title": "Open each job (description, skills, education)",
            "type": "boolean",
            "description": "On: each job's own page is read too, for the full description, skills, education, experience, salary range, valid through date, sector, postal code and, on France Travail, the ROME job code, working hours, languages and licences. Off: rows come from the search results only (title, company, place, contract, salary text, telework, posted date), which is faster. Same price either way.",
            "default": true
          },
          "contractTypes": {
            "title": "Contract types",
            "type": "array",
            "description": "Only jobs with these contracts. Empty means all. Stage is HelloWork only; seasonal is France Travail only.",
            "items": {
              "type": "string",
              "enum": [
                "cdi",
                "cdd",
                "interim",
                "alternance",
                "stage",
                "freelance",
                "independant",
                "seasonal"
              ],
              "enumTitles": [
                "CDI (permanent)",
                "CDD (fixed term)",
                "Interim (temporary)",
                "Alternance (work and study)",
                "Stage (internship)",
                "Freelance",
                "Independant",
                "Seasonal"
              ]
            }
          },
          "postedWithin": {
            "title": "Posted within",
            "enum": [
              "any",
              "24h",
              "3d",
              "7d",
              "30d"
            ],
            "type": "string",
            "description": "Only jobs published in this window.",
            "default": "any"
          },
          "telework": {
            "title": "Telework (HelloWork only)",
            "type": "array",
            "description": "Only HelloWork jobs with this remote work mode. Empty means all.",
            "items": {
              "type": "string",
              "enum": [
                "full",
                "partial",
                "occasional",
                "none"
              ],
              "enumTitles": [
                "Full remote",
                "Partial",
                "Occasional",
                "On site only"
              ]
            }
          },
          "minSalary": {
            "title": "Minimum annual salary in euros (HelloWork only)",
            "minimum": 0,
            "type": "integer",
            "description": "HelloWork applies this filter on its side, for example 40000. Leave empty for no minimum."
          },
          "radiusKm": {
            "title": "Radius around the city (km)",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "How far around a city to search, 0 to 100 km. Leave empty for the sites' own default (HelloWork 20 km, France Travail 10 km)."
          },
          "sortBy": {
            "title": "Sort",
            "enum": [
              "relevance",
              "date"
            ],
            "type": "string",
            "description": "Most relevant first, or newest first.",
            "default": "relevance"
          },
          "startUrls": {
            "title": "Search links (optional)",
            "type": "array",
            "description": "HelloWork or France Travail search result links copied from your browser, with any filters you set there, for example https://www.hellowork.com/fr-fr/emploi/recherche.html?k=comptable&l=Bordeaux&c=CDI or https://candidat.francetravail.fr/offres/recherche?motsCles=comptable&lieux=33D. The pages after the first are read automatically.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}