Start / API-Dokumentation

API-Referenz

Social-links-API

Ein Creator-Profil rein, alle Konten raus. Sende einen Instagram-, TikTok-, YouTube- oder X-Profillink und erhalte die Konten des Creators auf den anderen Plattformen, jeweils mit Urteil, Konfidenzwert und den Belegen dahinter.

Basis-URLhttps://sociallinks.dev/v1

Was du tun kannst

Einen Creator suchenEin Profillink rein, die anderen Konten des Creators raus.POST /resolveViele Creator suchenBis zu 500 Profile in die Warteschlange; sie laufen im Hintergrund.POST /batchesEinen Batch als CSV herunterladenEine Zeile pro gesendetem Profil, eine Spalte pro Plattform, dazu Status und berechnete Credits.GET /batches/{id}/exportDein Guthaben prüfenVerbleibende Credits auf dem Konto hinter dem Key.GET /balance

OpenAPI-SpezifikationDer vollständige Vertrag, für Codegeneratoren und KI-Agenten.

Ansehen

Authentifizierung

Erstelle einen Key unter Dashboard → API und sende ihn mit jeder Anfrage als Authorization: Bearer sl_… (oder x-api-key: sl_…). Keys verbrauchen die Credits deines Kontos. Ein Key wird beim Erstellen nur einmal angezeigt; widerrufst du ihn, funktioniert er sofort nicht mehr.

MCP-Server

Starte Suchen aus Claude Code, Cursor, VS Code, Windsurf, Gemini CLI oder jedem MCP-Client. Füge https://sociallinks.dev/mcp als Remote-Server (Streamable HTTP) hinzu und sende deinen API-Schlüssel im Authorization-Header. Die Tools kosten genau so viel wie die REST-Endpunkte.

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

Wohin damit: Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

Tools

lookup_creator
Sucht einen Creator anhand einer Profil-URL; berechnet nur, wenn Konten gefunden werden.
check_balance
Verbleibende Credits des Kontos hinter dem Schlüssel. Kostenlos.
start_batch
Stellt viele Profil-URLs zur Suche im Hintergrund in die Warteschlange.
get_batch
Fortschritt und Zeilen eines Batches.

Abrechnung

1 Credit pro Creator, wenn wir mindestens ein Konto neben dem gesendeten finden. Suchen ohne Treffer und fehlgeschlagene Suchen sind kostenlos. Einen Creator erneut zu suchen, den dein Konto in den letzten 30 Tagen bezahlt hat, ist kostenlos. Die Credits teilst du mit der Website; siehe Preise.

Einen Creator suchen

POST/resolve

Sende eine Instagram-, TikTok-, YouTube- oder X-Profil-URL. Du erhältst die Konten des Creators auf den anderen Plattformen, jeweils mit Urteil, Netto-Konfidenzwert und den Belegen dahinter. Neue Suchen dauern 10–40 Sekunden; Creator, die wir schon kennen, kommen sofort zurück. 1 Credit, wenn mindestens ein Konto gefunden wird; ohne Treffer kostenlos. Der Header X-Credits-Remaining enthält dein Guthaben.

Parameter

urlbody · stringerforderlich
Die Profilseite eines Creators. Beiträge, Reels, Videos und reine @Handles werden mit 400 abgelehnt.

Anfrage

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

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

Einen Creator suchen (GET)

GET/resolve

Identisch mit POST /resolve, für Tools, die nur GET-Anfragen senden können.

Parameter

urlquery · stringerforderlich
Die Profilseite eines Creators, URL-kodiert.

Anfrage

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

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

Viele Creator suchen

POST/batches

Jede Zeile wird nur berechnet, wenn sie Konten findet, und Zeilen, die dein Konto in den letzten 30 Tagen bezahlt hat, sind kostenlos. Zeilen, die keine Profillinks sind, werden übersprungen und nie berechnet. Frage den Batch ab und lade dann die CSV herunter.

Parameter

urlsbody · string[] | stringerforderlich
Bis zu 500 Profil-URLs, als Array oder eine pro Zeile.
namebody · string
Eine Bezeichnung für den Batch.

Anfrage

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

Antwort (201)

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

Einen Batch prüfen

GET/batches/{id}

Frage alle paar Sekunden ab, bis der Status "completed", "partial" oder "failed" ist. Jedes Element hat einen eigenen Status und die gefundenen Konten.

Parameter

idpath · uuiderforderlich
Die id, die POST /batches zurückgegeben hat.

Anfrage

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

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

Einen Batch als CSV herunterladen

GET/batches/{id}/export

Bereit für eine Tabelle oder einen CRM-Import.

Parameter

idpath · uuiderforderlich
Die Batch-id.

Anfrage

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

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

Deine Batches auflisten

GET/batches

Praktisch, um dort weiterzumachen, wo du aufgehört hast.

Parameter

Keine.

Anfrage

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

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

Einen Batch stoppen

POST/batches/{id}/cancel

Laufende Zeilen werden abgeschlossen. Gibt 409 zurück, wenn der Batch schon fertig ist.

Parameter

idpath · uuiderforderlich
Die Batch-id.

Anfrage

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

Antwort (200)

{ "ok": true }

Dein Guthaben prüfen

GET/balance

Dieselben Credits wie auf der Website. Pakete kaufst du unter https://sociallinks.dev/pricing.

Parameter

Keine.

Anfrage

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

Antwort (200)

{ "credits": 742 }

Fehler

Jeder Fehler hat die Form { "error": { "message", "code" } }. Die Nachricht ist lesbar; der Code ist da, wenn du danach verzweigen willst.

Status	Code	Bedeutung
400	`—`	Keine Profil-URL (Beiträge, Reels, Videos und reine @Handles werden abgelehnt) oder kein Body.
401	`invalid_api_key`	Der Key ist unbekannt oder widerrufen.
401	`login_required`	Es wurde kein Key gesendet.
402	`out_of_credits`	Keine Credits mehr. Nichts wurde berechnet; kaufe ein Paket und versuche es erneut.
404	`—`	Kein solcher Batch in diesem Konto.
409	`—`	Der Batch ist bereits abgeschlossen.
429	`—`	Zu viele neue Suchen. Warte die Sekunden aus Retry-After ab oder sende die Liste an /batches.
502	`—`	Die Suche ist auf unserer Seite fehlgeschlagen. Dir wurde nichts berechnet; versuche es erneut.

Rate-Limits

Neue Suchen pro Key	5 pro Minute
Bereits gesuchte Creator	Kein Limit; sofortige Antwort
Profile pro Batch	500
Aktive API-Keys pro Konto	10

Support

Fragen oder ein Fehler? Schreib an support@youtubetranscript.dev.