{ "openapi": "3.0.1", "info": { "title": "New Hire Finder", "description": "Find people who started a role at a company in the last few months. Give a company domain, target titles, and a lookback window. Get one flat row per new hire: name, profile URL, title, start month, prior role, move type, and source. Runs on your own Prospeo or search keys. No LinkedIn scraping.", "version": "0.1", "x-build-id": "xCI0AVibi0KG5sCEM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~new-hire-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-new-hire-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/mambalabs~new-hire-finder/runs": { "post": { "operationId": "runs-sync-mambalabs-new-hire-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/mambalabs~new-hire-finder/run-sync": { "post": { "operationId": "run-sync-mambalabs-new-hire-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": { "company_domain": { "title": "Company domain", "type": "string", "description": "One company domain, for example zapier.com. Use this or Company domains (batch); both are merged." }, "company_domains": { "title": "Company domains (batch)", "type": "array", "description": "A list of company domains. Each company gets its own summary row.", "default": [], "items": { "type": "string" } }, "company_name": { "title": "Company name", "type": "string", "description": "Optional, single company runs only. Leave empty and the name is read from the homepage." }, "target_titles": { "title": "Target titles", "type": "array", "description": "Title phrases to match, for example marketing, head of content, editor. A title matches when it contains every word of a phrase as a whole word. Also sent to Prospeo and web search as the title filter.", "items": { "type": "string" } }, "seniority": { "title": "Seniority", "type": "array", "description": "Optional. Keep only these seniority levels.", "items": { "type": "string", "enum": [ "founder", "c_level", "vp", "director", "head", "manager", "other" ], "enumTitles": [ "Founder", "C level", "Vice president", "Director", "Head of", "Manager", "Other" ] }, "default": [] }, "departments": { "title": "Departments", "type": "array", "description": "Optional. Keep only these departments.", "items": { "type": "string", "enum": [ "sales", "marketing", "engineering", "finance", "legal", "people", "operations", "product", "general" ], "enumTitles": [ "Sales", "Marketing", "Engineering", "Finance", "Legal", "People and HR", "Operations", "Product", "General management" ] }, "default": [] }, "exclude_titles": { "title": "Exclude titles", "type": "array", "description": "Optional. Drop any title that contains one of these phrases, for example intern.", "default": [], "items": { "type": "string" } }, "expand_title_synonyms": { "title": "Expand title synonyms", "type": "boolean", "description": "Also match a short synonym list (marketing also matches growth, brand, demand generation). Off by default, because every row is charged.", "default": false }, "lookback_months": { "title": "Lookback months", "type": "string", "description": "How many calendar months back to look, including this month. 1 to 24, default 6. 6 in October means May to October. Typed as text so Clay can send it.", "default": "6" }, "move_types": { "title": "Move types", "type": "array", "description": "Which moves to return and charge. new_hire is a person who came from another employer. promotion is a new role at the same employer. unknown is a hire announcement with no work history. Default new_hire only.", "items": { "type": "string", "enum": [ "new_hire", "promotion", "unknown" ], "enumTitles": [ "New hire", "Internal promotion", "Unknown (announcement only)" ] }, "default": [ "new_hire" ] }, "include_year_only": { "title": "Include year only starts", "type": "boolean", "description": "Also return people whose start is known only to the year and could fall inside the window. They are charged like any row. Off by default.", "default": false }, "people": { "title": "Your own people (optional)", "type": "array", "description": "People you already hold, with role histories. Each item: person_name, company_domain, profile_url (optional), and roles, a list of {title, company_name, start (YYYY-MM), end (YYYY-MM or null)}. The same window, title, and move rules run on them, with no provider call.", "default": [] }, "sources": { "title": "Sources", "type": "array", "description": "Routes to run. Default all. buyer_data is your people list; prospeo and web_search run only with your key; news, newsroom, and team_pages are free.", "items": { "type": "string", "enum": [ "buyer_data", "prospeo", "web_search", "news", "newsroom", "team_pages" ], "enumTitles": [ "Your own people", "Prospeo (your key)", "Web search (your key)", "Google News headlines (free)", "Company newsroom (free)", "Company team pages (free)" ] }, "default": [ "buyer_data", "prospeo", "web_search", "news", "newsroom", "team_pages" ] }, "prospeo_api_key": { "title": "Prospeo API key", "type": "string", "description": "Your own Prospeo key. Gives the work history behind start month and move type. One Prospeo credit per search page of 25 people and one per person enrichment, billed by Prospeo to you. Never stored." }, "web_search_provider": { "title": "Web search provider", "enum": [ "auto", "serper", "serpapi", "exa" ], "type": "string", "description": "Which of your search keys to use. auto takes the first key present: Serper, then SerpApi, then Exa.", "default": "auto" }, "serper_api_key": { "title": "Serper API key", "type": "string", "description": "Your own Serper.dev key for web search. One search per company by default. Search results carry no start date, so they are dated with your Prospeo key or counted as undated." }, "serpapi_api_key": { "title": "SerpApi key", "type": "string", "description": "Your own SerpApi key for web search. A different vendor from Serper." }, "exa_api_key": { "title": "Exa API key", "type": "string", "description": "Your own Exa key. Exa people search returns work histories with start months, so its results need no enrichment." }, "max_people_per_company": { "title": "Max people per company", "type": "string", "description": "Most person rows to return per company, newest starts first. 1 to 100, default 25.", "default": "25" }, "max_search_queries_per_company": { "title": "Max web searches per company", "type": "string", "description": "Web search queries per company on your key. 1 to 4, default 1.", "default": "1" }, "max_enrich_per_company": { "title": "Max enrichments per company", "type": "string", "description": "Prospeo enrichment calls per company to date people found by web search, headlines, and team pages. 0 to 25, default 5.", "default": "5" }, "max_prospeo_pages_per_company": { "title": "Max Prospeo pages per company", "type": "string", "description": "Prospeo search pages of 25 people per company. 1 to 4, default 1.", "default": "1" }, "max_charge_usd": { "title": "Maximum charge for this run (USD)", "minimum": 0, "type": "number", "description": "Optional. The run stops before any charge that would take this run past this amount, and keeps every row already paid for. Leave empty to rely only on the maximum cost per run set in Apify, which the run also honors." }, "skip_cache": { "title": "Skip cache", "type": "boolean", "description": "Search again even when the same company and filters ran in the last 7 days. A cached result is returned free.", "default": false }, "source_tag": { "title": "Source Tag", "type": "string", "description": "Internal attribution tag set by Mamba Labs on published task examples. Not required, and nothing depends on it. Leave it empty." } } }, "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 } } } } } } } } } }