{ "openapi": "3.0.1", "info": { "title": "Lookalike Company Search API - Find Similar Companies", "description": "Find companies that look like your best customers. Search a B2B company database by lookalike domain, industry, technology stack, headcount, revenue, funding and location, enrich domains you already hold, and pull the people behind each account. Pay per result. Bring your own API key.", "version": "0.1", "x-build-id": "vt0KILkP6AjF4d8m1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~lookalike-company-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-lookalike-company-search-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~lookalike-company-search-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-lookalike-company-search-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~lookalike-company-search-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-lookalike-company-search-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": [ "company-search", "company-preview", "company-enrich", "people-search" ], "type": "string", "description": "What this run does. Company search returns full company records page by page. Preview only counts how many companies match and returns a small sample, which is the cheap way to size an audience first. Company enrichment resolves domains you already hold. People search returns individual contacts at the companies your filters describe.", "default": "company-search" }, "lookalikeDomains": { "title": "Lookalike domains", "type": "array", "description": "Up to 10 domains of companies you already like. The provider finds semantically similar companies from their website content, which is the core of this API. Leave empty to search on the structured filters alone.", "items": { "type": "string" } }, "companyMatchingMode": { "title": "Lookalike matching mode", "enum": [ "precise", "broad" ], "type": "string", "description": "How strictly lookalike domains are matched. Precise uses semantic similarity of products and services. Broad matches anything in the same industries and returns a much wider set.", "default": "precise" }, "includeDomains": { "title": "Only these domains", "type": "array", "description": "Restrict the result set to these domains. Useful for re-running a known list through the same field selection.", "items": { "type": "string" } }, "excludeDomains": { "title": "Exclude domains", "type": "array", "description": "Remove these domains from the results, for example customers you already have.", "items": { "type": "string" } }, "enrichDomains": { "title": "Domains to enrich", "type": "array", "description": "The domains to resolve into full company records. One provider call per domain. Enrichment mode only.", "items": { "type": "string" } }, "industries": { "title": "Industries", "type": "array", "description": "Industry names from the provider vocabulary, such as Advertising Platforms or Biopharma. The full list is served by the provider's data fields endpoint.", "items": { "type": "string" } }, "industriesMode": { "title": "Industry match mode", "enum": [ "anyOf", "allOf" ], "type": "string", "description": "Any of matches a company carrying at least one of the industries. All of requires every one of them.", "default": "anyOf" }, "excludeIndustries": { "title": "Exclude industries", "type": "array", "description": "Industries to remove from the results.", "items": { "type": "string" } }, "industryCategories": { "title": "Industry categories", "type": "array", "description": "Broader groupings above industries, such as Real Estate or Hardware.", "items": { "type": "string" } }, "industryCategoriesMode": { "title": "Industry category match mode", "enum": [ "anyOf", "allOf" ], "type": "string", "description": "Whether a company must carry any or all of the listed categories.", "default": "anyOf" }, "excludeIndustryCategories": { "title": "Exclude industry categories", "type": "array", "description": "Industry categories to remove from the results.", "items": { "type": "string" } }, "linkedinIndustries": { "title": "LinkedIn industries", "type": "array", "description": "The industry as stated on the company's LinkedIn page, such as Computer Software. This is an any-of filter.", "items": { "type": "string" } }, "excludeLinkedinIndustries": { "title": "Exclude LinkedIn industries", "type": "array", "description": "LinkedIn industries to remove from the results.", "items": { "type": "string" } }, "keywordsAny": { "title": "Keywords - any of", "type": "array", "description": "Match a company carrying at least one of these keywords. Widens the result set.", "items": { "type": "string" } }, "keywordsAll": { "title": "Keywords - all of", "type": "array", "description": "Require every one of these keywords. Narrows the result set sharply.", "items": { "type": "string" } }, "keywordsNone": { "title": "Keywords - none of", "type": "array", "description": "Remove companies carrying any of these keywords.", "items": { "type": "string" } }, "companySizes": { "title": "Company size bands", "type": "array", "description": "Headcount bands, as defined by the provider. Select as many as you need.", "items": { "type": "string", "enum": [ "0-1", "2-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001-50000", "50001-100000", "100001-500000", "500000+" ], "enumTitles": [ "0 to 1", "2 to 10", "11 to 50", "51 to 200", "201 to 500", "501 to 1000", "1001 to 5000", "5001 to 10000", "10001 to 50000", "50001 to 100000", "100001 to 500000", "500000 plus" ] } }, "revenues": { "title": "Revenue bands", "type": "array", "description": "Estimated annual revenue bands in USD.", "items": { "type": "string", "enum": [ "0-1M", "1-10M", "10-50M", "50-100M", "100-500M", "500-1000M", ">1000M" ], "enumTitles": [ "0 to 1M", "1 to 10M", "10 to 50M", "50 to 100M", "100 to 500M", "500M to 1B", "Over 1B" ] } }, "employeeCountFrom": { "title": "LinkedIn employee count from", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Lower bound on the number of employees linked to the company's LinkedIn page." }, "employeeCountTo": { "title": "LinkedIn employee count to", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Upper bound on the number of employees linked to the company's LinkedIn page." }, "yearFoundedFrom": { "title": "Founded from year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Earliest founding year, for example 2015." }, "yearFoundedTo": { "title": "Founded to year", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Latest founding year, for example 2024." }, "ecommerce": { "title": "E-commerce", "enum": [ "any", "true", "false" ], "type": "string", "description": "Whether to keep only e-commerce companies, exclude them, or ignore the distinction.", "default": "any" }, "hqIncludeCountries": { "title": "Headquarters countries", "type": "array", "description": "Two letter lowercase ISO 3166 country codes for the company headquarters, for example us, gb, de.", "items": { "type": "string" } }, "hqExcludeCountries": { "title": "Exclude headquarters countries", "type": "array", "description": "Two letter lowercase ISO 3166 country codes to exclude from the headquarters filter.", "items": { "type": "string" } }, "officeIncludeCountries": { "title": "Office countries", "type": "array", "description": "Countries where the company has an office other than the headquarters. Use this to find companies with a presence in a market rather than a head office there.", "items": { "type": "string" } }, "officeExcludeCountries": { "title": "Exclude office countries", "type": "array", "description": "Countries whose offices should disqualify a company.", "items": { "type": "string" } }, "countriesCountFrom": { "title": "Operates in at least N countries", "minimum": 0, "maximum": 300, "type": "integer", "description": "Lower bound on how many countries the company operates in. A quick proxy for international reach." }, "countriesCountTo": { "title": "Operates in at most N countries", "minimum": 0, "maximum": 300, "type": "integer", "description": "Upper bound on how many countries the company operates in." }, "locationsCountFrom": { "title": "At least N locations", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Lower bound on the number of offices or sites the company has." }, "locationsCountTo": { "title": "At most N locations", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Upper bound on the number of offices or sites the company has." }, "technologiesAny": { "title": "Technologies - any of", "type": "array", "description": "Software detected on the company website, matched if any one is present. Names come from the provider's technology vocabulary.", "items": { "type": "string" } }, "technologiesAll": { "title": "Technologies - all of", "type": "array", "description": "Require every one of these technologies on the website.", "items": { "type": "string" } }, "technologiesNone": { "title": "Technologies - none of", "type": "array", "description": "Exclude companies running any of these technologies, for example a competitor's product.", "items": { "type": "string" } }, "technologyCategoriesAny": { "title": "Technology categories - any of", "type": "array", "description": "Broader technology groupings such as Analytics, Security or Advertising.", "items": { "type": "string" } }, "technologyCategoriesNone": { "title": "Technology categories - none of", "type": "array", "description": "Technology categories that disqualify a company.", "items": { "type": "string" } }, "fundingRoundTypes": { "title": "Funding round types", "type": "array", "description": "Match companies whose latest known round is one of these types.", "items": { "type": "string", "enum": [ "Pre-Seed", "Seed", "Angel", "Series A", "Series B", "Series C", "Series D", "Series E", "Series F", "Series G", "Series H", "Series I", "Series J", "Series Unknown", "Grant", "Convertible Note", "Debt Financing", "Non-Equity Assistance", "Corporate Round", "Equity Crowdfunding", "Product Crowdfunding", "Private Equity", "Secondary Market", "Initial Coin Offering", "Post-IPO Equity", "Post-IPO Debt", "Post-IPO Secondary", "Undisclosed" ] } }, "fundingRaisedFrom": { "title": "Raised at least (USD)", "minimum": 0, "type": "integer", "description": "Lower bound on the amount raised in the funding round." }, "fundingRaisedTo": { "title": "Raised at most (USD)", "minimum": 0, "type": "integer", "description": "Upper bound on the amount raised in the funding round." }, "fundingDateFrom": { "title": "Funding date from", "type": "string", "description": "Earliest funding round date, as an ISO date such as 2024-01-01." }, "fundingDateTo": { "title": "Funding date to", "type": "string", "description": "Latest funding round date, as an ISO date such as 2026-01-01." }, "webTrafficVisitsFrom": { "title": "Monthly visits from", "minimum": 0, "type": "integer", "description": "Lower bound on estimated monthly website visits. A practical size signal when headcount is missing." }, "webTrafficVisitsTo": { "title": "Monthly visits to", "minimum": 0, "type": "integer", "description": "Upper bound on estimated monthly website visits." }, "webTrafficViewsFrom": { "title": "Monthly page views from", "minimum": 0, "type": "integer", "description": "Lower bound on estimated monthly page views." }, "webTrafficViewsTo": { "title": "Monthly page views to", "minimum": 0, "type": "integer", "description": "Upper bound on estimated monthly page views." }, "updatedWithinMonths": { "title": "Updated within months", "minimum": 1, "maximum": 60, "type": "integer", "description": "Only return companies the provider refreshed in the last N months, up to 60. Use this to keep a recurring run away from stale records." }, "minRelevance": { "title": "Minimum relevance", "enum": [ "A", "B", "C" ], "type": "string", "description": "Relevance band floor for lookalike searches, where A is the most relevant." }, "maxRelevance": { "title": "Maximum relevance", "enum": [ "A", "B", "C" ], "type": "string", "description": "Relevance band ceiling. Set minimum and maximum to the same letter to take exactly one band." }, "fieldsExist": { "title": "Require these fields to exist", "type": "array", "description": "Only return companies where these fields are populated, for example emails or locations. A cheap way to keep an export usable.", "items": { "type": "string", "enum": [ "companySize", "countries", "departmentSizes", "description", "emails", "faxes", "impressum", "industries", "industryCategories", "keywords", "legalName", "linkedinIndustry", "locations", "logo", "medias", "mobileApps", "name", "phones", "primaryCountry", "revenue", "rootUrl", "technologies", "technologyCategories", "webTraffic", "yearFounded" ] } }, "fieldsNotExist": { "title": "Require these fields to be empty", "type": "array", "description": "Only return companies where these fields are missing.", "items": { "type": "string", "enum": [ "companySize", "countries", "departmentSizes", "description", "emails", "faxes", "impressum", "industries", "industryCategories", "keywords", "legalName", "linkedinIndustry", "locations", "logo", "medias", "mobileApps", "name", "phones", "primaryCountry", "revenue", "rootUrl", "technologies", "technologyCategories", "webTraffic", "yearFounded" ] } }, "seniorities": { "title": "Seniorities", "type": "array", "description": "Seniority levels computed from the person's job title. People search, or as a company filter meaning the company employs at least one such person.", "items": { "type": "string", "enum": [ "Owner", "Founder", "Board Member", "C-Level", "Partner", "VP", "Head", "Director", "Manager", "Other" ] } }, "jobTitleKeywordsAny": { "title": "Job title keywords - any of", "type": "array", "description": "Match a person whose job title carries at least one of these words.", "items": { "type": "string" } }, "jobTitleKeywordsAll": { "title": "Job title keywords - all of", "type": "array", "description": "Require every one of these words in the job title.", "items": { "type": "string" } }, "jobTitleKeywordsNone": { "title": "Job title keywords - none of", "type": "array", "description": "Exclude people whose job title carries any of these words.", "items": { "type": "string" } }, "skillsAny": { "title": "Skills - any of", "type": "array", "description": "Match a person whose LinkedIn profile lists at least one of these skills.", "items": { "type": "string" } }, "skillsAll": { "title": "Skills - all of", "type": "array", "description": "Require every one of these skills on the profile.", "items": { "type": "string" } }, "skillsNone": { "title": "Skills - none of", "type": "array", "description": "Exclude people whose profile lists any of these skills.", "items": { "type": "string" } }, "peopleCountries": { "title": "People countries", "type": "array", "description": "Two letter lowercase ISO 3166 country codes for where the people are, which is not always where the company is.", "items": { "type": "string" } }, "lookalikeLinkedinHandles": { "title": "Lookalike LinkedIn handles", "type": "array", "description": "LinkedIn handles of people you already want more of. The provider returns similar profiles. A handle is the last part of the profile URL.", "items": { "type": "string" } }, "includeLinkedinHandles": { "title": "Only these LinkedIn handles", "type": "array", "description": "Restrict the people search to these handles.", "items": { "type": "string" } }, "excludeLinkedinHandles": { "title": "Exclude LinkedIn handles", "type": "array", "description": "Remove these people from the results.", "items": { "type": "string" } }, "peoplePerCompany": { "title": "People per company", "minimum": 1, "maximum": 20, "type": "integer", "description": "Cap how many people are returned from each company, 1 to 20. Leave empty to take everyone who matches. People search only." }, "advancedCompanyFilters": { "title": "Advanced company filters", "type": "string", "description": "A raw JSON object merged into the company filter tree, for filters beyond the fields above such as departmentSizes, headcountGrowth, mobileAppsFilter or socialMedias. Keys given here win over the fields above. Example: {\"headcountGrowth\": {\"months\": \"Three months\", \"growthRange\": {\"from\": 5}}}" }, "advancedPeopleFilters": { "title": "Advanced people filters", "type": "string", "description": "A raw JSON object merged into the people filter tree, for filters beyond the fields above such as states, currentJobDescription or profileDescription. Example: {\"states\": [{\"abbreviation\": \"NY\", \"country\": \"us\"}]}" }, "skipUnmatched": { "title": "Skip unmatched domains", "type": "boolean", "description": "Leave unresolved domains out of the dataset entirely. By default they are stored with matched set to false, which is free, so you can see exactly which inputs failed to resolve.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 25000, "type": "integer", "description": "Stop after this many records (1 to 25,000). You are charged per record returned." }, "pageSize": { "title": "Results per request", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many records to request per call (1 to 1000). Larger pages mean fewer round trips. Preview mode clamps this to the provider's 5 to 50 range." }, "apiKey": { "title": "API key", "type": "string", "description": "Your own API token for the data provider. Required. Sent as a request header and never logged or placed in a URL." } } }, "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 } } } } } } } } } }