// get /v1/location
API الموقع الجغرافي
احصل على التوزيع الجغرافي للموظفين في أي نطاق شركة. يعيد تقسيماً حسب البلد لمواقع الموظفين.
// وحدة تحكم api
- [0].name
- US
- [0].total
- 44
// 01 · الطلب
Location هو طلب HTTPS واحد
أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.
/locationالمعاملdomainمطلوب- Company domain
curl "https://api.tomba.io/v1/location?domain=piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const res = await fetch("https://api.tomba.io/v1/location?domain=piedpiper.com", {
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?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 · الاستجابة
ما يُعاد إليك
JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.
/locationالحقلdata[].namestring- Country code
data[].totalinteger- Addresses in that country
{
"data": [
{
"name": "US",
"total": 44
},
{
"name": "GB",
"total": 4
}
]
}// 03 · التكلفة والحدود
تكلفة الاستدعاء
لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.
// التكلفة
1email count credit
يُخصم عند: Every successful call, including an empty result.
الأخطاء واستجابات 429 و451 وتكرار الطلب نفسه ضمن نافذة استخدامك لا تكلّف شيئًا.
كيف تعمل الأرصدة// حدود المعدّل
الطلبات في الثانية / الدقيقة / اليوم| 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 |
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. حدود المعدّل