---
title: "Company Search"
method: POST
path: "/v3/companies/search"
tags: ["Company Data"]
---

# Company Search

`POST /v3/companies/search`

Canonical V3 company lookup with all company filters.

## Request body

- object
  - `company_domain` string — Direct one-company lookup input. Returns one rich company row plus legacy-friendly aliases when no broad filters or explicit limit are supplied.
  - `domain` string — Alias for company_domain.
  - `website` string — Company website URL or domain.
  - `company_name` string — Company name lookup input.
  - `profile_url` string — Company profile URL.
  - `linkedin_url` string — Company profile URL.
  - `company_filters` object — Full company filter object.
  - `query` string
  - `limit` integer
  - `cursor` string — Opaque next_cursor from the previous page. Send unchanged with the same filters and limit.
  - `offset` integer

## Response `200`

Company search results

- object
  - `message` string
  - `credits_consumed` number
  - `companies` object[]
    - `company_domain` string
    - `company_name` string
    - `company_website` string
    - `company_industry_linkedin` string
    - `employee_range` string
    - `employee_min` integer
    - `employee_max` integer
    - `linkedin_employee_count` integer
    - `revenue_range` string
    - `revenue_min` string
    - `revenue_max` string
    - `hq_country` string
    - `hq_country_code` string
    - `hq_city` string
    - `hq_state` string
    - `hq_street` string, nullable
    - `hq_postcode` string, nullable
    - `hq_region` string
    - `hq_continent` string, nullable
    - `location_city` string, nullable
    - `location_country_code` string, nullable
    - `location_region` string, nullable
    - `location_state_code` string, nullable
    - `founded_year` integer, nullable
    - `specialties` string, nullable
    - `total_funding` number, nullable
    - `funding_investor_count` integer, nullable
    - `last_funding_type` string, nullable
    - `last_funding_date` string, nullable
    - `last_funding_amount` number, nullable
    - `lead_investors` string, nullable — Not returned in standard company search responses.
    - `linkedin_followers` integer, nullable
    - `growth_rate` integer, nullable
    - `linkedin_url` string, nullable
    - `linkedin_claimed` boolean
    - `company_headline` string, nullable
    - `company_about` string, nullable
    - `company_phone` string, nullable
    - `company_entity_type` string, nullable
    - `company_legal_type` string, nullable
    - `has_tech_stack` boolean
    - `profile_completeness_score` integer, nullable
    - `total_contacts` integer
    - `contacts_with_email` integer
    - `contacts_with_phone` integer
    - `valid_email_count` integer
    - `website_active` boolean
    - `website_for_sale` boolean
    - `sic_code` string, nullable
    - `naics_code` string, nullable
    - `sic_description` string, nullable
    - `naics_description` string, nullable
    - `predicted_naics_2022_code` string, nullable
    - `domain_tld` string
    - `total_app_reviews` integer
    - `crm_tech` string, nullable
    - `marketing_automation_tech` string, nullable
    - `sales_automation_tech` string, nullable
    - `analytics_tech` string, nullable
    - `cloud_provider_tech` string, nullable
    - `development_tech` string, nullable
    - `ecommerce_tech` string, nullable
    - `erp_tech` string, nullable
    - `email_hosting_tech` string, nullable
    - `email_security_tech` string, nullable
    - `abm_tech` string, nullable
    - `cms_tech` string, nullable
    - `conversation_intelligence_tech` string, nullable
    - `app_security_tech` string, nullable
    - `cloud_security_tech` string, nullable
    - `company_martech` string, nullable
    - `category` string[]
  - `found` boolean — Present for one-company lookup requests.
  - `company` object, nullable — Present for one-company lookup requests. Contains the first returned company row.
  - `companyName` string, nullable — Present for one-company lookup requests. Alias for company.company_name.
  - `companyDomain` string, nullable — Present for one-company lookup requests. Alias for company.company_domain.
  - `websiteUrl` string, nullable — Present for one-company lookup requests. Alias for company.company_website.
  - `linkedinUrl` string, nullable — Present for one-company lookup requests. Alias for company.linkedin_url.
  - `count` integer
  - `returned_count` integer
  - `limit_applied` integer
  - `offset` integer
  - `has_more` boolean
  - `next_cursor` string, nullable
  - `interpreted_search` object
  - `metadata` object

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `402` — Payment Required - Insufficient credits for this request. **Action required:** Add credits to your account at https://app.leadmagic.io/settings/billing
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/revisions/aa19cf9bc46a/schema)