LEleadmagic
Company Data

Company Search

Changed on

Canonical V3 company identity lookup and discovery using the documented supported criteria. Check ignored_filters and warnings for selected criteria that were not applied.

post/v3/companies/search

Request

  • Base URL
    https://api.leadmagic.io
  • Auth
    API key in header X-API-Key

Request body

company_domainstring

Direct one-company lookup input. Returns one rich company row plus legacy-friendly aliases when no broad filters or explicit limit are supplied.

domainstring

Alias for company_domain.

websitestring

Company website URL or domain.

company_namestring

Company name lookup input.

profile_urlstring

Company profile URL.

linkedin_urlstring

Company profile URL.

company_filtersobject

Supported discovery criteria include identity, headquarters, industry/classification, headcount, revenue, founding year, funding, profile counts, recorded flags, company text, and technology. Identity arrays form an OR group; other selected attributes AND with it. Numeric/date bounds are inclusive. Each requested technology and specialty must match; company_martech category values are alternatives. tech_stack and each *_tech criterion accept at most 50 values; more values match no records. Office-presence geography, followers/growth, and custom ordering are unavailable. Search does not expose email or phone availability. Unsupported selected keys appear in ignored_filters and warnings.

querystring
limitinteger
cursorstring

Opaque next_cursor from the previous page. Send unchanged with the same filters and limit.

offsetinteger

Legacy offset pagination; prefer cursor. Unstable ordering, uncached. Restart at offset 0 to obtain a cursor.

Example request

{
  "company_domain": "leadmagic.io"
}

Response

Company search results

messagestring
credits_consumednumber
foundboolean

Present for one-company lookup requests.

companyobject nullable

Present for one-company lookup requests. Contains the first returned company row.

companyNamestring nullable

Present for one-company lookup requests. Alias for company.company_name.

companyDomainstring nullable

Present for one-company lookup requests. Alias for company.company_domain.

websiteUrlstring nullable

Present for one-company lookup requests. Alias for company.company_website.

linkedinUrlstring nullable

Present for one-company lookup requests. Alias for company.linkedin_url.

countinteger

Number of companies returned in this page, not total audience size.

returned_countinteger

Number of companies returned in this page.

ignored_filtersstring[]

Qualified keys of selected criteria that were not applied.

warningsstring[]

Explanations of unavailable or unapplied criteria.

limit_appliedinteger
offsetinteger
has_moreboolean
next_cursorstring nullable

Opaque signed token for the next page, or null on the last page. Send back as cursor with offset 0. Cursor pagination is stable and cached.

interpreted_searchobject

Changes

  • ab8d23e356d3Revision changes
    • warning

      removed the optional property // from the response with the status

  • 73ee3c7d32f2Revision changes
    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status