Skip to main content
POST
/
v3
/
companies
/
competitors
Competitors Search
curl --request POST \
  --url https://api.leadmagic.io/v3/companies/competitors \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_domain": "vercel.com"
}
'
{
  "competitors": [
    {
      "name": "Netlify",
      "shortDescription": "Platform for modern web development.",
      "founded_year": "2014",
      "companyType": "Private",
      "hq": "San Francisco, US",
      "employeesCount": 500,
      "valuation": null,
      "tags": [
        {
          "name": "Web Development",
          "slug": "web-development",
          "primary": true
        }
      ],
      "twitter_followers": null,
      "growth": null,
      "non_hq_locations": [],
      "more_locations": false,
      "financial_metrics": null,
      "operating_metrics": [],
      "funding_metrics": {
        "date": "2021-11-17",
        "latest": 105000000,
        "currency_code": "USD",
        "total": 212000000
      },
      "twitterEngagement": null
    }
  ],
  "credits_consumed": 5
}

Documentation Index

Fetch the complete documentation index at: https://leadmagic.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Find Competitors

Find competitors and similar companies by analyzing market position and industry data. Essential for lookalike search, competitive intelligence, and market research.

​
Endpoint Details

MetricValue
Cost5 credits per search
No ResultsFREE if no competitors found
Returns a comprehensive list of competitors with their company profiles.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v3/companies/competitors' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"company_domain": "vercel.com"}'
POST /v1/companies/competitors-search remains available for existing integrations. New integrations should use POST /v3/companies/competitors.

​
Endpoint aliases

These paths run the same competitors search and return the same response shape: 
POST /v3/companies/competitors-search
POST /v1/companies/competitors-search
Use /v3/companies/competitors for new integrations.

​
Request Parameters

​
company_domain
string
Company website domain (most accurate).
​
company_url
string
Company profile URL.
​
company_name
string
Company name.
You must provide at least one identifier: company_domain, company_url, or company_name.

​
Response

​
competitors
array
required
Array of competitor or similar companies.
​
credits_consumed
number
required
Credits used (5 if found, 0 if not)

​
Competitor Object

FieldTypeDescription
namestringCompetitor company name
shortDescriptionstring | nullCompany description when available
founded_yearstring | nullYear founded, normalized to a string
companyTypestring | nullCompany type/category from the source profile
hqstring | nullHeadquarters location
employeesCountnumber | nullEstimated employee count
valuationnumber | nullValuation when available
tagsarraySource category tags, each with name, slug, and optional primary
twitter_followersnumber | nullTwitter/X follower count when available
growthnumber | nullGrowth metric from the source profile when available
non_hq_locationsarrayAdditional known locations
more_locationsbooleanWhether more locations exist beyond non_hq_locations
financial_metricsobject | nullRevenue, gross profit, net income, and related metrics when available
operating_metricsarrayOperating metrics when available
funding_metricsobject | nullLatest and total funding metrics when available
twitterEngagementobject | nullTwitter/X engagement analytics when available

​
Example Response

{
  "competitors": [
    {
      "name": "Netlify",
      "shortDescription": "Netlify is a platform for modern web development.",
      "founded_year": "2014",
      "companyType": "Private",
      "hq": "San Francisco, US",
      "employeesCount": 500,
      "valuation": null,
      "tags": [
        {
          "name": "Web Development",
          "slug": "web-development",
          "primary": true
        }
      ],
      "twitter_followers": null,
      "growth": null,
      "non_hq_locations": [],
      "more_locations": false,
      "financial_metrics": null,
      "operating_metrics": [],
      "funding_metrics": {
        "date": "2021-11-17",
        "latest": 105000000,
        "currency_code": "USD",
        "total": 212000000
      },
      "twitterEngagement": null
    },
    {
      "name": "Cloudflare",
      "shortDescription": "Cloudflare provides network, security, and developer services.",
      "founded_year": "2009",
      "companyType": "Public",
      "hq": "San Francisco, US",
      "employeesCount": 3000,
      "valuation": null,
      "tags": [],
      "twitter_followers": null,
      "growth": null,
      "non_hq_locations": [],
      "more_locations": false,
      "financial_metrics": null,
      "operating_metrics": [],
      "funding_metrics": null,
      "twitterEngagement": null
    }
  ],
  "credits_consumed": 5
}

​
Success Messages

MessageMeaningCost
competitors.length > 0Competitor list returned5 credits
competitors.length === 0No competitor data availableFREE

​
Best Practices

Send a seed domain such as vercel.com to get similar companies, then enrich returned domains with Company Enrichment.
Target competitor customers with tailored messaging about switching.
Use competitor employee counts to estimate total addressable market.
Find key contacts at competitors to understand their go-to-market strategy.

​
Use Cases

Competitive Intelligence

Understand the competitive landscape for target accounts.

Displacement Campaigns

Identify competitor customers for targeted outreach.

Market Analysis

Analyze market players and their positioning.

Sales Battlecards

Build competitive battlecards with accurate data.

Authorizations

​
X-API-Key
string
header
required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Body

application/json
​
company_domain
string

Company website domain. Preferred for lookalike-style searches.

Example:

"vercel.com"

​
company_url
string

Company profile URL or identifier.

Example:

"vercel"

​
company_name
string

Company name.

Example:

"Vercel"

Response

Successful response with competitors and similar companies

​
competitors
object[]
​
credits_consumed
number