// get /v1/location
API Localisation
Obtenez la distribution géographique des employés de n'importe quel domaine d'entreprise. Retourne une ventilation pays par pays des localisations des employés.
// console api
- [0].name
- US
- [0].total
- 44
// 01 · requête
Location tient en une requête HTTPS
Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.
/locationdomainobligatoire- Company domain
curl -G https://api.tomba.io/v1/location \
--data-urlencode "domain=piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
domain: "piedpiper.com"
});
const res = await fetch(`https://api.tomba.io/v1/location?${params}`, {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/location",
params={
"domain": "piedpiper.com",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 02 · réponse
Ce qui est renvoyé
Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.
/locationdata[].namestring- Country code
data[].totalinteger- Addresses in that country
{
"data": [
{
"name": "US",
"total": 44
},
{
"name": "GB",
"total": 4
}
]
}// 03 · coût et limites
Ce que coûte un appel
Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.
// coût
1email count credit
Facturé quand: Every successful call, including an empty result.
Les erreurs, les réponses 429 et 451, ainsi que la même requête répétée dans votre fenêtre d'utilisation ne coûtent rien.
Comment fonctionnent les crédits// limites de débit
Requêtes par seconde / minute / jour| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
Faites défiler horizontalement pour voir toutes les colonnes
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Limites de débit