Skip to main content
POST
/
v2
/
multi-search-lookalikes
Search for lookalike companies
curl --request POST \
  --url https://api.tamtam.ai/api/v2/multi-search-lookalikes \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "employees_on_linkedin_max": 123,
  "employees_on_linkedin_min": 123,
  "founded_max": 123,
  "founded_min": 123,
  "hq_countries": [
    "<string>"
  ],
  "industries": [
    "<string>"
  ],
  "input_companies": [
    {
      "domain": "<string>",
      "linkedin_id": "<string>",
      "linkedin_slug": "<string>",
      "name": "<string>"
    }
  ],
  "paging": {
    "limit": 123,
    "total": 123
  },
  "queries": [
    "<string>"
  ],
  "sizes": [
    "<string>"
  ]
}
'
{
  "credits": {
    "credits_left": 123,
    "credits_used": 123
  },
  "lookalikes": [
    {
      "linkedin_company": {
        "company_address": "<string>",
        "company_size": "<string>",
        "countries": [
          "<string>"
        ],
        "description": "<string>",
        "domain": "<string>",
        "employees_on_linkedin": 123,
        "founded": 123,
        "headquarters": "<string>",
        "hq_country": "<string>",
        "hq_state": "<string>",
        "industry": "<string>",
        "linkedin_id": "<string>",
        "linkedin_url": "<string>",
        "logo_url": "<string>",
        "name": "<string>",
        "organization_type": "<string>",
        "slug": "<string>",
        "website": "<string>"
      },
      "score": 123
    }
  ],
  "matched_inputs": [
    {
      "confidence": 123,
      "input_company": {
        "domain": "<string>",
        "linkedin_id": "<string>",
        "linkedin_slug": "<string>",
        "name": "<string>"
      },
      "matched_company": {
        "domain": "<string>",
        "employees_on_linkedin": 123,
        "linkedin_id": "<string>",
        "linkedin_slug": "<string>",
        "name": "<string>"
      }
    }
  ],
  "paging": {
    "limit": 123,
    "total": 123
  }
}

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Body

application/json
employees_on_linkedin_max
integer<int64>

Max number of employees on LinkedIn

Example:

50

employees_on_linkedin_min
integer<int64>

Min number of employees on LinkedIn

Example:

10

founded_max
integer<int64>

Companies founded before year N

Example:

2025

founded_min
integer<int64>

Companies founded after year N

Example:

2022

hq_countries
string[] | null

2 letter country codes e.g. ["FR", "DE"]

Example:
["FR"]
industries
string[] | null

LinkedIn Industry filters e.g. ["Software Development"]

Example:
["Software Development"]
input_companies
object[] | null

List of companies to find lookalikes for

paging
object

Paging parameters

queries
string[] | null

Full text queries about activities

Example:
["AI sales agents"]
sizes
string[] | null

Company size filters e.g. ["11-50", "51-200"]

Example:
["11-50"]

Response

OK

credits
object
required

Credits usage information

lookalikes
object[] | null
required

List of lookalike companies found

matched_inputs
object[] | null
required

Input companies matched to our database

paging
object
required

Paging information