# Company Search API - Firmographics, Headcount & Funding (`nabeelbaghoor/company-search-enrichment-api`) Actor Search and screen companies by industry, region, headcount and growth signals, and export enriched firmographic records - website, LinkedIn, headcount and headcount growth, funding and location. Pay per result. Bring your own API key. - **URL**: https://apify.com/nabeelbaghoor/company-search-enrichment-api.md - **Developed by:** [Nabeel Hassan](https://apify.com/nabeelbaghoor) (community) - **Categories:** Jobs, Developer tools, Lead generation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $15.00 / 1,000 company results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Company Search API - firmographics, headcount and funding **Company Search API** turns a real-time company dataset into a clean, structured export. Screen companies by industry, region, headcount and growth signals, and export enriched firmographic records - website, LinkedIn, headcount and headcount growth, funding and location - as JSON, CSV or Excel. Bring your own API token and pay only for the records you keep. ### Why use this actor? - **Firmographic screening** - filter a large company universe by industry, region or country, and headcount range. - **Growth signals** - each record can carry month-over-month, quarter-over-quarter and year-over-year headcount growth, funding and web-traffic figures. - **Enriched output** - company name, website, domain, LinkedIn URL, headcount, growth percentages, valuation, total investment and location, parsed into flat columns. - **Advanced filters** - use simple fields for the common cases, or pass raw filter objects for full control over every supported signal. - **Pay per result** - you are charged only for the company records actually returned, up to 1,000 per run. - **No proxies, no blocks** - data comes through a stable API, so runs are fast and reliable. ### Use cases - **Lead generation and TAM building** - build target account lists by industry, geography and size. - **Market mapping** - map a sector's players and rank them by headcount or growth. - **Sales intelligence** - prioritize accounts that are growing headcount or recently raised funding. - **Investment research** - screen private companies by growth and funding signals. - **CRM enrichment** - append firmographics and growth metrics to your existing account list. ### Input Configure everything from the visual editor - every filter is a proper field, no code needed. Example JSON input: ```json { "industries": ["Software"], "regions": ["United States"], "headcountMin": 50, "headcountMax": 500, "maxResults": 100, "apiKey": "YOUR_API_TOKEN" } ```` For signals beyond the built-in fields, add raw filter objects: ```json { "rawFilters": [ { "filter_type": "INDUSTRY", "type": "in", "value": ["Financial Services"] }, { "filter_type": "COMPANY_HEADCOUNT", "type": "between", "value": [200, 1000] } ], "maxResults": 250, "apiKey": "YOUR_API_TOKEN" } ``` ### Output One clean JSON object per company: ```json { "company_name": "Acme Analytics", "company_website": "acme.com", "company_website_domain": "acme.com", "linkedin_profile_url": "https://www.linkedin.com/company/acme", "linkedin_headcount": 320, "linkedin_headcount_yoy_percent": 18.4, "valuation_usd": 450000000, "crunchbase_total_investment_usd": 82000000, "days_since_last_fundraise": 210, "largest_headcount_country": "United States", "region": "San Francisco Bay Area", "company_id": 123456 } ``` ### Do I need an API key? Yes. This actor calls a company data API on your behalf, which requires your own **API token**. Sign up self-serve with the provider to get a token, paste it into the input, and run. Your token is stored securely and never logged. ### Pay per result You pay only for the company records the actor actually returns - no subscriptions, no minimums. Set **Maximum results** to cap each run's spend exactly. ### FAQ #### What is the Company Search API? It is a company data API that lets you screen a large, continuously updated company universe by firmographics and growth signals, then returns enriched records - website, LinkedIn, headcount, headcount growth, funding and location. This actor runs that search and exports the matches as JSON, CSV or Excel. #### What filters can I use? Built-in fields for industry, region or country, and a headcount range. For any other supported signal - growth rates, funding, and more - add raw filter objects in the Advanced field, each in the form `{ "filter_type": ..., "type": ..., "value": ... }`. #### What growth and funding data is included? Where available, each record carries LinkedIn headcount plus month-over-month, quarter-over-quarter and year-over-year headcount growth, valuation, total investment, days since last fundraise, and monthly web visitors - ideal for prioritizing fast-growing or recently funded accounts. #### How many results can I get per run? Up to 1,000 company records per run, paged automatically. For larger universes, split the search by industry, region or headcount band across multiple runs. #### How much does it cost? Pricing is pay-per-result: a small fixed amount per company record returned, plus standard Apify platform usage, plus your own API usage against your token. A run that returns nothing costs almost nothing. #### Can I run this on a schedule? Yes. Use Apify Schedules to run it daily or weekly and connect the dataset to Zapier, Make, n8n, webhooks or the API to push new or updated accounts into your CRM or data warehouse. #### Is this legal? The actor returns company firmographic data retrieved through a licensed API using your own credentials. It focuses on company-level business data, not personal data. ### Keyword map company data api, company search api, firmographics api, company enrichment api, b2b data api, lead generation api, headcount data api, company growth data, funding data api, sales intelligence api, account list building, tam data api. ### Support and feedback Found an issue or missing a filter? Open an issue in the **Issues** tab - it is monitored daily. # Actor input Schema ## `industries` (type: `array`): Filter to companies in these industries, e.g. `Software`, `Financial Services`, `Hospital & Health Care`. Multiple values are combined as OR (matches the INDUSTRY filter). ## `regions` (type: `array`): Filter to companies headquartered in these regions or countries, e.g. `United States`, `United Kingdom`, `San Francisco Bay Area` (matches the REGION filter). Combined as OR. ## `headcountMin` (type: `integer`): Lower bound on current employee headcount (matches the COMPANY\_HEADCOUNT filter). ## `headcountMax` (type: `integer`): Upper bound on current employee headcount. ## `rawFilters` (type: `array`): Power users: an array of raw filter objects in the form `{ "filter_type": "INDUSTRY", "type": "in", "value": ["Software"] }`. When set, these are appended to the filters built from the fields above. See the API's company search documentation for all supported filter\_type values (e.g. INDUSTRY, REGION, COMPANY\_HEADCOUNT, and growth/funding signals). ## `startPage` (type: `integer`): 1-based page to start from. Increase to skip earlier results. ## `maxResults` (type: `integer`): Stop after this many company records (1-1,000). Paged automatically. You are charged per result returned. ## `apiKey` (type: `string`): Your company data API token. Required. Sign up self-serve at the provider to get a free token. Stored securely and never logged. ## Actor input object example ```json { "startPage": 1, "maxResults": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxResults": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("nabeelbaghoor/company-search-enrichment-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxResults": 100 } # Run the Actor and wait for it to finish run = client.actor("nabeelbaghoor/company-search-enrichment-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxResults": 100 }' | apify call nabeelbaghoor/company-search-enrichment-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nabeelbaghoor/company-search-enrichment-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Company Search API - Firmographics, Headcount & Funding", "description": "Search and screen companies by industry, region, headcount and growth signals, and export enriched firmographic records - website, LinkedIn, headcount and headcount growth, funding and location. Pay per result. Bring your own API key.", "version": "0.1", "x-build-id": "6Q5GAdW7FxSyq55pa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~company-search-enrichment-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-company-search-enrichment-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~company-search-enrichment-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-company-search-enrichment-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~company-search-enrichment-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-company-search-enrichment-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": { "industries": { "title": "Industries", "type": "array", "description": "Filter to companies in these industries, e.g. `Software`, `Financial Services`, `Hospital & Health Care`. Multiple values are combined as OR (matches the INDUSTRY filter).", "items": { "type": "string" } }, "regions": { "title": "Regions / countries", "type": "array", "description": "Filter to companies headquartered in these regions or countries, e.g. `United States`, `United Kingdom`, `San Francisco Bay Area` (matches the REGION filter). Combined as OR.", "items": { "type": "string" } }, "headcountMin": { "title": "Minimum headcount", "minimum": 0, "type": "integer", "description": "Lower bound on current employee headcount (matches the COMPANY_HEADCOUNT filter)." }, "headcountMax": { "title": "Maximum headcount", "minimum": 0, "type": "integer", "description": "Upper bound on current employee headcount." }, "rawFilters": { "title": "Advanced filters", "type": "array", "description": "Power users: an array of raw filter objects in the form `{ \"filter_type\": \"INDUSTRY\", \"type\": \"in\", \"value\": [\"Software\"] }`. When set, these are appended to the filters built from the fields above. See the API's company search documentation for all supported filter_type values (e.g. INDUSTRY, REGION, COMPANY_HEADCOUNT, and growth/funding signals)." }, "startPage": { "title": "Start page", "minimum": 1, "type": "integer", "description": "1-based page to start from. Increase to skip earlier results.", "default": 1 }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many company records (1-1,000). Paged automatically. You are charged per result returned." }, "apiKey": { "title": "API token", "type": "string", "description": "Your company data API token. Required. Sign up self-serve at the provider to get a free token. 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 } } } } } } } } } } ```