Quickstart - TAMTAM

This guide walks you through finding lookalike companies — one of the most common TAMTAM API use cases.

Prerequisites

A TAMTAM account API key. See Authentication if you don’t have one.
curl (or any HTTP client).

Find lookalike companies

Given one or more input companies, the multi-search-lookalikes endpoint returns companies that resemble them, optionally filtered by country, industry, size, and more.

curl -X POST https://api.tamtam.ai/api/v2/multi-search-lookalikes \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_companies": [
      { "domain": "stripe.com" }
    ],
    "hq_countries": ["FR", "DE"],
    "sizes": ["51-200", "201-500"],
    "paging": { "limit": 10 }
  }'

The response contains a list of lookalikes ranked by similarity, the matched_inputs showing how each input was resolved, and your remaining credits.

Next steps

Read about Authentication and Rate limits.
Understand how Credits are consumed.