// post /v1/bulk/linkedin
Bulk LinkedIn Finder API
حوّل روابط ملفات LinkedIn إلى بيانات اتصال موثّقة على نطاق واسع بعملية API مجمّعة واحدة غير متزامنة.
LinkedIn profile URLsحتى 20,000 صف
curl -X POST "https://api.tomba.io/v1/bulk/linkedin" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"LinkedIn Finder job","list":"https://www.linkedin.com/in/richard-hendricks","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/linkedin", {
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": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"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/linkedin",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · الطلب
LinkedIn Finder مجمّع هو طلب HTTPS واحد
أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.
- type
- list | data | file
- LinkedIn profile URLs
- launch
- القيمة true تبدأ المهمة فورًا
- webhook_url
- يستقبل حدثًا موقّعًا عند انتهاء المهمة
- rows
- حتى 20,000 لكل مهمة
curl -X POST "https://api.tomba.io/v1/bulk/linkedin" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"LinkedIn Finder job","list":"https://www.linkedin.com/in/richard-hendricks","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/linkedin", {
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": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"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/linkedin",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 02 · الاستجابة
ما يُعاد إليك
JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.
GET
/linkedindataobject | array- The person; an array of every match when you send full=true
data.emailstring | null- The address, or null when none is found
data.scoreinteger- Confidence from 0 to 100
data.verification.statusstring | null- valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null- Name, job title and team
data.typestring | null- personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null- Public profiles
data.sources[]array | null- Up to 20 public pages where the address was found, with dates
data.accept_allboolean | null- The domain accepts mail for any address (catch-all)
data.phone_numberboolean- Tomba holds a phone number for the person
data.phone_data[]array- The numbers, when you send enrich_mobile (each as in Phone Finder)
POST /bulk/linkedin
201 Created
{
"data": {
"id": 1042
}
}كل صف، كما يعيده GET /linkedin
200 OK
{
"data": {
"email": "richard@piedpiper.com",
"first_name": "Richard",
"last_name": "Hendricks",
"full_name": "Richard Hendricks",
"website_url": "piedpiper.com",
"company": "Pied Piper",
"pattern": "{first}",
"department": "executive",
"type": "personal",
"position": "CEO",
"country": "US",
"gender": "male",
"twitter": null,
"linkedin": "https://www.linkedin.com/in/richard-hendricks",
"score": 100,
"accept_all": false,
"phone_number": true,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
],
"phone_data": []
}
}// 03 · التكلفة والحدود
تكلفة الاستدعاء
لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.
// التكلفة
1 search credit per row with a result. Plus 5 per row with phone data.
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)
أنشئ عملية مجمّعة برفع روابط ملفات LinkedIn، ثم شغّل العملية. يعثر API على عناوين البريد المهنية لكل ملف بشكل غير متزامن.
يمكنك معالجة حتى 10,000 رابط ملف LinkedIn في كل عملية مجمّعة. لمجموعات البيانات الأكبر، أنشئ عدة عمليات مجمّعة.
يدعم API روابط ملفات LinkedIn القياسية (linkedin.com/in/username). تُقبل روابط http وhttps مع الشرطة المائلة في النهاية أو دونها.
تتضمن كل نتيجة عنوان البريد والاسم الكامل والشركة والمنصب ورابط LinkedIn ورقم الهاتف (إن توفر) ودرجة الثقة وحالة التحقق.
يعتمد وقت المعالجة على حجم القائمة وعمليات البحث التي تحتاجها. استعلم عن حالة المهمة أو اضبط Webhook لتُبلَّغ عند انتهائها.
كل ملف LinkedIn يعيد بريدًا يُحتسب طلبًا واحدًا. الملفات التي لا يُعثر لها على بريد لا تُخصم من حصتك.
يستخدم Tomba معلومات متاحة للعامة ولا يجمع البيانات من LinkedIn مباشرة. يُعثر على عناوين البريد من قاعدة بياناتنا الخاصة لجهات الاتصال المهنية.
نعم، اضبط رابط webhook لتتلقى إشعارًا عند اكتمال عملية البحث المجمّع في LinkedIn وجاهزية النتائج للتنزيل.
نعم. تشغّل الفرق غالبًا LinkedIn Finder أولًا، ثم تمرر العناوين المطابقة إلى Bulk Email Enrichment وBulk Email Verifier لمزيد من السياق والتحقق.
استخدم روابط LinkedIn الأساسية الكاملة للملفات، واحذف التكرارات، وتجنّب صفحات الشركات وروابط المنشورات لتحقيق أكبر عدد من المطابقات الناجحة.