sociallinks.dev

API

احصل على مفتاح API
الأسعارAPIبحث جماعيتسجيل الدخولاحصل على مفتاح API

الرئيسية / توثيق واجهة البرمجة

V1
مفاتيح API

مرجع API

واجهة Social links

ملف شخصي واحد لصانع محتوى، وكل حساباته. أرسل رابط ملف شخصي على Instagram أو TikTok أو YouTube أو X واحصل على حسابات صانع المحتوى في المنصات الأخرى، لكل منها حكم ودرجة ثقة والأدلة التي تدعمها.

عنوان URL الأساسيhttps://sociallinks.dev/v1

ما يمكنك فعله

البحث عن صانع محتوىرابط ملف شخصي واحد، وحسابات صانع المحتوى الأخرى.POST /resolveالبحث عن عدة صناع محتوىضع حتى 500 ملفاً شخصياً في قائمة الانتظار؛ وتُعالج في الخلفية.POST /batchesتنزيل دفعة بصيغة CSVصف لكل ملف شخصي أُرسل، وعمود لكل منصة، إضافة إلى الحالة والأرصدة المخصومة.GET /batches/{id}/exportالتحقق من رصيدكالأرصدة المتبقية في الحساب المرتبط بالمفتاح.GET /balance
مواصفة OpenAPIالعقد الكامل، لمولدات الشيفرة ووكلاء الذكاء الاصطناعي.
عرض

المصادقة

أنشئ مفتاحاً من لوحة التحكم ← API وأرسله مع كل طلب بصيغة Authorization: Bearer sl_… (أو x-api-key: sl_…). تستهلك المفاتيح أرصدة حسابك. يظهر المفتاح مرة واحدة عند إنشائه؛ وإذا ألغيته يتوقف عن العمل فوراً.

خادم MCP

ابحث من Claude Code وCursor وVS Code وWindsurf وGemini CLI أو أي عميل MCP. أضف https://sociallinks.dev/mcp كخادم بعيد (Streamable HTTP) وأرسل مفتاح API في ترويسة Authorization. تُحتسب الأدوات تمامًا مثل نقاط REST.

claude mcp add --transport http sociallinks https://sociallinks.dev/mcp --header "Authorization: Bearer sl_your_key"

أين يوضع: Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

الأدوات

  • lookup_creator

    يبحث عن صانع محتوى من رابط ملف شخصي؛ لا يُخصم الرصيد إلا إذا وُجدت حسابات.

  • check_balance

    الرصيد المتبقي في الحساب المرتبط بالمفتاح. مجاني.

  • start_batch

    يضع روابط ملفات كثيرة في طابور للبحث في الخلفية.

  • get_batch

    تقدّم الدفعة وصفوفها.

الفوترة

1 رصيد لكل صانع محتوى عندما نجد حساباً واحداً على الأقل غير الذي أرسلته. عمليات البحث التي لا تجد شيئاً والتي تفشل مجانية. البحث مجدداً عن صانع محتوى دفع حسابك ثمنه خلال آخر 30 يوماً مجاني. الأرصدة مشتركة مع الموقع؛ راجع الأسعار.

البحث عن صانع محتوى

POST/resolve

أرسل رابط ملف شخصي واحد على Instagram أو TikTok أو YouTube أو X. ستحصل على حسابات صانع المحتوى في المنصات الأخرى، لكل منها حكم ودرجة ثقة صافية والأدلة التي تدعمها. يستغرق البحث الجديد من 10 إلى 40 ثانية؛ أما صناع المحتوى الموجودون لدينا فتعود نتائجهم فوراً. 1 رصيد عند العثور على حساب واحد على الأقل؛ وإن لم نجد شيئاً فهو مجاني. يحمل الترويسة X-Credits-Remaining رصيدك.

المعاملات

  • urlbody · stringمطلوب

    صفحة الملف الشخصي لصانع المحتوى. تُرفض المنشورات ومقاطع Reels والفيديوهات وأسماء @ المجردة بالرمز 400.

الطلب

curl -X POST "https://sociallinks.dev/v1/resolve" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/mkbhd"}'

الاستجابة (200)

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

البحث عن صانع محتوى (GET)

GET/resolve

مطابق لـ POST /resolve، للأدوات التي لا ترسل إلا طلبات GET.

المعاملات

  • urlquery · stringمطلوب

    صفحة الملف الشخصي لصانع المحتوى، بترميز URL.

الطلب

curl "https://sociallinks.dev/v1/resolve?url=https%3A%2F%2Fwww.instagram.com%2Fmkbhd" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

الاستجابة (200)

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

البحث عن عدة صناع محتوى

POST/batches

لا يُحتسب أي صف إلا إذا وجد حسابات، والصفوف التي دفع حسابك ثمنها خلال آخر 30 يوماً مجانية. تُتخطى الصفوف التي ليست روابط ملفات شخصية ولا تُحتسب أبداً. تابع حالة الدفعة، ثم نزّل ملف CSV.

المعاملات

  • urlsbody · string[] | stringمطلوب

    حتى 500 رابط ملف شخصي، كمصفوفة أو رابط في كل سطر.

  • namebody · string

    اسم للدفعة.

الطلب

curl -X POST "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Q4 shortlist","urls":["https://www.tiktok.com/@zachking","https://www.youtube.com/@mkbhd"]}'

الاستجابة (201)

{
  "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
  "rows": 2,
  "invalid": 0,
  "duplicates": 0
}

التحقق من دفعة

GET/batches/{id}

تحقق كل بضع ثوانٍ حتى تصبح الحالة "completed" أو "partial" أو "failed". لكل عنصر حالته الخاصة والحسابات التي عُثر عليها.

المعاملات

  • idpath · uuidمطلوب

    المعرّف id الذي أعاده POST /batches.

الطلب

curl "https://sociallinks.dev/v1/batches/$BATCH_ID" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

الاستجابة (200)

{
  "batch": {
    "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
    "name": "Q4 shortlist",
    "status": "completed",
    "total": 2,
    "succeeded": 2,
    "empty": 0,
    "failed": 0,
    "skipped": 0,
    "charged": 2,
    "created_at": "2026-10-19T09:30:00Z"
  },
  "items": [
    {
      "position": 0,
      "input": { "url": "https://www.tiktok.com/@zachking" },
      "status": "succeeded",
      "charged": 1,
      "result": {
        "name": "Zach King",
        "profiles": [{ "platform": "youtube", "handle": "ZachKing", "url": "https://www.youtube.com/@ZachKing", "verdict": "confirmed" }],
        "notFound": ["linkedin"]
      }
    }
  ]
}

تنزيل دفعة بصيغة CSV

GET/batches/{id}/export

جاهز لجدول بيانات أو للاستيراد في نظام CRM.

المعاملات

  • idpath · uuidمطلوب

    معرّف الدفعة.

الطلب

curl "https://sociallinks.dev/v1/batches/$BATCH_ID/export" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" -o results.csv

الاستجابة (200)

row,input,status,credits,creator,verified_creator,instagram,youtube,tiktok,x,twitch,facebook,linkedin,nothing_found_on,error
1,https://www.tiktok.com/@zachking,succeeded,1,Zach King,no,https://www.instagram.com/zachking,https://www.youtube.com/@ZachKing,https://www.tiktok.com/@zachking,https://x.com/zachking,,https://www.facebook.com/zachking,,linkedin,

عرض دفعاتك

GET/batches

مفيد للمتابعة من حيث توقفت.

المعاملات

لا شيء.

الطلب

curl "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

الاستجابة (200)

{
  "batches": [
    {
      "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
      "name": "Q4 shortlist",
      "status": "completed",
      "total": 2,
      "succeeded": 2,
      "empty": 0,
      "failed": 0,
      "skipped": 0,
      "charged": 2,
      "created_at": "2026-10-19T09:30:00Z"
    }
  ]
}

إيقاف دفعة

POST/batches/{id}/cancel

تكتمل الصفوف قيد التشغيل. يعيد 409 إذا كانت الدفعة قد انتهت.

المعاملات

  • idpath · uuidمطلوب

    معرّف الدفعة.

الطلب

curl -X POST "https://sociallinks.dev/v1/batches/$BATCH_ID/cancel" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

الاستجابة (200)

{ "ok": true }

التحقق من رصيدك

GET/balance

الأرصدة نفسها التي يستخدمها الموقع. اشترِ الحزم من https://sociallinks.dev/pricing.

المعاملات

لا شيء.

الطلب

curl "https://sociallinks.dev/v1/balance" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

الاستجابة (200)

{ "credits": 742 }

الأخطاء

كل خطأ يأتي بالشكل { "error": { "message", "code" } }. الرسالة قابلة للقراءة، والرمز موجود عندما تريد التفرع بحسبه.

الحالةالرمزالمعنى
400—ليس رابط ملف شخصي (تُرفض المنشورات ومقاطع Reels والفيديوهات وأسماء @ المجردة)، أو لا يوجد نص للطلب.
401invalid_api_keyالمفتاح غير معروف أو مُلغى.
401login_requiredلم يُرسل أي مفتاح.
402out_of_creditsلا توجد أرصدة. لم يُخصم شيء؛ اشترِ حزمة وأعد المحاولة.
404—لا توجد دفعة كهذه في هذا الحساب.
409—انتهت الدفعة بالفعل.
429—عدد كبير جداً من عمليات البحث الجديدة. انتظر عدد الثواني في Retry-After، أو أرسل القائمة إلى /batches.
502—تعطل البحث من جهتنا. لم يُخصم منك شيء؛ أعد المحاولة.

حدود المعدل

عمليات بحث جديدة لكل مفتاح5 في الدقيقة
صناع محتوى بُحث عنهم سابقاًبلا حد؛ رد فوري
ملفات شخصية لكل دفعة500
مفاتيح API نشطة لكل حساب10

الدعم

لديك سؤال أو وجدت خطأ؟ راسلنا على support@youtubetranscript.dev.