وثائق API الرسمية

دمج Linkiw
في أدواتك الخاصة.

قم بتوصيل إدارة علاقات العملاء (CRM) الخاصة بك، أو أتمتة إنشاء قائمتك، أو بدء عمليات استخراج واسعة النطاق من خلال REST API القوية لدينا.

احصل على مفتاح API الخاص بي

أداء عالي

متوسط وقت الاستجابة أقل من 200 مللي ثانية.

مصادقة آمنة

المصادقة عبر Bearer Token.

ردود JSON

جميع الردود بتنسيق JSON الموحد.

بيانات محدثة

كشط مباشر لتجاوز قاعدة البيانات.

المبادئ الأساسية

افهم كيفية الاتصال بالخادم ومصادقة طلباتك.

عنوان URL الأساسي

تتم جميع طلبات API على عنوان URL الأساسي الآمن هذا:

https://api.linkiw.app/v1

المصادقة (Bearer)

أضف مفتاح API الخاص بك في رأس تفويض كل طلب:

Authorization: Bearer lw_live_votre_cle_secrete

النقاط النهائية المتاحة

مرجع سريع لجميع مسارات الوصول إلى API العام الخاص بنا.

نقطة النهايةالطريقةالوصفالأرصدة
/v1/meGETعرض الملف الشخصي والحدود ورصيد الائتمانات المتبقي.0
/v1/entreprisesGETالبحث عن الشركات وتصفيتها في قاعدة بيانات Linkiw الحالية.0
/v1/scraping/runPOSTبدء كشط الويب في الوقت الفعلي.1 / شركة مع جهة اتصال
/v1/listsGETاسترداد قوائم التنقيب الخاصة بك وعملائها المحتملين.0

1. GET /v1/entreprises

يبحث عن الشركات في قاعدة بياناتنا الموجودة. هذا الطلب مجاني 100% ولا يستهلك أي رصيد.

معاملات الطلب (Query):

  • query (string): اسم الشركة أو كلمة مفتاحية.
  • wilayas (array): معرّفات الولايات المستهدفة (مثال: ?wilayas=16&wilayas=31).
  • secteurs (array): أسماء قطاعات النشاط المستهدفة.
  • score_min (number): الحد الأدنى لنقطة الجودة (0-100).
  • page (number): رقم الصفحة (افتراضياً: 1).
  • per_page (number): عدد النتائج في الصفحة (افتراضياً: 20).

مثال عن الاستجابة:

{
  "total": 1420,
  "page": 1,
  "pages": 71,
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "nom": "SARL Tech Algérie",
      "wilaya": "Alger",
      "activite": "Développement logiciel",
      "email": "contact@tech-algerie.dz",
      "telephone": "+213 550 00 00 00",
      "score_qualite": 85
    }
  ]
}

2. POST /v1/scraping/run

يطلق استخراجاً في الوقت الحقيقي على الويب والأدلة. مثالي للعثور على معطيات جديدة ليست بعد في قاعدة البيانات.

تنبيه (الأرصدة): يُخصم رصيد واحد من حسابك عن كل شركة فريدة يُعثر عليها بوسيلة اتصال واحدة على الأقل (بريد إلكتروني أو هاتف).

جسم الطلب (JSON):

{
  "secteur": "Bâtiment et travaux publics",
  "wilaya": "Oran",
  "max_results": 50 // اختياري، 20 افتراضياً
}

مثال عن الاستجابة:

{
  "task_id": "scrap_987654321",
  "status": "completed",
  "results_found": 34,
  "credits_used": 28, // 28 فقط كانت لديها وسائل اتصال
  "entreprises": [
    // القائمة الكاملة للشركات التي عُثر عليها
  ]
}

حدود المعدل (Rate Limits)

لضمان استقرار بنيتنا التحتية، تخضع API لحدود وفقًا لخطتك.

خطة فريق المبيعات
150 طلب / دقيقة
خطة مؤسسة (Enterprise)
500 طلب / دقيقة

مستعد لتوصيل أدواتك؟

قم بإنشاء حسابك، واحصل على مفتاح API السري الخاص بك، والوصول إلى قاعدة بيانات B2B.

احصل على مفتاح API الخاص بي