હોમ / 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ફરજિયાત
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	`—`	અમારી તરફથી શોધમાં ભૂલ થઈ. તમને કંઈ ચાર્જ થયું નથી; ફરી પ્રયાસ કરો.

રેટ મર્યાદા

દરેક કી પર નવી શોધ	દર મિનિટે 5
પહેલેથી શોધાયેલા ક્રિએટર	કોઈ મર્યાદા નહીં; તરત જવાબ
દરેક બૅચમાં પ્રોફાઇલ	500
દરેક એકાઉન્ટ પર સક્રિય API કી	10

સહાય

કોઈ પ્રશ્ન કે બગ? support@youtubetranscript.dev પર ઇમેઇલ કરો.