LeadMagic — Company search (V3)

Canonical endpoint: POST /v3/companies/search — 25M+ companies. Aliases (same handler, direct-lookup inferred from the body, not the path): /v3/companies/company-search, /lookup, /enrich, /domain-lookup, /funding, /company-funding, /v1/companies/search.

Docs: Company Search V3

Credit-free browse search on qualifying plans

On Professional and Ultimate, browse search on this endpoint costs no credits, at 5 req/s (Professional) or 10 req/s (Ultimate), within a fair-use cap (10M records/month, 13,333 searches/day) shared across People, Company and Jobs search — see leadmagic.io/unlimited. Other plans pay ~1 credit per returned company. Never ration or narrow a query to save credits on an entitled plan. Lookalikes (/v3/companies/lookalike) are metered on every plan (flat 5 credits per successful response).

One vs Many

• One (direct lookup): company_domain (preferred), website, company_name, or a B2B company profile URL at the root. Low-latency single-account enrichment.
• Many (discovery): company_filters — domains array, headcount, geography, industry, funding, technographics. TAM building.

curl -sS -X POST "https://api.leadmagic.io/v3/companies/search" \
  -H "X-API-Key: $LEADMAGIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_filters": {
      "industries": ["Software Development"],
      "country_codes": ["US"],
      "min_employees": 51, "max_employees": 200,
      "crm_tech": ["HubSpot"]
    },
    "limit": 50
  }'

Filter families

HQ location vs presence location are different filters — passing both ANDs and narrows hard; pick the one the brief means and say which.

Cursor pagination

• First page: filters + limit (≤50 on cursor pages). No cursor, offset 0 or omitted.
• Response carries next_cursor and has_more.
• Next page: same filters + "cursor": "<next_cursor>".
• cursor + nonzero offset is rejected. next_cursor is only minted on the offset-0 form — if you were paging by offset, restart at offset 0 to switch to cursors.
• Stop when has_more is false. On Professional or Ultimate, paging a segment is credit-free within the fair-use cap.

Lookalikes (metered)

POST /v3/companies/lookalike (aliases /competitors, /competitors-search) — seed with company_domain or free-text description, scope with company_filters. Flat 5 credits per successful response; free on zero matches.

When not to use this skill

• People at these companies → people-search (people filters + company_filters)
• Single-domain V1 enrichment / funding rounds → company-enrichment
• Job postings at companies → job-search