{ "openapi": "3.0.1", "info": { "title": "Recruiter Finder - Talent Acquisition Contacts by Company", "description": "Find recruiters: give company domains (staffing agencies too) or countries, get one row per recruiter or talent acquisition person: name, title, company, location, profile URL, email flags. Free plan: 100 domains per run. Pay per recruiter delivered, empty lookups free. No login or cookies.", "version": "0.1", "x-build-id": "X4Nkvwy3DYvm144P1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2bdata~recruiter-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2bdata-recruiter-finder", "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/b2bdata~recruiter-finder/runs": { "post": { "operationId": "runs-sync-b2bdata-recruiter-finder", "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/b2bdata~recruiter-finder/run-sync": { "post": { "operationId": "run-sync-b2bdata-recruiter-finder", "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": { "items": { "title": "Which companies? (domains, website URLs or emails)", "type": "array", "description": "Company domains to find recruiters at; staffing and recruiting agencies work the same way. Example: [\"shopify.com\", \"https://www.stripe.com/jobs\", \"jane@airbnb.com\"]. A website URL or an email address is reduced to its domain; a company name is not a domain and is listed in the MISSES record as invalid_domain. Each domain is looked up once. A domain with no recruiters on file returns one free notice row. Leave empty only when you give countries. Free plan: 100 domains per run.", "items": { "type": "string" } }, "titles": { "title": "Which job titles count as recruiter? (optional)", "type": "array", "description": "Title words, 3 to 64 characters, up to 10; a person is kept when a current job title contains one of them, in any letter case. Example: [\"recruiter\", \"talent acquisition\", \"sourcer\", \"head of talent\"]. Leave empty for the default set: recruiter, talent acquisition, sourcer. A short word such as \"hr\" is refused. Broad words also match unrelated titles, for example \"talent\" matches \"talent show host\".", "items": { "type": "string" } }, "countries": { "title": "Countries (optional)", "type": "array", "description": "Two-letter country codes of where the person is based, up to 5. Example: [\"us\", \"gb\"]. With domains, only recruiters based there are kept. With no domains, this runs one search by title words and country, capped by limit. People with no country on file never match a country filter.", "items": { "type": "string" } }, "maxPeoplePerDomain": { "title": "Max recruiters per domain", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Most recruiters delivered for any one domain, so a large employer cannot use up your run. Default 100, maximum 1000. A person with several profiles or positions counts once.", "default": 100 }, "limit": { "title": "Max recruiters in total", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Most recruiters delivered in the whole run, which also caps what is charged. Domains not reached are listed in MISSES and are not charged. Default 100, maximum 10000.", "default": 100 }, "includeAudit": { "title": "Include audit fields", "type": "boolean", "description": "Adds requestId, latencyMs and inputRaw to each row under audit. Omit for clean rows.", "default": false } } }, "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 } } } } } } } } } }