{ "openapi": "3.0.1", "info": { "title": "Email Finder API - Work Emails, Phone Numbers, Profiles", "description": "Find work emails, personal emails and phone numbers for professionals by job title, seniority, employer, skills and location, and search companies by firmographics, tech stack and buying signals. Pay per result. Bring your own API key.", "version": "0.1", "x-build-id": "xGmsmrk4SMvknKJm5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~email-finder-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-email-finder-api", "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/nabeelbaghoor~email-finder-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-email-finder-api", "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/nabeelbaghoor~email-finder-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-email-finder-api", "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": { "mode": { "title": "Mode", "enum": [ "person-search", "person-lookup", "company-search", "company-lookup" ], "type": "string", "description": "What this run does. Searching discovers profiles and companies but does not resolve contact details. Looking up is what returns email addresses and phone numbers for people you name.", "default": "person-search" }, "lookups": { "title": "Lookup list", "type": "array", "description": "One lookup per line, used by the two lookup modes. Accepts a LinkedIn URL, an email address, a numeric provider id, a company domain, or a name. For a person you can add the employer after a pipe, for example \"Alex Example | Example Corp\", which makes the match far more reliable.", "items": { "type": "string" } }, "names": { "title": "Person names", "type": "array", "description": "Names to match.", "items": { "type": "string" } }, "currentTitles": { "title": "Current job titles", "type": "array", "description": "Match on the title a person holds right now.", "items": { "type": "string" } }, "currentOrPreviousTitles": { "title": "Current or previous job titles", "type": "array", "description": "Match a title whether the person holds it now or held it before.", "items": { "type": "string" } }, "previousTitles": { "title": "Previous job titles", "type": "array", "description": "Match on a title a person used to hold.", "items": { "type": "string" } }, "managementLevels": { "title": "Seniority levels", "type": "array", "description": "Seniority bands, for example C-Level, VP or Director. Use the provider's own level names.", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Departments to match, for example engineering, marketing or finance.", "items": { "type": "string" } }, "employers": { "title": "Current employers", "type": "array", "description": "Company names the person currently works for.", "items": { "type": "string" } }, "previousEmployers": { "title": "Previous employers", "type": "array", "description": "Company names the person used to work for. Useful for alumni targeting.", "items": { "type": "string" } }, "skills": { "title": "Skills (any)", "type": "array", "description": "Match a person carrying any of these skills.", "items": { "type": "string" } }, "allSkills": { "title": "Skills (all)", "type": "array", "description": "Match only people carrying every one of these skills.", "items": { "type": "string" } }, "schools": { "title": "Schools", "type": "array", "description": "Universities or schools attended.", "items": { "type": "string" } }, "degrees": { "title": "Degrees", "type": "array", "description": "Degrees held.", "items": { "type": "string" } }, "majors": { "title": "Majors", "type": "array", "description": "Fields of study.", "items": { "type": "string" } }, "yearsExperience": { "title": "Years of experience", "type": "array", "description": "Experience bands, written the way the provider documents them.", "items": { "type": "string" } }, "locations": { "title": "Person locations", "type": "array", "description": "Where the person is based.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "States or regions the person is based in.", "items": { "type": "string" } }, "jobChangeSignals": { "title": "Job change signals", "type": "array", "description": "Target people who recently changed roles, which is the strongest timing signal in outbound.", "items": { "type": "string" } }, "jobChangeRangeDays": { "title": "Job change window (days)", "type": "array", "description": "How far back a job change counts, in days, written as the provider documents it.", "items": { "type": "string" } }, "contactMethods": { "title": "Contact methods available", "type": "array", "description": "Only return people with a given contact method on file, for example a professional email or a mobile number.", "items": { "type": "string" } }, "emailGrade": { "title": "Minimum email grade", "type": "string", "description": "The provider grades email deliverability. Set a minimum grade to keep bounces down." }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text keyword searched across the profile." }, "companyNames": { "title": "Company names", "type": "array", "description": "Company names to match. Used by both the people search and the company search.", "items": { "type": "string" } }, "companyDomains": { "title": "Company domains", "type": "array", "description": "Company domains to match. The most reliable company key.", "items": { "type": "string" } }, "companyIndustries": { "title": "Industries", "type": "array", "description": "Industries to match.", "items": { "type": "string" } }, "companySizes": { "title": "Employee bands", "type": "array", "description": "Headcount bands, written exactly as the provider documents them. These are strings, not numbers.", "items": { "type": "string" } }, "companyRevenues": { "title": "Revenue bands", "type": "array", "description": "Revenue bands, written exactly as the provider documents them. These are strings, not numbers.", "items": { "type": "string" } }, "companyLocations": { "title": "Company locations", "type": "array", "description": "Where the company is based. Used by the company search.", "items": { "type": "string" } }, "companyGeos": { "title": "Company geography", "type": "array", "description": "Geographic filter for the company search.", "items": { "type": "string" } }, "companyCountryCodes": { "title": "Company country codes", "type": "array", "description": "Two-letter country codes of the company's location. Used by the people search.", "items": { "type": "string" } }, "companyNaicsCodes": { "title": "NAICS codes", "type": "array", "description": "NAICS classification codes.", "items": { "type": "string" } }, "companySicCodes": { "title": "SIC codes", "type": "array", "description": "SIC classification codes.", "items": { "type": "string" } }, "companyTechstack": { "title": "Technologies used", "type": "array", "description": "Technologies the company runs. Company search only.", "items": { "type": "string" } }, "companyCompetitors": { "title": "Competitors of", "type": "array", "description": "Find companies the provider treats as competitors of these, which is the fastest way to build a displacement list.", "items": { "type": "string" } }, "companyIntent": { "title": "Intent topics", "type": "array", "description": "Buying-intent topics the company is showing activity on.", "items": { "type": "string" } }, "companyJobPostingSignals": { "title": "Hiring signals", "type": "array", "description": "Signals derived from what the company is hiring for.", "items": { "type": "string" } }, "companyNewsSignals": { "title": "News signals", "type": "array", "description": "Signals derived from company news, for example a funding round or a leadership change.", "items": { "type": "string" } }, "companyGrowth": { "title": "Growth signals", "type": "array", "description": "Growth bands or signals. Company search only.", "items": { "type": "string" } }, "companyTotalFunding": { "title": "Total funding bands", "type": "array", "description": "Total funding raised, in the provider's own bands. Company search only.", "items": { "type": "string" } }, "companyFundingMin": { "title": "Minimum funding", "type": "array", "description": "Funding floor, written as the provider documents it. People search only.", "items": { "type": "string" } }, "companyFundingMax": { "title": "Maximum funding", "type": "array", "description": "Funding ceiling, written as the provider documents it. People search only.", "items": { "type": "string" } }, "companyPubliclyTraded": { "title": "Publicly traded", "type": "array", "description": "Restrict to publicly traded companies, or to private ones, using the provider's own values.", "items": { "type": "string" } }, "companyKeywords": { "title": "Company keywords", "type": "array", "description": "Free-text keywords matched against the company. Company search only.", "items": { "type": "string" } }, "companyWebsiteUrls": { "title": "Company website URLs", "type": "array", "description": "Match on full website URLs rather than bare domains.", "items": { "type": "string" } }, "orderBy": { "title": "Sort by", "enum": [ "relevance", "popularity", "score" ], "type": "string", "description": "How the provider orders search results. Leave on relevance unless you have a reason not to.", "default": "relevance" }, "skipUnmatched": { "title": "Skip lookups with no match", "type": "boolean", "description": "Drop a lookup the provider cannot resolve instead of returning a row marked as unmatched. Unmatched rows are never charged either way.", "default": false }, "rawQuery": { "title": "Extra filters", "type": "object", "description": "Any additional search filter, merged over the ones above and sent inside the provider's query object. Use this for a filter the provider adds after this actor was published." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many records (1 to 10,000). The provider limits search paging to 10,000 records deep. You are charged per result returned." }, "pageSize": { "title": "Results per request", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many records to request per search call (1 to 100). Larger pages mean fewer calls against your provider rate limit." }, "apiKey": { "title": "API key", "type": "string", "description": "Your own API key for the data provider. Required. Stored securely and never logged." } } }, "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 } } } } } } } } } }