// post /v1/bulk/similar
Bulk Domain Similar API
اكتشف الشركات المشابهة ونطاقات المنافسين لآلاف الحسابات في مهمة مجمّعة واحدة غير متزامنة.
Domains or company namesحتى 5,000 صف
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/similar", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · الطلب
Similar Domains مجمّع هو طلب HTTPS واحد
أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.
- type
- similar
- list | data | file
- Domains or company names
- launch
- القيمة true تبدأ المهمة فورًا
- webhook_url
- يستقبل حدثًا موقّعًا عند انتهاء المهمة
- rows
- حتى 5,000 لكل مهمة
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/similar", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 02 · الاستجابة
ما يُعاد إليك
JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.
GET
/similardata[].website_urlstring- Each similar company's domain
data[].name, data[].industriesstring | null- Its name and industry
meta.total, meta.total_pagesinteger- Similar companies found, and pages
meta.current, meta.pageSizeinteger- This page and its size
meta.paramsobject- The parameters the search ran with
POST /bulk/similar
201 Created
{
"data": {
"id": 1042
}
}كل صف، كما يعيده GET /similar
200 OK
{
"data": [
{
"website_url": "hooli.com",
"name": "Hooli",
"industries": "internet"
},
{
"website_url": "endframe.com",
"name": "Endframe",
"industries": "computer software"
}
],
"meta": {
"total": 2,
"pageSize": 10,
"current": 1,
"total_pages": 1,
"params": {
"domain": "piedpiper.com",
"page": 1,
"limit": 10
}
}
}// 03 · التكلفة والحدود
تكلفة الاستدعاء
لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.
// التكلفة
1 search credit per domain with at least one similar company.
Charged once, at the first download; later downloads are free
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
أنشئ عملية مجمّعة برفع نطاقات الشركات، ثم شغّل العملية. يعثر API على شركات مشابهة لكل نطاق بشكل غير متزامن بناءً على القطاع والحجم ونموذج العمل.
يمكنك معالجة حتى 5,000 نطاق في كل عملية مجمّعة. يعيد كل نطاق قائمة بالشركات المشابهة.
يحلل API عوامل متعددة منها تصنيف القطاع وحجم الشركة ونموذج العمل والتقنيات المستخدمة والتموضع في السوق لتحديد الشركات المشابهة.
يعيد كل نطاق قائمة بنطاقات الشركات المشابهة مع أسمائها. تُرتّب النتائج حسب الصلة ودرجة التشابه.
من حالات الاستخدام الشائعة التحليل التنافسي وأبحاث السوق وتوسيع TAM والعثور على شركات مشابهة للتنقيب عن العملاء وبناء قوائم حسابات مستهدفة.
يعتمد وقت المعالجة على حجم القائمة وعمليات البحث التي تحتاجها. استعلم عن حالة المهمة أو اضبط Webhook لتُبلَّغ عند انتهائها.
نعم، اضبط رابط webhook لتتلقى إشعارًا عند اكتمال عملية النطاقات المشابهة المجمّعة وجاهزية النتائج للتنزيل.
بعد اكتمال المعالجة، استخدم نقطة نهاية التنزيل للحصول على كل النطاقات المشابهة بصيغة CSV أو JSON لكل نطاق مُدخل.
نعم. من مسارات العمل الشائعة البدء بعملاء معروفين، والعثور على شركات مشابهة بالجملة، ثم تمرير تلك النطاقات إلى البحث بالنطاق أو باحث البريد لاكتشاف جهات الاتصال.
استخدم النطاقات الرسمية للشركات بدل المواقع المصغّرة للمنتجات أو عمليات إعادة التوجيه حسب الدولة. النطاقات الأساسية النظيفة تعطي تقييم تشابه أفضل وتكرارات أقل.