होम / 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
बहुत से प्रोफ़ाइल URL को बैकग्राउंड में खोजने के लिए कतार में डालता है।
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 तक प्रोफ़ाइल URL, ऐरे के रूप में या हर लाइन में एक।
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 पर ईमेल करें।