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
Unlimited with the right plan
Professional and Ultimate plans search this endpoint free — no credits, no volume
cap. The only limit is rate: 5 req/s sustained (Professional), 10 req/s (Ultimate).
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
| Group |
Fields |
| Identity |
company_domains, company_websites, company_names, B2B profile URLs, keyword, query |
| Firmographics |
industries, employee_ranges / min/max_employees, revenue_ranges, founded_after/before, sic_codes, naics_codes, specialties |
| Geography |
country_codes (HQ), location_country_codes (presence), hq_regions/cities/states |
| Funding |
has_funding, min/max_total_funding, last_funding_types, last_funding_after/before |
| Technographics |
crm_tech, marketing_automation_tech, sales_automation_tech, analytics_tech, cloud_provider_tech, tech_stack |
| Coverage |
min/max_total_contacts, min/max_contacts_with_email, min/max_valid_email_count |
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 an unlimited plan, paging a whole segment is free.
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
1---2name: company-search3description: LeadMagic V3 company search via POST /v3/companies/search — 25M+ companies with firmographic, geographic, funding, and technographic filters, plus lookalikes. Use when building account lists, filtering companies by criteria, finding lookalike companies, or handling company cursor pagination.4license: MIT5---67# LeadMagic — Company search (V3)89Canonical endpoint: **`POST /v3/companies/search`** — 25M+ companies.10Aliases (same handler, direct-lookup inferred from the body, not the path):11`/v3/companies/company-search`, `/lookup`, `/enrich`, `/domain-lookup`,12`/funding`, `/company-funding`, `/v1/companies/search`.1314Docs: [Company Search V3](https://leadmagic.io/docs/api-reference/company-search-v3?utm_source=github&utm_medium=skill&utm_campaign=leadmagic-skills)1516## Unlimited with the right plan1718**Professional and Ultimate plans search this endpoint free** — no credits, no volume19cap. The only limit is rate: **5 req/s sustained (Professional), 10 req/s (Ultimate)**.20Other plans pay ~1 credit per returned company. Never ration or narrow a query to21save credits on an entitled plan. Lookalikes (`/v3/companies/lookalike`) are22**metered on every plan** (flat 5 credits per successful response).2324## One vs Many2526- **One** (direct lookup): `company_domain` (preferred), `website`, `company_name`,27 or a B2B company profile URL at the root. Low-latency single-account enrichment.28- **Many** (discovery): `company_filters` — domains array, headcount, geography,29 industry, funding, technographics. TAM building.3031```bash32curl -sS -X POST "https://api.leadmagic.io/v3/companies/search" \33 -H "X-API-Key: $LEADMAGIC_API_KEY" \34 -H "Content-Type: application/json" \35 -d '{36 "company_filters": {37 "industries": ["Software Development"],38 "country_codes": ["US"],39 "min_employees": 51, "max_employees": 200,40 "crm_tech": ["HubSpot"]41 },42 "limit": 5043 }'44```4546## Filter families4748| Group | Fields |49|-------|--------|50| Identity | `company_domains`, `company_websites`, `company_names`, B2B profile URLs, `keyword`, `query` |51| Firmographics | `industries`, `employee_ranges` / `min/max_employees`, `revenue_ranges`, `founded_after/before`, `sic_codes`, `naics_codes`, `specialties` |52| Geography | `country_codes` (HQ), `location_country_codes` (presence), `hq_regions/cities/states` |53| Funding | `has_funding`, `min/max_total_funding`, `last_funding_types`, `last_funding_after/before` |54| Technographics | `crm_tech`, `marketing_automation_tech`, `sales_automation_tech`, `analytics_tech`, `cloud_provider_tech`, `tech_stack` |55| Coverage | `min/max_total_contacts`, `min/max_contacts_with_email`, `min/max_valid_email_count` |5657HQ location vs presence location are different filters — passing both ANDs and58narrows hard; pick the one the brief means and say which.5960## Cursor pagination6162- First page: filters + `limit` (**≤50 on cursor pages**). No `cursor`, `offset` 0 or omitted.63- Response carries `next_cursor` and `has_more`.64- Next page: **same filters** + `"cursor": "<next_cursor>"`.65- `cursor` + nonzero `offset` is rejected. `next_cursor` is only minted on the66 offset-0 form — if you were paging by offset, restart at offset 0 to switch to cursors.67- Stop when `has_more` is false. On an unlimited plan, paging a whole segment is free.6869## Lookalikes (metered)7071`POST /v3/companies/lookalike` (aliases `/competitors`, `/competitors-search`) —72seed with `company_domain` or free-text `description`, scope with `company_filters`.73Flat 5 credits per successful response; free on zero matches.7475## When not to use this skill7677- People at these companies → `people-search` (people filters + `company_filters`)78- Single-domain V1 enrichment / funding rounds → `company-enrichment`79- Job postings at companies → `job-search`
LeadMagic