POST

companies

company-search

Company Search

curl --request POST \
  --url https://api.leadmagic.io/v1/companies/company-search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "profile_url": "leadmagichq",
  "company_domain": "leadmagic.io",
  "company_name": "Leadmagic"
}
'

{
  "message": "Company found",
  "credits_consumed": 1,
  "companyName": "LeadMagic",
  "companyId": 75153174,
  "locations": [
    {
      "country": "US",
      "city": "Boston",
      "geographicArea": "Massachusetts",
      "postalCode": "02210",
      "line1": "1 Seaport Ln",
      "line2": null,
      "description": "Headquarters",
      "headquarter": true,
      "localizedName": "Boston",
      "latitude": 42.36041,
      "longitude": -71.05798
    }
  ],
  "employeeCount": 9,
  "specialities": [
    "Sales",
    "Marketing",
    "ABM",
    "RevOps"
  ],
  "employeeCountRange": {
    "start": 11,
    "end": 50
  },
  "tagline": "Acme Corp provides enterprise software solutions for B2B companies. Their platform helps teams streamline operations and drive growth.",
  "followerCount": 4663,
  "industry": "Internet",
  "description": "LeadMagic tells you exactly what businesses are on your website and helps you enrich your contact and company data.",
  "websiteUrl": "https://leadmagic.io",
  "headquarter": {
    "country": "US",
    "city": "Boston",
    "geographicArea": "Massachusetts",
    "postalCode": "02210",
    "line1": "1 Seaport Ln",
    "line2": null,
    "description": "Headquarters"
  },
  "foundedOn": {
    "month": null,
    "year": 2022,
    "day": null
  },
  "universalName": "leadmagichq",
  "hashtag": "#abm",
  "url": "leadmagichq",
  "logo_url": "https://logo.leadmagic.io/leadmagic.io",
  "founded_year": "2009",
  "ownership_status": "Private",
  "revenue": 5100000000,
  "revenue_formatted": "5.1B",
  "employee_range": "5,000 - 10,000",
  "total_funding": "9.8B",
  "funding_rounds": 5,
  "last_funding_round": "Equity",
  "last_funding_amount": 694159778,
  "last_funding_date": "Apr 2024",
  "competitors": [
    "Rapyd",
    "Square",
    "PayPal",
    "Clover",
    "Payment Depot"
  ],
  "acquisitions_count": 3,
  "twitter_url": "https://twitter.com/leadmagichq",
  "b2b_profile_url": "leadmagichq",
  "facebook_url": "",
  "stock_ticker": "STRP"
}

Enrich Company

Find and enrich company data by domain, profile URL, or name. Get comprehensive firmographic data including industry, size, funding, and social profiles.

Endpoint Details

Pricing
Rate Limits
Response Time

Metric	Value
Cost	1 credit per company found
No Results	FREE if no company found

Includes extensive firmographic data: industry, size, funding, leadership, social profiles, and more.

Per-Endpoint Limit

Metric	Value
Requests/Minute	500
Burst Capacity	~8 requests/second

Gateway Limits (Account-Wide)

Tier	RPM	Daily
Standard	5,000	500,000
High Volume	10,000	1,000,000

Lower per-minute limit due to data complexity. Use domain for fastest lookups.

Metric	Value
Median (P50)	~500ms
P95	~1,500ms
P99	~3,000ms

Quick Example

curl -X POST 'https://api.leadmagic.io/v1/companies/company-search' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"company_domain": "company.com"}'

Request Parameters

company_domain

string

Company website domain (most accurate).

profile_url

string

Professional company profile URL or slug.

company_name

string

Company name (less precise, may match similar names).

You must provide at least one identifier: company_domain, profile_url, or company_name.

Response

companyName

string

Official company name

companyId

integer

Unique company identifier

industry

string

Primary industry

employeeCount

integer

Exact employee count

employeeRange

string

Employee count range (e.g., “51-200”)

founded

integer

Year founded

headquarters

object

Location with city, state, country, full address

Show Financial Data

revenue

string

Annual revenue range

funding

string

Total funding raised

Show Social Profiles

Show Additional Data

description

string

Company description

specialties

array

List of company specialties

competitors

array

Known competitor names

Example Response

{
  "companyName": "Company Inc",
  "companyId": 12345,
  "industry": "Technology",
  "employeeCount": 150,
  "employeeRange": "51-200",
  "founded": 2015,
  "headquarters": {
    "city": "San Francisco",
    "state": "California",
    "country": "United States"
  },
  "revenue": "$10M-$50M",
  "followerCount": 25000,
  "b2b_profile_url": "linkedin.com/company/company-inc",
  "logo_url": "https://...",
  "credits_consumed": 1,
  "message": "Company found"
}

Success Messages

Message	Meaning	Cost
`Company found`	Company data returned	1 credit
`Company not found`	No matching company	FREE

Best Practices

Use domain for accuracy

Domain lookups are most reliable. Company names can be ambiguous.

Cache results

Company data changes slowly. Cache results for 24-48 hours.

Chain with other endpoints

Use with Employee Finder or Role Finder to build complete account profiles.

Use Cases

CRM Enrichment

Enrich account records with firmographic data.

Lead Scoring

Use company size and industry for lead qualification.

Market Research

Analyze target market company profiles.

ABM Targeting

Build target account lists with rich 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

profile_url

string

default:leadmagichq

Business company profile URL or identifier

company_domain

string

default:leadmagic.io

Provide Company Domain

company_name

string

default:Leadmagic

Provide Company Name

Response

Successful response with company details

message

string

Status message

Example:

"Company found"

credits_consumed

number

Number of credits consumed for this request

Example:

1

companyName

string

Example:

"LeadMagic"

companyId

integer

Example:

75153174

locations

object[]

Show child attributes

employeeCount

integer

Example:

9

specialities

string[]

Example:

["Sales", "Marketing", "ABM", "RevOps"]

employeeCountRange

object

Show child attributes

tagline

string

Example:

"Acme Corp provides enterprise software solutions for B2B companies. Their platform helps teams streamline operations and drive growth."

followerCount

integer

Example:

4663

industry

string

Example:

"Internet"

description

string

Example:

"LeadMagic tells you exactly what businesses are on your website and helps you enrich your contact and company data."

websiteUrl

string

Example:

"https://leadmagic.io"

headquarter

object

Show child attributes

foundedOn

object

Show child attributes

universalName

string

Example:

"leadmagichq"

hashtag

string

Example:

"#abm"

url

string

Example:

"leadmagichq"

logo_url

string | null

Company logo URL from logo.leadmagic.io (generated from company domain)

Example:

"https://logo.leadmagic.io/leadmagic.io"

founded_year

string | null

Year the company was founded

Example:

"2009"

ownership_status

string | null

Ownership type (Public, Private, or Acquired)

Example:

"Private"

revenue

number | null

Estimated annual revenue

Example:

5100000000

revenue_formatted

string | null

Human-readable revenue format

Example:

"5.1B"

employee_range

string | null

Employee count range

Example:

"5,000 - 10,000"

total_funding

string | null

Total funding raised

Example:

"9.8B"

funding_rounds

integer | null

Number of funding rounds completed

Example:

5

last_funding_round

string | null

Type of most recent funding round

Example:

"Equity"

last_funding_amount

number | null

Amount raised in most recent funding round

Example:

694159778

last_funding_date

string | null

Date of most recent funding round

Example:

"Apr 2024"

competitors

string[] | null

List of competitor company names

Example:

[
  "Rapyd",
  "Square",
  "PayPal",
  "Clover",
  "Payment Depot"
]

acquisitions_count

integer | null

Number of acquisitions made by the company

Example:

3

twitter_url

string | null

Twitter/X profile URL

Example:

"https://twitter.com/leadmagichq"

b2b_profile_url

string | null

B2B company profile URL

Example:

"leadmagichq"

facebook_url

string | null

Facebook page URL

Example:

""

stock_ticker

string | null

Stock ticker symbol (if publicly traded)

Example:

"STRP"

Company FundingProvide the Company Domain or Company Name and get back the complete funding details of the company.

Company Search

curl --request POST \
  --url https://api.leadmagic.io/v1/companies/company-search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "profile_url": "leadmagichq",
  "company_domain": "leadmagic.io",
  "company_name": "Leadmagic"
}
'

{
  "message": "Company found",
  "credits_consumed": 1,
  "companyName": "LeadMagic",
  "companyId": 75153174,
  "locations": [
    {
      "country": "US",
      "city": "Boston",
      "geographicArea": "Massachusetts",
      "postalCode": "02210",
      "line1": "1 Seaport Ln",
      "line2": null,
      "description": "Headquarters",
      "headquarter": true,
      "localizedName": "Boston",
      "latitude": 42.36041,
      "longitude": -71.05798
    }
  ],
  "employeeCount": 9,
  "specialities": [
    "Sales",
    "Marketing",
    "ABM",
    "RevOps"
  ],
  "employeeCountRange": {
    "start": 11,
    "end": 50
  },
  "tagline": "Acme Corp provides enterprise software solutions for B2B companies. Their platform helps teams streamline operations and drive growth.",
  "followerCount": 4663,
  "industry": "Internet",
  "description": "LeadMagic tells you exactly what businesses are on your website and helps you enrich your contact and company data.",
  "websiteUrl": "https://leadmagic.io",
  "headquarter": {
    "country": "US",
    "city": "Boston",
    "geographicArea": "Massachusetts",
    "postalCode": "02210",
    "line1": "1 Seaport Ln",
    "line2": null,
    "description": "Headquarters"
  },
  "foundedOn": {
    "month": null,
    "year": 2022,
    "day": null
  },
  "universalName": "leadmagichq",
  "hashtag": "#abm",
  "url": "leadmagichq",
  "logo_url": "https://logo.leadmagic.io/leadmagic.io",
  "founded_year": "2009",
  "ownership_status": "Private",
  "revenue": 5100000000,
  "revenue_formatted": "5.1B",
  "employee_range": "5,000 - 10,000",
  "total_funding": "9.8B",
  "funding_rounds": 5,
  "last_funding_round": "Equity",
  "last_funding_amount": 694159778,
  "last_funding_date": "Apr 2024",
  "competitors": [
    "Rapyd",
    "Square",
    "PayPal",
    "Clover",
    "Payment Depot"
  ],
  "acquisitions_count": 3,
  "twitter_url": "https://twitter.com/leadmagichq",
  "b2b_profile_url": "leadmagichq",
  "facebook_url": "",
  "stock_ticker": "STRP"
}

Account

Email

Contact

Company

People

Jobs

Ads

Company Search

Enrich Company

Endpoint Details

Per-Endpoint Limit

Gateway Limits (Account-Wide)

Quick Example

Request Parameters

Response

Example Response

Success Messages

Best Practices

Use Cases

CRM Enrichment

Lead Scoring

Market Research

ABM Targeting

Authorizations

Body

Response

Account

Email

Contact

Company

People

Jobs

Ads

​Enrich Company

​Endpoint Details

​Per-Endpoint Limit

​Gateway Limits (Account-Wide)

​Quick Example

​Request Parameters

​Response

​Example Response

​Success Messages

​Best Practices

​Use Cases

CRM Enrichment

Lead Scoring

Market Research

ABM Targeting

Authorizations

Body

Response

Enrich Company

Endpoint Details

Per-Endpoint Limit

Gateway Limits (Account-Wide)

Quick Example

Request Parameters

Response

Example Response

Success Messages

Best Practices

Use Cases