// المهام المجمّعة
عالج الآلاف من العناوين البريدية دفعة واحدة
حمّل ملفات CSV للبحث عن عناوين البريد الإلكتروني والتحقق منها وإثرائها بالجملة. مثالي لفرق المبيعات والمسوّقين وفرق البيانات.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueالتقدّم يُستعلم عنه عبر GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedwebhook موقّع يُرسل إلى webhook_url الخاص بك
GET /v1/bulk/finder/1042/download?file=fullيُخصم عند أول تنزيل · تنتهي صلاحية المهمة بعد 180 يومًا// 01 · أنواع المهام المجمّعة
نموذج مهمة واحد لكل قائمة
كل نوع من المهام المجمّعة يشغّل نقطة نهاية واحدة من Tomba على قائمة، بخطوات الإنشاء والتشغيل والمتابعة والتنزيل نفسها.
| نوع المهمة المجمّعة | المُدخلات | API | الحد الأقصى للصفوف | |
|---|---|---|---|---|
| Domain Search مجمّع | Domains or company names | POST/bulk/search | 25,000 | |
| Similar Domains مجمّع | Domains or company names | POST/bulk/similar | 5,000 | |
| Company Enrichment مجمّع | Domains or company names | POST/bulk/company | 25,000 | |
| Email Finder مجمّع | Names, with a domain or company name | POST/bulk/finder | 10,000 | |
| Email Enrichment مجمّع | Email addresses | POST/bulk/enrich | 20,000 | |
| LinkedIn Finder مجمّع | LinkedIn profile URLs | POST/bulk/linkedin | 20,000 | |
| Author Finder مجمّع | Article URLs | POST/bulk/author | 5,000 | |
| Email Verifier مجمّع | Email addresses | POST/bulk/verifier | 20,000 | |
| Phone Finder مجمّع | Email addresses, LinkedIn URLs or domains | POST/bulk/phone-finder | 10,000 | |
| Phone Validator مجمّع | Phone numbers, with an optional country | POST/bulk/phone-validator | 10,000 |
مرّر أفقيًا لرؤية كل الأعمدة
// 02 · دورة الحياة
كيف تعمل المهمة المجمّعة
الخطوات الأربع نفسها في التطبيق وعبر API.
- 01
الإنشاء
أرسل عبر POST قائمة أو صفوفًا أو ملف CSV بحجم يصل إلى 4 MB إلى /v1/bulk/{type}، أو ارفع الملف في التطبيق.
- 02
التشغيل
اضبط launch: true، أو شغّلها لاحقًا. تتحقق Tomba من امتلاكك الأرصدة التي تحتاجها المهمة.
- 03
المتابعة
استعلم عن تقدّمها، أو استقبل حدث bulk.completed موقّعًا على webhook_url الخاص بك.
- 04
التنزيل
احصل على النتائج بصيغة CSV. تُخصم تكلفة المهمة مرة واحدة، عند أول تنزيل، وتنتهي صلاحيتها بعد 180 يومًا.
// 03 · الحدود والفوترة
ما يجب التخطيط له
لا تخضع المهام المجمّعة لحدود معدّل الخطة؛ فلها حدودها الخاصة لكل مساحة عمل.
- 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)
- Charged once, at the first download; later downloads are free
- المهام المجمّعة في الوثائق