Hem / API-dokumentation

API-referens

Social links-API

En kreatörsprofil in, alla konton ut. Skicka en profillänk från Instagram, TikTok, YouTube eller X och få kreatörens konton på de andra plattformarna, vart och ett med bedömning, konfidenspoäng och bevisen bakom.

Bas-URLhttps://sociallinks.dev/v1

Det här kan du göra

Sök upp en kreatörEn profillänk in, kreatörens andra konton ut.POST /resolveSök upp många kreatörerKöa upp till 500 profiler; de körs i bakgrunden.POST /batchesLadda ner en batch som CSVEn rad per skickad profil, en kolumn per plattform, plus status och debiterade krediter.GET /batches/{id}/exportKontrollera ditt saldoKrediter kvar på kontot bakom nyckeln.GET /balance

OpenAPI-specifikationHela kontraktet, för kodgeneratorer och AI-agenter.

Visa

Autentisering

Skapa en nyckel under Kontrollpanel → API och skicka den med varje anrop som Authorization: Bearer sl_… (eller x-api-key: sl_…). Nycklar använder ditt kontos krediter. En nyckel visas en gång när du skapar den; återkallar du den slutar den fungera direkt.

MCP-server

Kör sökningar från Claude Code, Cursor, VS Code, Windsurf, Gemini CLI eller valfri MCP-klient. Lägg till https://sociallinks.dev/mcp som fjärrserver (Streamable HTTP) och skicka din API-nyckel i headern Authorization. Verktygen kostar exakt som REST-endpoints.

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

Var den ska ligga: Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

Verktyg

lookup_creator
Söker en kreatör utifrån en profil-URL; debiteras bara när konton hittas.
check_balance
Krediter kvar på kontot bakom nyckeln. Gratis.
start_batch
Köar många profil-URL:er att söka i bakgrunden.
get_batch
Förlopp och rader för en batch.

Debitering

1 kredit per kreatör när vi hittar minst ett konto utöver det du skickade. Sökningar som inte hittar något, och misslyckade sökningar, är gratis. Att söka igen på en kreatör som ditt konto betalat för de senaste 30 dagarna är gratis. Krediterna delas med webbplatsen; se priser.

Sök upp en kreatör

POST/resolve

Skicka en profil-URL från Instagram, TikTok, YouTube eller X. Du får kreatörens konton på de andra plattformarna, vart och ett med bedömning, nettokonfidenspoäng och bevisen bakom. Nya sökningar tar 10–40 sekunder; kreatörer vi redan har kommer tillbaka direkt. 1 kredit när minst ett konto hittas; hittas inget är det gratis. Headern X-Credits-Remaining innehåller ditt saldo.

Parametrar

urlbody · stringobligatorisk
En kreatörs profilsida. Inlägg, reels, videor och lösa @handtag avvisas med 400.

Anrop

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"}'

Svar (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
}

Sök upp en kreatör (GET)

GET/resolve

Identisk med POST /resolve, för verktyg som bara kan skicka GET-anrop.

Parametrar

urlquery · stringobligatorisk
En kreatörs profilsida, URL-kodad.

Anrop

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

Svar (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
}

Sök upp många kreatörer

POST/batches

Varje rad debiteras bara om den hittar konton, och rader som ditt konto betalat för de senaste 30 dagarna är gratis. Rader som inte är profillänkar hoppas över och debiteras aldrig. Fråga batchen och ladda sedan ner CSV-filen.

Parametrar

urlsbody · string[] | stringobligatorisk
Upp till 500 profil-URL:er, som array eller en per rad.
namebody · string
En etikett för batchen.

Anrop

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"]}'

Svar (201)

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

Kontrollera en batch

GET/batches/{id}

Fråga med några sekunders mellanrum tills status är "completed", "partial" eller "failed". Varje post har sin egen status och de konton som hittades.

Parametrar

idpath · uuidobligatorisk
Det id som POST /batches returnerade.

Anrop

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

Svar (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"]
      }
    }
  ]
}

Ladda ner en batch som CSV

GET/batches/{id}/export

Redo för ett kalkylark eller en CRM-import.

Parametrar

idpath · uuidobligatorisk
Batchens id.

Anrop

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

Svar (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,

Lista dina batcher

GET/batches

Praktiskt för att fortsätta där du slutade.

Parametrar

Inga.

Anrop

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

Svar (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"
    }
  ]
}

Stoppa en batch

POST/batches/{id}/cancel

Rader som redan körs slutförs. Returnerar 409 om batchen redan är klar.

Parametrar

idpath · uuidobligatorisk
Batchens id.

Anrop

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

Svar (200)

{ "ok": true }

Kontrollera ditt saldo

GET/balance

Samma krediter som webbplatsen använder. Köp paket på https://sociallinks.dev/pricing.

Parametrar

Inga.

Anrop

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

Svar (200)

{ "credits": 742 }

Fel

Varje fel har formen { "error": { "message", "code" } }. Meddelandet är läsbart; koden finns där för när du vill förgrena på den.

Status	Kod	Betydelse
400	`—`	Inte en profil-URL (inlägg, reels, videor och lösa @handtag avvisas), eller ingen body.
401	`invalid_api_key`	Nyckeln är okänd eller återkallad.
401	`login_required`	Ingen nyckel skickades.
402	`out_of_credits`	Inga krediter kvar. Inget debiterades; köp ett paket och försök igen.
404	`—`	Ingen sådan batch på det här kontot.
409	`—`	Batchen är redan klar.
429	`—`	För många nya sökningar. Vänta det antal sekunder som Retry-After anger, eller skicka listan till /batches.
502	`—`	Sökningen gick fel hos oss. Du debiterades inte; försök igen.

Hastighetsgränser

Nya sökningar per nyckel	5 per minut
Redan sökta kreatörer	Ingen gräns; svar direkt
Profiler per batch	500
Aktiva API-nycklar per konto	10

Support

Frågor eller en bugg? Mejla support@youtubetranscript.dev.