// العمليات المجمّعة
إثراء الشركات بالجملة
حمّل ملف CSV يحتوي على نطاقات الشركات وأثرِها جميعًا ببيانات تفصيلية عن الشركة دفعة واحدة.
- 01pending
POST /v1/bulk/company201 · { "data": { "id": 1042 } } - 02running
launch: trueالتقدّم يُستعلم عنه عبر GET /v1/bulk/company/1042/progress - 03completed
bulk.completedwebhook موقّع يُرسل إلى webhook_url الخاص بك
GET /v1/bulk/company/1042/download?file=fullيُخصم عند أول تنزيل · تنتهي صلاحية المهمة بعد 180 يومًا// 01 · المُدخلات
مُدخلات مهمة Company Enrichment المجمّعة
ارفع ملف CSV بحجم يصل إلى 4 MB في التطبيق، أو أرسل قائمة أو صفوفًا أو ملفًا إلى POST /v1/bulk/company. تُحدَّد الأعمدة من صف العناوين؛ اضبط فهرس الحقل لتختار عمودًا بنفسك.
/bulk/companyالأعمدةdomain_field_index- Domain
company_name_field_index- Company name
/bulk/companyالخياراتinput_type- domain or company; company when the input has a company name column and no domain column
find_phones- true adds phone numbers, at an extra cost
// 02 · api
طلب واحد يبدأ المهمة
أنشئها وشغّلها في استدعاء واحد، ثم تابع تقدّمها أو استقبل حدث bulk.completed موقّعًا. كل صف في النتائج هو ما يعيده GET /companies/find.
curl -X POST "https://api.tomba.io/v1/bulk/company" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Company Enrichment 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/company", {
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": "Company Enrichment 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/company",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Company Enrichment job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"name": "Pied Piper",
"legalName": "Pied Piper, Inc.",
"domain": "piedpiper.com",
"domainAliases": [],
"site": {
"phoneNumbers": [],
"emailAddresses": [
"hello@piedpiper.com"
]
},
"category": {
"sector": "Information Technology",
"industryGroup": "Software & Services",
"industry": "Internet Software & Services",
"subIndustry": "Internet Software & Services",
"sicCode": "73",
"sic4Codes": [
"7372"
],
"naicsCode": "51",
"naics6Codes": [
"511210"
],
"naics6Codes2022": [
"513210"
]
},
"tags": [
"Compression",
"Decentralized internet"
],
"description": "Middle-out compression for files and video.",
"foundedYear": "2014",
"location": "5230 Newell Road, Palo Alto, CA 94303, United States",
"timeZone": "America/Los_Angeles",
"utcOffset": -8,
"geo": {
"streetNumber": "5230",
"streetName": "Newell Road",
"subPremise": null,
"streetAddress": "5230 Newell Road",
"city": "Palo Alto",
"postalCode": "94303",
"state": "California",
"stateCode": "CA",
"country": "United States",
"countryCode": "US",
"lat": 37.4419,
"lng": -122.143
},
"logo": "https://logo.tomba.io/piedpiper.com",
"facebook": {
"handle": null,
"likes": null
},
"linkedin": {
"handle": "company/pied-piper"
},
"twitter": {
"handle": null,
"id": null,
"bio": null,
"followers": null,
"following": null,
"location": null,
"site": null,
"avatar": null
},
"whois": {
"registrar_name": null,
"created_date": null,
"referral_url": null
},
"emailProvider": "Google",
"type": "private",
"ticker": null,
"identifiers": {
"usEIN": null
},
"metrics": {
"alexaUsRank": null,
"alexaGlobalRank": null,
"trafficRank": null,
"employees": "11-50",
"marketCap": null,
"raised": null,
"annualRevenue": null,
"estimatedAnnualRevenue": null,
"fiscalYearEnd": null
},
"indexedAt": "2025-01-15T10:32:00+01:00",
"tech": [
"google_apps",
"intercom"
],
"techCategories": [
"email_hosting_service",
"live_chat"
],
"parent": {
"domain": null
},
"ultimateParent": {
"domain": null
}
},
"meta": {
"domain": "piedpiper.com"
}
}// 03 · التكلفة والحدود
تكلفة المهمة
لا يُخصم شيء عند إنشاء المهمة أو تشغيلها. تُخصم تكلفتها مرة واحدة، عند أول تنزيل لنتائجها.
// الفوترة لكل صف
1 search credit per company found. Plus 1 per company with phone data.
فوترة المهام المجمّعة في الوثائق- الصفوف: حتى 25,000 لكل مهمة
- 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)
// 04 · استخدمه في أي مكان
شغّل مهام Company Enrichment من التطبيق أو من كودك
المهمة نفسها والأرصدة نفسها: ارفع ملفًا في التطبيق، أو استدعِ API، أو اعمل من جدول بيانات أو أداة بدون كود.
- REST APIJSON عبر HTTPS، و13 SDK، وwebhooks موقّعة.
GET /v1/companies/find - CSV مجمّعارفع قائمة في التطبيق أو أرسلها عبر POST إلى /bulk؛ ونزّلها عند الانتهاء.
POST /v1/bulk/{type} - Zapier وMake وn8nإجراءات بدون كود للبحث والتحقق والإثراء.
Zapier · Make · n8n · Pipedream
مرجع الطلب الكامل: /api/bulk/company-enrichment
// العملاء
فرق تشغّل مهام Company Enrichment
We rely on Tomba to efficiently locate email addresses of key professionals. This allows us to connect directly and build meaningful relationships.
Josh LeierCreative Director, IceHound MarketingTomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
Nicholas RizzoSenior Digital Manager, Vizme