--- title: "Find companies matching a filter" description: "Run job:company.search through the looot API: 14 providers, from $0.00036 per result. Inputs, prices, output shape and code for curl, JavaScript and Python." sidebar: hidden: true --- {/* Generated by scripts/generate-api-reference.mjs from data/api-reference.json. Do not edit. */} Find companies matching a filter. Job id `company.search`, in [Enrichment](/catalog/enrichment) (Company data). As of 2026-10-01, 14 providers serve it through 19 tools. Run `job:company.search` and looot picks one of them; with `fallback` on, a miss moves on to the next. See [Jobs](/concepts/jobs). ## Inputs A job run takes shared input names; looot maps them to each provider's own fields. See [Job inputs](/concepts/job-inputs). | Input | Taken by | | --- | --- | | `limit` | 12 of 18 providers | | `query` | 11 of 18 providers | | `page` | 10 of 18 providers | | `industry` | 6 of 18 providers | | `location` | 5 of 18 providers | | `domain` | 1 of 18 providers | | `linkedin_url` | 1 of 18 providers | Any other key you send passes through unchanged. Each tool's own fields are on its page below. ## Providers and prices | Provider | Tool | Price | | --- | --- | --- | | [Anysite](/providers/anysite) | [`anysite-api-linkedin-search-companies`](/reference/tools/anysite-api-linkedin-search-companies) | $0.00036 per result | | [Icypeas](/providers/icypeas) | [`icypeas-find-companies`](/reference/tools/icypeas-find-companies) | $0.00038 per result | | [AI Ark](/providers/ai-ark) | [`ai-ark-companies`](/reference/tools/ai-ark-companies) | $0.0012 per result | | [The Companies API](/providers/thecompaniesapi) | [`thecompaniesapi-companies-by-prompt`](/reference/tools/thecompaniesapi-companies-by-prompt) | $0.0019 per result | | [The Companies API](/providers/thecompaniesapi) | [`thecompaniesapi-companies-get`](/reference/tools/thecompaniesapi-companies-get) | $0.0019 per result | | [The Companies API](/providers/thecompaniesapi) | [`thecompaniesapi-companies-post`](/reference/tools/thecompaniesapi-companies-post) | $0.0019 per result | | Lusha | [`lusha-companies-prospecting`](/reference/tools/lusha-companies-prospecting) | $0.005 per result | | [Tomba](/providers/tomba) | [`tomba-reveal-search`](/reference/tools/tomba-reveal-search) | $0.0089 per call | | [PredictLeads](/providers/predictleads) | [`predictleads-discover-companies`](/reference/tools/predictleads-discover-companies) | $0.01 per result | | [PredictLeads](/providers/predictleads) | [`predictleads-discover-extended-companies`](/reference/tools/predictleads-discover-extended-companies) | $0.01 per result | | [FullEnrich](/providers/fullenrich) | [`fullenrich-api-company-search`](/reference/tools/fullenrich-api-company-search) | $0.016 per result | | [Prospeo](/providers/prospeo) | [`prospeo-search-company`](/reference/tools/prospeo-search-company) | $0.039 per call | | [Akta](/providers/akta) | [`akta-company-search`](/reference/tools/akta-company-search) | $0.05 per call | | [Akta](/providers/akta) | [`akta-list-generate-companies`](/reference/tools/akta-list-generate-companies) | $0.05 per result | | [Aviato](/providers/aviato) | [`aviato-company-search`](/reference/tools/aviato-company-search) | $0.05 per call | | [TheirStack](/providers/theirstack) | [`theirstack-companies-search`](/reference/tools/theirstack-companies-search) | $0.0981 per result | | [Signalbase](/providers/signalbase) | [`signalbase-companies`](/reference/tools/signalbase-companies) | $0.108 per call | | [People Data Labs](/providers/people-data-labs) | [`people-data-labs-company-search-get`](/reference/tools/people-data-labs-company-search-get) | $0.28 per result | | [People Data Labs](/providers/people-data-labs) | [`people-data-labs-company-search-post`](/reference/tools/people-data-labs-company-search-post) | $0.28 per result | A call that fails at the provider costs $0. See [What's free](/money/free-and-failures). ## Output Each provider answers in its own shape. Shape of the run's `result` from [`icypeas-find-companies`](/reference/tools/icypeas-find-companies), checked against 73 real answers: ```txt { error, leads: { _id, lid, url, urn, name, type, phone, slogan, address, revenue: { unit, amount, currency }, website, industry, pictureUrl, description, foundedYear, specialties: { value }[], employeeGrowth: { timespan, percentage }[], headcountRange: { gte, lte }, numberOfEmployees, estimatedRevenuRange: { estimatedMaxRevenue: { ... }, estimatedMinRevenue: { ... } } }[], total, success, pagination: { size, token }, validationErrors: { type, field, actual: { country }, message, expected, humanReadableMessage }[] } ``` ## Run it Every call needs your API token in `LOOOT_TOKEN`; [Sign in](/get-started/sign-in#use-the-token-in-scripts-and-agents) shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With `wait: 30` the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll `GET /v1/runs/`. Example input with placeholder values: ```bash curl curl -X POST "https://api.looot.ai/v1/runs" \ -H "Authorization: Bearer $LOOOT_TOKEN" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{"endpointId":"job:company.search","input":{"domain":"example.com"},"wait":30}' ``` ```js JavaScript const response = await fetch("https://api.looot.ai/v1/runs", { method: "POST", headers: { Authorization: `Bearer ${process.env.LOOOT_TOKEN}`, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID(), }, body: JSON.stringify({ endpointId: "job:company.search", input: { domain: "example.com", }, wait: 30, }), }); const run = await response.json(); console.log(run.status, run.result); ``` ```python Python import os import uuid import requests response = requests.post( "https://api.looot.ai/v1/runs", headers={ "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}", "Idempotency-Key": str(uuid.uuid4()), }, json={ "endpointId": "job:company.search", "input": { "domain": "example.com", }, "wait": 30, }, timeout=90, ) run = response.json() print(run["status"], run.get("result")) ``` To pin one provider, send its tool id as `endpointId` instead of `job:company.search`.