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

# Competitors Search

`POST /v1/companies/competitors-search`

Find competitors of a company by analyzing market position and industry data.

## Request body

- object
  - `company_domain` string — Company website domain
  - `company_url` string — Company profile URL or identifier (optional)
  - `company_name` string — Company name

## Response `200`

Successful response with competitors details

- object
  - `competitors` object[]
    - `name` string
    - `shortDescription` string
    - `founded_year` string
    - `companyType` string
    - `hq` string
    - `employeesCount` integer
    - `valuation` integer
    - `tags` object[]
      - `name` string
      - `slug` string
      - `primary` boolean
    - `twitter_followers` integer
    - `growth` integer
    - `non_hq_locations` string[]
    - `more_locations` boolean
    - `financial_metrics` object
      - `currency_code` string
      - `period` string
      - `revenue` integer
      - `cost_of_goods_sold` integer, nullable
      - `gross_profit` integer, nullable
      - `net_income` integer, nullable
    - `operating_metrics` object[]
      - `period` string
      - `value` string
      - `definition` string
      - `operating_metric_group` string
      - `currency_code` string, nullable
    - `funding_metrics` object
      - `date` string
      - `latest` integer
      - `currency_code` string
      - `total` integer
    - `twitterEngagement` object
      - `handle` string
      - `analytics` object[]
        - `collectedAt` string
        - `tweets` integer
        - `following` integer
        - `followers` integer
        - `tweetsForPeriod` integer
        - `avgTweetsPerDay` number
        - `avgRetweetsPerTweet` number
        - `avgLikesPerTweet` number
        - `tweetsPercentageEngagementForPeriod` number

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