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

# Company Search

`POST /v1/companies/company-search`

Search for companies and retrieve comprehensive company intelligence including funding, employees, industry, and more.

## Request body

- object
  - `profile_url` string — Business company profile URL or identifier
  - `company_domain` string — Provide Company Domain
  - `company_name` string — Provide Company Name

## Response `200`

Successful response with company details

- object
  - `message` string — Status message
  - `credits_consumed` number — Number of credits consumed for this request
  - `companyName` string
  - `companyId` integer
  - `locations` object[]
    - `country` string
    - `city` string
    - `geographicArea` string
    - `postalCode` string
    - `line1` string
    - `line2` string, nullable
    - `description` string
    - `headquarter` boolean
    - `localizedName` string
    - `latitude` number
    - `longitude` number
  - `employeeCount` integer
  - `specialities` string[]
  - `employeeCountRange` object
    - `start` integer
    - `end` integer
  - `tagline` string
  - `followerCount` integer
  - `industry` string
  - `description` string
  - `websiteUrl` string
  - `headquarter` object
    - `country` string
    - `city` string
    - `geographicArea` string
    - `postalCode` string
    - `line1` string
    - `line2` string, nullable
    - `description` string
  - `foundedOn` object
    - `month` integer, nullable
    - `year` integer
    - `day` integer, nullable
  - `universalName` string
  - `hashtag` string
  - `url` string
  - `logo_url` string, nullable — Company logo URL from logo.leadmagic.io (generated from company domain)
  - `founded_year` string, nullable — Year the company was founded
  - `ownership_status` string, nullable — Ownership type (Public, Private, or Acquired)
  - `revenue` number, nullable — Estimated annual revenue
  - `revenue_formatted` string, nullable — Human-readable revenue format
  - `employee_range` string, nullable — Employee count range
  - `total_funding` string, nullable — Total funding raised
  - `funding_rounds` integer, nullable — Number of funding rounds completed
  - `last_funding_round` string, nullable — Type of most recent funding round
  - `last_funding_amount` number, nullable — Amount raised in most recent funding round
  - `last_funding_date` string, nullable — Date of most recent funding round
  - `competitors` string[], nullable — List of competitor company names
  - `acquisitions_count` integer, nullable — Number of acquisitions made by the company
  - `twitter_url` string, nullable — Twitter/X profile URL
  - `b2b_profile_url` string, nullable — B2B company profile URL
  - `facebook_url` string, nullable — Facebook page URL
  - `stock_ticker` string, nullable — Stock ticker symbol (if publicly traded)

## 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
- `404` — Not Found - The requested resource could not be found. **Common causes:** - Profile doesn't exist or is not accessible - Company not found in our database - Invalid URL or identifier
- `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
- `500` — Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io

---

[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)