ہوم / API دستاویزات

API حوالہ

Social links API

ایک کریئیٹر پروفائل دیں، سارے اکاؤنٹس پائیں۔ Instagram، TikTok، YouTube یا X کا پروفائل لنک بھیجیں اور دوسرے پلیٹ فارمز پر کریئیٹر کے اکاؤنٹس حاصل کریں، ہر ایک کے ساتھ فیصلہ، اعتماد کا اسکور اور اس کے پیچھے کے ثبوت۔

بنیادی URLhttps://sociallinks.dev/v1

آپ کیا کر سکتے ہیں

کسی کریئیٹر کو تلاش کریںایک پروفائل لنک دیں، کریئیٹر کے باقی اکاؤنٹس پائیں۔POST /resolveکئی کریئیٹرز تلاش کریں500 تک پروفائلز قطار میں ڈالیں؛ یہ پس منظر میں چلتی ہیں۔POST /batchesبیچ کو CSV میں ڈاؤن لوڈ کریںبھیجی گئی ہر پروفائل کے لیے ایک قطار، ہر پلیٹ فارم کے لیے ایک کالم، ساتھ میں اسٹیٹس اور چارج شدہ کریڈٹ۔GET /batches/{id}/exportاپنا بیلنس دیکھیںکلید سے منسلک اکاؤنٹ میں باقی کریڈٹ۔GET /balance

OpenAPI تفصیلاتکوڈ جنریٹرز اور AI ایجنٹس کے لیے مکمل معاہدہ۔

دیکھیں

تصدیق

ڈیش بورڈ ← 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 key 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
پروفائل URL سے ایک کریئیٹر تلاش کرتا ہے؛ اکاؤنٹ ملنے پر ہی فیس۔
check_balance
key والے اکاؤنٹ میں باقی کریڈٹس۔ مفت۔
start_batch
بہت سے پروفائل URLs کو پس منظر میں تلاش کے لیے قطار میں ڈالتا ہے۔
get_batch
کسی بیچ کی پیش رفت اور قطاریں۔

بلنگ

جب ہمیں آپ کے بھیجے ہوئے اکاؤنٹ کے علاوہ کم از کم ایک اکاؤنٹ ملتا ہے تو ہر کریئیٹر پر 1 کریڈٹ۔ جن تلاشوں میں کچھ نہیں ملتا اور جو ناکام ہوتی ہیں، وہ مفت ہیں۔ جس کریئیٹر کے لیے آپ کے اکاؤنٹ نے پچھلے 30 دنوں میں ادائیگی کی ہو، اسے دوبارہ تلاش کرنا مفت ہے۔ کریڈٹ ویب سائٹ کے ساتھ مشترک ہیں؛ قیمتیں دیکھیں۔

کسی کریئیٹر کو تلاش کریں

POST/resolve

Instagram، TikTok، YouTube یا X کا ایک پروفائل URL بھیجیں۔ آپ کو دوسرے پلیٹ فارمز پر کریئیٹر کے اکاؤنٹس ملیں گے، ہر ایک کے ساتھ فیصلہ، مجموعی اعتماد کا اسکور اور اس کے پیچھے کے ثبوت۔ نئی تلاش میں 10–40 سیکنڈ لگتے ہیں؛ جو کریئیٹرز ہمارے پاس پہلے سے ہیں وہ فوراً واپس آتے ہیں۔ کم از کم ایک اکاؤنٹ ملنے پر 1 کریڈٹ؛ کچھ نہ ملے تو مفت۔ X-Credits-Remaining ہیڈر میں آپ کا بیلنس ہوتا ہے۔

پیرامیٹرز

urlbody · stringلازمی
کسی کریئیٹر کا پروفائل صفحہ۔ پوسٹس، ریلز، ویڈیوز اور صرف @ہینڈل 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 تک پروفائل URLs، ایرے کی صورت میں یا ہر سطر میں ایک۔
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}

ہر چند سیکنڈ بعد چیک کرتے رہیں جب تک status "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لازمی
بیچ کی id۔

درخواست

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لازمی
بیچ کی id۔

درخواست

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	`—`	یہ پروفائل URL نہیں ہے (پوسٹس، ریلز، ویڈیوز اور صرف @ہینڈل مسترد کیے جاتے ہیں)، یا باڈی موجود نہیں۔
401	`invalid_api_key`	کلید نامعلوم ہے یا منسوخ ہو چکی ہے۔
401	`login_required`	کوئی کلید نہیں بھیجی گئی۔
402	`out_of_credits`	کریڈٹ ختم ہو گئے۔ کچھ بھی چارج نہیں ہوا؛ پیک خریدیں اور دوبارہ کوشش کریں۔
404	`—`	اس اکاؤنٹ میں ایسا کوئی بیچ نہیں ہے۔
409	`—`	بیچ پہلے ہی مکمل ہو چکا ہے۔
429	`—`	بہت زیادہ نئی تلاشیں۔ Retry-After میں دیے گئے سیکنڈ انتظار کریں، یا فہرست /batches پر بھیجیں۔
502	`—`	ہماری طرف سے تلاش میں خرابی ہوئی۔ آپ سے کچھ چارج نہیں ہوا؛ دوبارہ کوشش کریں۔

شرح کی حدیں

ہر کلید پر نئی تلاشیں	فی منٹ 5
پہلے سے تلاش شدہ کریئیٹرز	کوئی حد نہیں؛ فوری جواب
ہر بیچ میں پروفائلز	500
ہر اکاؤنٹ پر فعال API کلیدیں	10

مدد

کوئی سوال یا بگ؟ support@youtubetranscript.dev پر ای میل کریں۔