হোম / 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 পাঠান। অন্য প্ল্যাটফর্মে ক্রিয়েটরের অ্যাকাউন্টগুলো পাবেন, প্রতিটির সাথে রায়, মোট কনফিডেন্স স্কোর ও তার পেছনের প্রমাণ। নতুন খোঁজে ১০–৪০ সেকেন্ড লাগে; যে ক্রিয়েটর আমাদের কাছে আগে থেকেই আছেন, তাঁদের ফল সঙ্গে সঙ্গে আসে। অন্তত একটি অ্যাকাউন্ট পেলে 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আবশ্যক
POST /batches যে id ফেরত দিয়েছে।

অনুরোধ

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	`—`	আমাদের দিক থেকে খোঁজে সমস্যা হয়েছে। আপনার কিছু চার্জ হয়নি; আবার চেষ্টা করুন।

রেট লিমিট

প্রতি কী-তে নতুন খোঁজ	প্রতি মিনিটে ৫
আগে খোঁজা ক্রিয়েটর	কোনো সীমা নেই; সঙ্গে সঙ্গে উত্তর
প্রতি ব্যাচে প্রোফাইল	৫০০
প্রতি অ্যাকাউন্টে সক্রিয় API কী	১০

সহায়তা

প্রশ্ন বা বাগ? support@youtubetranscript.dev-এ ইমেল করুন।