{
"openapi": "3.0.1",
"info": {
"title": "Companies Hiring Now 🏢 (checked in the company register)",
"description": "Find the companies hiring for a role in a city, or check your own account list, and get one row per employer: open postings, the registered legal entity (SIREN, UK company number, HRB), still trading or in insolvency, a recruitment-agency flag and a scored match. France, UK, Germany. No API key.",
"version": "0.1",
"x-build-id": "BSEgKjkKWRsdCgzWS"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~verified-hiring-employers/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-verified-hiring-employers",
"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/tagadanar~verified-hiring-employers/runs": {
"post": {
"operationId": "runs-sync-tagadanar-verified-hiring-employers",
"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/tagadanar~verified-hiring-employers/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-verified-hiring-employers",
"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": {
"keywords": {
"title": "Job search terms (find who is hiring)",
"type": "array",
"description": "What the people they are hiring do, exactly as you would type it into a jobs search box: sales manager, data engineer, infirmier. Every term is run against every location below, and the employers behind the postings are what you get back. Leave this empty if you already have a company list and want to use the \"Companies to check\" field instead.",
"items": {
"type": "string"
}
},
"location": {
"title": "Locations",
"type": "array",
"description": "City, region or country to search in: Paris, London, Berlin, France. The company registers covered are French, British and German, so a search inside those three countries is what produces verified rows. Employers found elsewhere are still returned, marked as not covered, and are not billed.",
"items": {
"type": "string"
}
},
"employers": {
"title": "Companies to check (instead of a search)",
"type": "array",
"description": "Use this when you already have target accounts. One entry per company: a name (Doctolib), a website (monzo.com), or a careers board URL (https://jobs.lever.co/spotify). Each one is checked for open postings on its own careers board first, then on LinkedIn, then against its national company register. Rows piped in from another actor's dataset work too.",
"items": {
"type": "string"
}
},
"postedSince": {
"title": "Only postings from",
"enum": [
"any",
"24h",
"week",
"month"
],
"type": "string",
"description": "How fresh a posting has to be to count as a hiring signal. Shorter windows give a smaller, hotter list.",
"default": "month"
},
"maxEmployers": {
"title": "Max employers",
"minimum": 1,
"maximum": 2000,
"type": "integer",
"description": "Stop after this many distinct employers. You are billed per employer the register answered on, so this is your budget.",
"default": 50
},
"country": {
"title": "Register to use when the postings do not say",
"enum": [
"",
"FR",
"GB",
"DE"
],
"type": "string",
"description": "Most postings name their country, and that always wins. This is the fallback for the ones that do not (a remote-only posting, for instance).",
"default": ""
},
"checkInsolvency": {
"title": "Check insolvency notices",
"type": "boolean",
"description": "Also look each matched company up in BODACC (France), The Gazette (UK) or Insolvenzbekanntmachungen (Germany). A company can be hiring and in a collective procedure at the same time, which is exactly what you want to know before signing one. Slower, and free.",
"default": true
},
"minMatchScore": {
"title": "Minimum name-match score",
"minimum": 70,
"maximum": 100,
"type": "integer",
"description": "How close a registered legal name has to be to the employer name on the posting before we call it a match, from 70 (loose) to 100 (exact only). Raise it if you would rather have gaps than wrong companies.",
"default": 82
},
"companiesHouseApiKey": {
"title": "Companies House API key (optional, UK only)",
"type": "string",
"description": "UK employers are checked against the free public Companies House search by default, no key needed. Supply your own free key from developer.company-information.service.gov.uk to get SIC codes and richer status data instead."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}