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": 50,
"employees_on_linkedin_min": 10,
"founded_max": 2025,
"founded_min": 2022,
"hq_countries": [
"FR"
],
"industries": [
"Software Development"
],
"input_companies": [
{
"domain": "tamtam.ai",
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
}
],
"paging": {
"limit": 10,
"total": 10
},
"queries": [
"AI sales agents"
],
"sizes": [
"11-50"
]
}
'import requests
url = "https://api.tamtam.ai/api/v2/multi-search-lookalikes"
payload = {
"employees_on_linkedin_max": 50,
"employees_on_linkedin_min": 10,
"founded_max": 2025,
"founded_min": 2022,
"hq_countries": ["FR"],
"industries": ["Software Development"],
"input_companies": [
{
"domain": "tamtam.ai",
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
}
],
"paging": {
"limit": 10,
"total": 10
},
"queries": ["AI sales agents"],
"sizes": ["11-50"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
employees_on_linkedin_max: 50,
employees_on_linkedin_min: 10,
founded_max: 2025,
founded_min: 2022,
hq_countries: ['FR'],
industries: ['Software Development'],
input_companies: [
{
domain: 'tamtam.ai',
linkedin_id: '104924588',
linkedin_slug: 'tamtam-ai',
name: 'TAMTAM'
}
],
paging: {limit: 10, total: 10},
queries: ['AI sales agents'],
sizes: ['11-50']
})
};
fetch('https://api.tamtam.ai/api/v2/multi-search-lookalikes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tamtam.ai/api/v2/multi-search-lookalikes",
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([
'employees_on_linkedin_max' => 50,
'employees_on_linkedin_min' => 10,
'founded_max' => 2025,
'founded_min' => 2022,
'hq_countries' => [
'FR'
],
'industries' => [
'Software Development'
],
'input_companies' => [
[
'domain' => 'tamtam.ai',
'linkedin_id' => '104924588',
'linkedin_slug' => 'tamtam-ai',
'name' => 'TAMTAM'
]
],
'paging' => [
'limit' => 10,
'total' => 10
],
'queries' => [
'AI sales agents'
],
'sizes' => [
'11-50'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tamtam.ai/api/v2/multi-search-lookalikes"
payload := strings.NewReader("{\n \"employees_on_linkedin_max\": 50,\n \"employees_on_linkedin_min\": 10,\n \"founded_max\": 2025,\n \"founded_min\": 2022,\n \"hq_countries\": [\n \"FR\"\n ],\n \"industries\": [\n \"Software Development\"\n ],\n \"input_companies\": [\n {\n \"domain\": \"tamtam.ai\",\n \"linkedin_id\": \"104924588\",\n \"linkedin_slug\": \"tamtam-ai\",\n \"name\": \"TAMTAM\"\n }\n ],\n \"paging\": {\n \"limit\": 10,\n \"total\": 10\n },\n \"queries\": [\n \"AI sales agents\"\n ],\n \"sizes\": [\n \"11-50\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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))
}HttpResponse<String> response = Unirest.post("https://api.tamtam.ai/api/v2/multi-search-lookalikes")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"employees_on_linkedin_max\": 50,\n \"employees_on_linkedin_min\": 10,\n \"founded_max\": 2025,\n \"founded_min\": 2022,\n \"hq_countries\": [\n \"FR\"\n ],\n \"industries\": [\n \"Software Development\"\n ],\n \"input_companies\": [\n {\n \"domain\": \"tamtam.ai\",\n \"linkedin_id\": \"104924588\",\n \"linkedin_slug\": \"tamtam-ai\",\n \"name\": \"TAMTAM\"\n }\n ],\n \"paging\": {\n \"limit\": 10,\n \"total\": 10\n },\n \"queries\": [\n \"AI sales agents\"\n ],\n \"sizes\": [\n \"11-50\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tamtam.ai/api/v2/multi-search-lookalikes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"employees_on_linkedin_max\": 50,\n \"employees_on_linkedin_min\": 10,\n \"founded_max\": 2025,\n \"founded_min\": 2022,\n \"hq_countries\": [\n \"FR\"\n ],\n \"industries\": [\n \"Software Development\"\n ],\n \"input_companies\": [\n {\n \"domain\": \"tamtam.ai\",\n \"linkedin_id\": \"104924588\",\n \"linkedin_slug\": \"tamtam-ai\",\n \"name\": \"TAMTAM\"\n }\n ],\n \"paging\": {\n \"limit\": 10,\n \"total\": 10\n },\n \"queries\": [\n \"AI sales agents\"\n ],\n \"sizes\": [\n \"11-50\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"credits": {
"credits_left": 4990,
"credits_used": 10
},
"lookalikes": [
{
"linkedin_company": {
"company_address": "Paris, France",
"company_size": "11-50",
"countries": [
"FR"
],
"description": "AI Agents boosting every step of your Sales Cycle",
"domain": "tamtam.ai",
"employees_on_linkedin": 20,
"founded": 2024,
"headquarters": "Paris, France",
"hq_country": "FR",
"hq_state": "Île-de-France",
"industry": "Software Development",
"linkedin_id": "104924588",
"linkedin_url": "https://www.linkedin.com/company/tamtam-ai",
"logo_url": "https://media.licdn.com/dms/image/tamtam.png",
"name": "TAMTAM",
"organization_type": "Privately Held",
"slug": "tamtam-ai",
"website": "https://www.tamtam.ai"
},
"score": 87
}
],
"matched_inputs": [
{
"confidence": 0.98,
"input_company": {
"domain": "tamtam.ai",
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
},
"matched_company": {
"domain": "tamtam.ai",
"employees_on_linkedin": 20,
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
}
}
],
"paging": {
"limit": 10,
"total": 10
}
}{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Search for lookalike companies
Find companies similar to the provided input companies. Supports filtering by country, industry, size, and more.
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": 50,
"employees_on_linkedin_min": 10,
"founded_max": 2025,
"founded_min": 2022,
"hq_countries": [
"FR"
],
"industries": [
"Software Development"
],
"input_companies": [
{
"domain": "tamtam.ai",
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
}
],
"paging": {
"limit": 10,
"total": 10
},
"queries": [
"AI sales agents"
],
"sizes": [
"11-50"
]
}
'import requests
url = "https://api.tamtam.ai/api/v2/multi-search-lookalikes"
payload = {
"employees_on_linkedin_max": 50,
"employees_on_linkedin_min": 10,
"founded_max": 2025,
"founded_min": 2022,
"hq_countries": ["FR"],
"industries": ["Software Development"],
"input_companies": [
{
"domain": "tamtam.ai",
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
}
],
"paging": {
"limit": 10,
"total": 10
},
"queries": ["AI sales agents"],
"sizes": ["11-50"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
employees_on_linkedin_max: 50,
employees_on_linkedin_min: 10,
founded_max: 2025,
founded_min: 2022,
hq_countries: ['FR'],
industries: ['Software Development'],
input_companies: [
{
domain: 'tamtam.ai',
linkedin_id: '104924588',
linkedin_slug: 'tamtam-ai',
name: 'TAMTAM'
}
],
paging: {limit: 10, total: 10},
queries: ['AI sales agents'],
sizes: ['11-50']
})
};
fetch('https://api.tamtam.ai/api/v2/multi-search-lookalikes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tamtam.ai/api/v2/multi-search-lookalikes",
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([
'employees_on_linkedin_max' => 50,
'employees_on_linkedin_min' => 10,
'founded_max' => 2025,
'founded_min' => 2022,
'hq_countries' => [
'FR'
],
'industries' => [
'Software Development'
],
'input_companies' => [
[
'domain' => 'tamtam.ai',
'linkedin_id' => '104924588',
'linkedin_slug' => 'tamtam-ai',
'name' => 'TAMTAM'
]
],
'paging' => [
'limit' => 10,
'total' => 10
],
'queries' => [
'AI sales agents'
],
'sizes' => [
'11-50'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tamtam.ai/api/v2/multi-search-lookalikes"
payload := strings.NewReader("{\n \"employees_on_linkedin_max\": 50,\n \"employees_on_linkedin_min\": 10,\n \"founded_max\": 2025,\n \"founded_min\": 2022,\n \"hq_countries\": [\n \"FR\"\n ],\n \"industries\": [\n \"Software Development\"\n ],\n \"input_companies\": [\n {\n \"domain\": \"tamtam.ai\",\n \"linkedin_id\": \"104924588\",\n \"linkedin_slug\": \"tamtam-ai\",\n \"name\": \"TAMTAM\"\n }\n ],\n \"paging\": {\n \"limit\": 10,\n \"total\": 10\n },\n \"queries\": [\n \"AI sales agents\"\n ],\n \"sizes\": [\n \"11-50\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<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))
}HttpResponse<String> response = Unirest.post("https://api.tamtam.ai/api/v2/multi-search-lookalikes")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"employees_on_linkedin_max\": 50,\n \"employees_on_linkedin_min\": 10,\n \"founded_max\": 2025,\n \"founded_min\": 2022,\n \"hq_countries\": [\n \"FR\"\n ],\n \"industries\": [\n \"Software Development\"\n ],\n \"input_companies\": [\n {\n \"domain\": \"tamtam.ai\",\n \"linkedin_id\": \"104924588\",\n \"linkedin_slug\": \"tamtam-ai\",\n \"name\": \"TAMTAM\"\n }\n ],\n \"paging\": {\n \"limit\": 10,\n \"total\": 10\n },\n \"queries\": [\n \"AI sales agents\"\n ],\n \"sizes\": [\n \"11-50\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tamtam.ai/api/v2/multi-search-lookalikes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"employees_on_linkedin_max\": 50,\n \"employees_on_linkedin_min\": 10,\n \"founded_max\": 2025,\n \"founded_min\": 2022,\n \"hq_countries\": [\n \"FR\"\n ],\n \"industries\": [\n \"Software Development\"\n ],\n \"input_companies\": [\n {\n \"domain\": \"tamtam.ai\",\n \"linkedin_id\": \"104924588\",\n \"linkedin_slug\": \"tamtam-ai\",\n \"name\": \"TAMTAM\"\n }\n ],\n \"paging\": {\n \"limit\": 10,\n \"total\": 10\n },\n \"queries\": [\n \"AI sales agents\"\n ],\n \"sizes\": [\n \"11-50\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"credits": {
"credits_left": 4990,
"credits_used": 10
},
"lookalikes": [
{
"linkedin_company": {
"company_address": "Paris, France",
"company_size": "11-50",
"countries": [
"FR"
],
"description": "AI Agents boosting every step of your Sales Cycle",
"domain": "tamtam.ai",
"employees_on_linkedin": 20,
"founded": 2024,
"headquarters": "Paris, France",
"hq_country": "FR",
"hq_state": "Île-de-France",
"industry": "Software Development",
"linkedin_id": "104924588",
"linkedin_url": "https://www.linkedin.com/company/tamtam-ai",
"logo_url": "https://media.licdn.com/dms/image/tamtam.png",
"name": "TAMTAM",
"organization_type": "Privately Held",
"slug": "tamtam-ai",
"website": "https://www.tamtam.ai"
},
"score": 87
}
],
"matched_inputs": [
{
"confidence": 0.98,
"input_company": {
"domain": "tamtam.ai",
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
},
"matched_company": {
"domain": "tamtam.ai",
"employees_on_linkedin": 20,
"linkedin_id": "104924588",
"linkedin_slug": "tamtam-ai",
"name": "TAMTAM"
}
}
],
"paging": {
"limit": 10,
"total": 10
}
}{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Account API key passed in the Authorization header
Body
Max number of employees on LinkedIn
50
Min number of employees on LinkedIn
10
Companies founded before year N
2025
Companies founded after year N
2022
2 letter country codes e.g. ["FR", "DE"]
["FR"]
LinkedIn Industry filters e.g. ["Software Development"]
["Software Development"]
List of companies to find lookalikes for
Show child attributes
Show child attributes
Paging parameters
Show child attributes
Show child attributes
Full text queries about activities
["AI sales agents"]
Company size filters e.g. ["11-50", "51-200"]
["11-50"]
Response
OK
Credits usage information
Show child attributes
Show child attributes
List of lookalike companies found
Show child attributes
Show child attributes
Input companies matched to our database
Show child attributes
Show child attributes
Paging information
Show child attributes
Show child attributes