Accueil / Documentation de l'API

Référence de l'API

API Social links

Un profil de créateur en entrée, tous ses comptes en sortie. Envoyez un lien de profil Instagram, TikTok, YouTube ou X et recevez les comptes du créateur sur les autres plateformes, chacun avec un verdict, un score de confiance et les preuves qui l'appuient.

URL de basehttps://sociallinks.dev/v1

Ce que vous pouvez faire

Rechercher un créateurUn lien de profil en entrée, les autres comptes du créateur en sortie.POST /resolveRechercher plusieurs créateursMettez jusqu'à 500 profils en file ; ils sont traités en arrière-plan.POST /batchesTélécharger un lot en CSVUne ligne par profil envoyé, une colonne par plateforme, plus le statut et les crédits facturés.GET /batches/{id}/exportConsulter votre soldeCrédits restants sur le compte de la clé.GET /balance

Spécification OpenAPILe contrat complet, pour les générateurs de code et les agents IA.

Voir

Authentification

Créez une clé dans Tableau de bord → API et envoyez-la avec chaque requête sous la forme Authorization: Bearer sl_… (ou x-api-key: sl_…). Les clés consomment les crédits de votre compte. Une clé n'est affichée qu'une fois, à sa création ; révoquée, elle cesse aussitôt de fonctionner.

Serveur MCP

Lancez des recherches depuis Claude Code, Cursor, VS Code, Windsurf, Gemini CLI ou tout client MCP. Ajoutez https://sociallinks.dev/mcp comme serveur distant (Streamable HTTP) et envoyez votre clé API dans l’en-tête Authorization. Les outils sont facturés exactement comme les endpoints REST.

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

Où le mettre : Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

Outils

lookup_creator
Recherche un créateur à partir de l’URL d’un profil ; facturé seulement si des comptes sont trouvés.
check_balance
Crédits restants sur le compte de la clé. Gratuit.
start_batch
Met en file de nombreuses URL de profils à rechercher en arrière-plan.
get_batch
Avancement et lignes d’un lot.

Facturation

1 crédit par créateur lorsque nous trouvons au moins un compte en plus de celui que vous avez envoyé. Les recherches qui ne trouvent rien, et celles qui échouent, sont gratuites. Rechercher à nouveau un créateur payé par votre compte au cours des 30 derniers jours est gratuit. Les crédits sont partagés avec le site ; voir les tarifs.

Rechercher un créateur

POST/resolve

Envoyez une URL de profil Instagram, TikTok, YouTube ou X. Vous recevez les comptes du créateur sur les autres plateformes, chacun avec un verdict, un score de confiance net et les preuves qui l'appuient. Une nouvelle recherche prend 10 à 40 secondes ; les créateurs déjà connus reviennent instantanément. 1 crédit lorsqu'au moins un compte est trouvé ; si rien n'est trouvé, c'est gratuit. L'en-tête X-Credits-Remaining indique votre solde.

Paramètres

urlbody · stringobligatoire
La page de profil d'un créateur. Les publications, reels, vidéos et @pseudos seuls sont refusés avec un 400.

Requête

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

Réponse (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
}

Rechercher un créateur (GET)

GET/resolve

Identique à POST /resolve, pour les outils qui ne peuvent envoyer que des requêtes GET.

Paramètres

urlquery · stringobligatoire
La page de profil d'un créateur, encodée pour URL.

Requête

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

Réponse (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
}

Rechercher plusieurs créateurs

POST/batches

Chaque ligne n'est facturée que si elle trouve des comptes, et les lignes payées par votre compte au cours des 30 derniers jours sont gratuites. Les lignes qui ne sont pas des liens de profil sont ignorées et jamais facturées. Interrogez le lot, puis téléchargez le CSV.

Paramètres

urlsbody · string[] | stringobligatoire
Jusqu'à 500 URL de profil, sous forme de tableau ou une par ligne.
namebody · string
Un libellé pour le lot.

Requête

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

Réponse (201)

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

Consulter un lot

GET/batches/{id}

Interrogez toutes les quelques secondes jusqu'à ce que le statut soit "completed", "partial" ou "failed". Chaque élément porte son propre statut et les comptes trouvés.

Paramètres

idpath · uuidobligatoire
L'id renvoyé par POST /batches.

Requête

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

Réponse (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"]
      }
    }
  ]
}

Télécharger un lot en CSV

GET/batches/{id}/export

Prêt pour un tableur ou un import dans un CRM.

Paramètres

idpath · uuidobligatoire
L'id du lot.

Requête

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

Réponse (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,

Lister vos lots

GET/batches

Pratique pour reprendre là où vous vous étiez arrêté.

Paramètres

Aucun.

Requête

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

Réponse (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"
    }
  ]
}

Arrêter un lot

POST/batches/{id}/cancel

Les lignes en cours se terminent. Renvoie 409 si le lot est déjà terminé.

Paramètres

idpath · uuidobligatoire
L'id du lot.

Requête

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

Réponse (200)

{ "ok": true }

Consulter votre solde

GET/balance

Les mêmes crédits que ceux du site. Achetez des packs sur https://sociallinks.dev/pricing.

Paramètres

Aucun.

Requête

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

Réponse (200)

{ "credits": 742 }

Erreurs

Chaque erreur a la forme { "error": { "message", "code" } }. Le message est lisible ; le code est là si vous voulez brancher dessus.

Statut	Code	Signification
400	`—`	Ce n'est pas une URL de profil (publications, reels, vidéos et @pseudos seuls sont refusés), ou le corps est absent.
401	`invalid_api_key`	La clé est inconnue ou révoquée.
401	`login_required`	Aucune clé n'a été envoyée.
402	`out_of_credits`	Plus de crédits. Rien n'a été facturé ; achetez un pack et réessayez.
404	`—`	Aucun lot de ce type sur ce compte.
409	`—`	Le lot est déjà terminé.
429	`—`	Trop de nouvelles recherches. Attendez le nombre de secondes indiqué par Retry-After, ou envoyez la liste à /batches.
502	`—`	La recherche a échoué de notre côté. Rien n'a été facturé ; réessayez.

Limites de débit

Nouvelles recherches par clé	5 par minute
Créateurs déjà recherchés	Aucune limite ; réponse immédiate
Profils par lot	500
Clés API actives par compte	10

Support

Une question ou un bug ? Écrivez à support@youtubetranscript.dev.