POST

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
}
'

import requests

url = "https://api.leadmagic.io/v3/companies/lookalike"

payload = {
    "company_domain": "leadmagic.io",
    "company_filters": {
        "country_codes": ["US"],
        "employee_ranges": ["51 to 200", "201 to 500"],
        "has_tech_stack": True
    },
    "limit": 25
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    company_domain: 'leadmagic.io',
    company_filters: {
      country_codes: ['US'],
      employee_ranges: ['51 to 200', '201 to 500'],
      has_tech_stack: true
    },
    limit: 25
  })
};

fetch('https://api.leadmagic.io/v3/companies/lookalike', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v3/companies/lookalike"

	payload := strings.NewReader("{\n  \"company_domain\": \"leadmagic.io\",\n  \"company_filters\": {\n    \"country_codes\": [\n      \"US\"\n    ],\n    \"employee_ranges\": [\n      \"51 to 200\",\n      \"201 to 500\"\n    ],\n    \"has_tech_stack\": true\n  },\n  \"limit\": 25\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v3/companies/lookalike",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'company_domain' => 'leadmagic.io',
    'company_filters' => [
        'country_codes' => [
                'US'
        ],
        'employee_ranges' => [
                '51 to 200',
                '201 to 500'
        ],
        'has_tech_stack' => true
    ],
    'limit' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "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"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/validation_error",
      "title": "Request validation failed. Check your input parameters.",
      "status": 400,
      "code": "validation_error",
      "param": [
        "email"
      ],
      "detail": "Email format is invalid. Expected format: user@domain.com",
      "action": "Provide a valid email address in the 'email' field.",
      "docs": "https://leadmagic.io/docs/api-reference/errors"
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/missing_authentication",
      "title": "Authentication required. Provide a valid API key in the X-API-Key header (case-insensitive).",
      "status": 401,
      "code": "missing_authentication",
      "docs": "https://leadmagic.io/docs/api-reference/authentication"
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/insufficient_credits",
      "title": "Insufficient credits: need 5, have 2.50. Add credits to continue.",
      "status": 402,
      "code": "insufficient_credits",
      "detail": "This request requires 5 credit(s) but your account only has 2.50 credits remaining.",
      "action": "Add credits to your account at https://app.leadmagic.io/billing or contact support@leadmagic.io for enterprise plans.",
      "docs": "https://leadmagic.io/docs/api-reference/credits",
      "context": {
        "credits_required": 5,
        "credits_available": 2.5,
        "credits_needed": 2.5
      }
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/rate_limit_exceeded",
      "title": "Rate limit exceeded: 300 requests per 1 minute. Wait and try again.",
      "status": 429,
      "code": "rate_limit_exceeded",
      "detail": "You have exceeded the maximum allowed request rate. Please wait before making additional requests.",
      "action": "Wait 42 seconds before retrying. Consider implementing exponential backoff.",
      "docs": "https://leadmagic.io/docs/api-reference/rate-limits",
      "context": {
        "limit": 300,
        "window": "1 minute",
        "remaining": 0,
        "reset_at": 1706745642,
        "retry_after_seconds": 42
      }
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

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

Pricing
Rate Limits

Metric	Value
Cost	5 credits when lookalike companies are returned
No Results	FREE

Lookalike requests return full company rows, so you usually do not need a second lookup for each result.

Metric	Value
Requests/Minute	500
Burst Capacity	Subject to workspace limits

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
  }'

const response = await fetch('https://api.leadmagic.io/v3/companies/lookalike', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    company_domain: 'leadmagic.io',
    company_filters: {
      country_codes: ['US'],
      employee_ranges: ['51 to 200', '201 to 500'],
      has_tech_stack: true
    },
    limit: 25
  })
});

const data = await response.json();
console.log(`${data.count} lookalike companies found`);

Request Body

Provide either a seed domain/website or a text description.

string

Seed company domain. Preferred for strongest vector lookalike matching.

string

Alias for company_domain.

string

Seed website URL or domain. Normalized to a domain.

object

Optional seed object. Supports seed.domain, seed.domains, and seed.description.

string

Free-text company description to embed for lookalike discovery when you do not have a seed domain.

string

Seed company name used as text intent when no domain is supplied. Domains are more precise.

object

Same full company filter family as Company Search, applied after vector similarity.

integer

default:"25"

Number of lookalike companies to return. Maximum is 2000.

integer

default:"0"

Offset for pagination.

Response

string

Human-readable result summary.

number

5 when lookalikes are returned in a paid request, otherwise 0.

object[]

Full company rows matching the seed and filters.

integer

Number of lookalike companies returned.

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:

Field	Type	Description
`similarity`	`number`	Vector similarity score for the matched company.
`source_seed_domain`	`string`	Seed domain that produced the match when multiple seeds are supplied.
`match_context`	`string`	Embedding 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.

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

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
}
'

import requests

url = "https://api.leadmagic.io/v3/companies/lookalike"

payload = {
    "company_domain": "leadmagic.io",
    "company_filters": {
        "country_codes": ["US"],
        "employee_ranges": ["51 to 200", "201 to 500"],
        "has_tech_stack": True
    },
    "limit": 25
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    company_domain: 'leadmagic.io',
    company_filters: {
      country_codes: ['US'],
      employee_ranges: ['51 to 200', '201 to 500'],
      has_tech_stack: true
    },
    limit: 25
  })
};

fetch('https://api.leadmagic.io/v3/companies/lookalike', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v3/companies/lookalike"

	payload := strings.NewReader("{\n  \"company_domain\": \"leadmagic.io\",\n  \"company_filters\": {\n    \"country_codes\": [\n      \"US\"\n    ],\n    \"employee_ranges\": [\n      \"51 to 200\",\n      \"201 to 500\"\n    ],\n    \"has_tech_stack\": true\n  },\n  \"limit\": 25\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v3/companies/lookalike",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'company_domain' => 'leadmagic.io',
    'company_filters' => [
        'country_codes' => [
                'US'
        ],
        'employee_ranges' => [
                '51 to 200',
                '201 to 500'
        ],
        'has_tech_stack' => true
    ],
    'limit' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "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"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/validation_error",
      "title": "Request validation failed. Check your input parameters.",
      "status": 400,
      "code": "validation_error",
      "param": [
        "email"
      ],
      "detail": "Email format is invalid. Expected format: user@domain.com",
      "action": "Provide a valid email address in the 'email' field.",
      "docs": "https://leadmagic.io/docs/api-reference/errors"
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/missing_authentication",
      "title": "Authentication required. Provide a valid API key in the X-API-Key header (case-insensitive).",
      "status": 401,
      "code": "missing_authentication",
      "docs": "https://leadmagic.io/docs/api-reference/authentication"
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/insufficient_credits",
      "title": "Insufficient credits: need 5, have 2.50. Add credits to continue.",
      "status": 402,
      "code": "insufficient_credits",
      "detail": "This request requires 5 credit(s) but your account only has 2.50 credits remaining.",
      "action": "Add credits to your account at https://app.leadmagic.io/billing or contact support@leadmagic.io for enterprise plans.",
      "docs": "https://leadmagic.io/docs/api-reference/credits",
      "context": {
        "credits_required": 5,
        "credits_available": 2.5,
        "credits_needed": 2.5
      }
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

{
  "success": false,
  "errors": [
    {
      "type": "https://api.leadmagic.io/errors/rate_limit_exceeded",
      "title": "Rate limit exceeded: 300 requests per 1 minute. Wait and try again.",
      "status": 429,
      "code": "rate_limit_exceeded",
      "detail": "You have exceeded the maximum allowed request rate. Please wait before making additional requests.",
      "action": "Wait 42 seconds before retrying. Consider implementing exponential backoff.",
      "docs": "https://leadmagic.io/docs/api-reference/rate-limits",
      "context": {
        "limit": 300,
        "window": "1 minute",
        "remaining": 0,
        "reset_at": 1706745642,
        "retry_after_seconds": 42
      }
    }
  ],
  "meta": {
    "request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
    "timestamp": "2024-02-01T12:00:00.000Z"
  }
}

Get Started

API Endpoints

MCP Server

CLI

Company Lookalike

Company Lookalike

Endpoint Details

Quick Example

Request Body

Response

Company Search

People Search

Authorizations

Body

Response

​Company Lookalike

​Endpoint Details

​Quick Example

​Request Body

​Response

​Related endpoints

Company Search

People Search

Authorizations

Body

Response

Company Lookalike

Endpoint Details

Quick Example

Request Body

Response

Related endpoints