Skip to main content
POST
/
v3
/
companies
/
lookalike
Company Lookalike
curl --request POST \
  --url https://api.leadmagic.io/v3/companies/lookalike \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_domain": "leadmagic.io",
  "company_filters": {
    "country_codes": [
      "US"
    ],
    "employee_ranges": [
      "51 to 200",
      "201 to 500"
    ],
    "has_tech_stack": true
  },
  "limit": 25
}
'
{
  "message": "Lookalike companies found",
  "credits_consumed": 5,
  "companies": [
    {
      "company_domain": "example-lookalike.com",
      "company_name": "Example Lookalike",
      "company_website": "https://example-lookalike.com",
      "company_industry_linkedin": "Software",
      "employee_range": "51 to 200",
      "hq_country_code": "US",
      "crm_tech": "Salesforce",
      "total_contacts": 50,
      "similarity": 0.91,
      "source_seed_domain": "leadmagic.io",
      "match_context": "B2B data platform"
    }
  ],
  "count": 1,
  "returned_count": 1,
  "limit_applied": 25,
  "offset": 0,
  "metadata": {
    "query_name": "company_lookalike_v3",
    "query_path": "lookalike"
  }
}

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.

​
Company Lookalike

POST /v3/companies/lookalike finds similar companies from a seed domain, website, or text description. It returns the same full company output row as Company Search, plus lookalike scoring fields when available.

​
Endpoint Details

MetricValue
Cost5 credits when lookalike companies are returned
No ResultsFREE
PreviewFREE with preview: true
Lookalike requests return full company rows, so you usually do not need a second lookup for each result.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v3/companies/lookalike' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_domain": "leadmagic.io",
    "company_filters": {
      "country_codes": ["US"],
      "employee_ranges": ["51 to 200", "201 to 500"],
      "has_tech_stack": true
    },
    "limit": 25
  }'

​
Request Body

Provide either a seed domain/website or a text description.
​
company_domain
string
Seed company domain. Preferred for strongest vector lookalike matching.
​
domain
string
Alias for company_domain.
​
website
string
Seed website URL or domain. Normalized to a domain.
​
seed
object
Optional seed object. Supports seed.domain, seed.domains, and seed.description.
​
description
string
Free-text company description to embed for lookalike discovery when you do not have a seed domain.
​
company_name
string
Seed company name used as text intent when no domain is supplied. Domains are more precise.
​
company_filters
object
Same full company filter family as Company Search, applied after vector similarity.
​
preview
boolean
default:"false"
Return a zero-credit preview.
​
limit
integer
default:"25"
Number of lookalike companies to return. Maximum is 2000.
​
offset
integer
default:"0"
Offset for pagination.

​
Response

​
message
string
Human-readable result summary.
​
credits_consumed
number
5 when lookalikes are returned in a paid request, otherwise 0.
​
companies
object[]
Full company rows matching the seed and filters.
​
count
integer
Number of lookalike companies returned.
​
interpreted_search
object
Normalized seed and company filters used by the backend.
Returned company rows include the full Company Search output fields such as firmographics, funding, location, contact coverage, classification, website status, and technology columns. Lookalike rows can also include:
FieldTypeDescription
similaritynumberVector similarity score for the matched company.
source_seed_domainstringSeed domain that produced the match when multiple seeds are supplied.
match_contextstringEmbedding text or context that helped produce the match.

Company Search

Build filtered account lists with the same output row shape.

People Search

Search contacts inside one company or a filtered company set.

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

Seed company domain.

Example:

"leadmagic.io"

​
domain
string

Alias for company_domain.

​
website
string

Seed website URL or domain.

​
company_name
string

Seed company name used as text intent when no domain is supplied.

​
description
string

Free-text seed description.

​
seed
object
​
company_filters
object

Same full company filter family as Company Search.

​
preview
boolean
default:false
​
limit
integer
default:25
Required range: 1 <= x <= 2000
​
offset
integer
default:0
Required range: x >= 0

Response

Company lookalike results

​
message
string
​
credits_consumed
number
​
companies
object[]
​
count
integer
​
returned_count
integer
​
limit_applied
integer
​
offset
integer
​
interpreted_search
object
​
metadata
object