Inicio / Documentación de la API

Referencia de la API

API de Social links

Un perfil de creador entra, todas sus cuentas salen. Envía un enlace de perfil de Instagram, TikTok, YouTube o X y recibe las cuentas del creador en las demás plataformas, cada una con un veredicto, una puntuación de confianza y las pruebas que la respaldan.

URL basehttps://sociallinks.dev/v1

Qué puedes hacer

Buscar un creadorUn enlace de perfil entra, las demás cuentas del creador salen.POST /resolveBuscar muchos creadoresPon en cola hasta 500 perfiles; se procesan en segundo plano.POST /batchesDescargar un lote en CSVUna fila por perfil enviado, una columna por plataforma, más el estado y los créditos cobrados.GET /batches/{id}/exportConsultar tu saldoCréditos que quedan en la cuenta de la clave.GET /balance

Especificación OpenAPIEl contrato completo, para generadores de código y agentes de IA.

Ver

Autenticación

Crea una clave en Panel → API y envíala en cada solicitud como Authorization: Bearer sl_… (o x-api-key: sl_…). Las claves gastan los créditos de tu cuenta. Una clave se muestra una sola vez al crearla; si la revocas, deja de funcionar al instante.

Servidor MCP

Haz búsquedas desde Claude Code, Cursor, VS Code, Windsurf, Gemini CLI o cualquier cliente MCP. Añade https://sociallinks.dev/mcp como servidor remoto (Streamable HTTP) y envía tu clave de API en la cabecera Authorization. Las herramientas se cobran igual que los endpoints REST.

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

Dónde va: Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

Herramientas

lookup_creator
Busca un creador a partir de la URL de un perfil; solo se cobra si se encuentran cuentas.
check_balance
Créditos que quedan en la cuenta de la clave. Gratis.
start_batch
Pon en cola muchas URL de perfiles para buscarlas en segundo plano.
get_batch
Progreso y filas de un lote.

Facturación

1 crédito por creador cuando encontramos al menos una cuenta además de la que enviaste. Las búsquedas que no encuentran nada, y las que fallan, son gratis. Volver a buscar un creador que tu cuenta pagó en los últimos 30 días es gratis. Los créditos se comparten con el sitio web; consulta los precios.

Buscar un creador

POST/resolve

Envía una URL de perfil de Instagram, TikTok, YouTube o X. Recibes las cuentas del creador en las demás plataformas, cada una con un veredicto, una puntuación de confianza neta y las pruebas que la respaldan. Las búsquedas nuevas tardan entre 10 y 40 segundos; los creadores que ya tenemos llegan al instante. 1 crédito cuando se encuentra al menos una cuenta; si no se encuentra nada, es gratis. La cabecera X-Credits-Remaining indica tu saldo.

Parámetros

urlbody · stringobligatorio
La página de perfil de un creador. Se rechazan publicaciones, reels, vídeos y @usuarios sueltos con un 400.

Solicitud

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

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

Buscar un creador (GET)

GET/resolve

Idéntico a POST /resolve, para herramientas que solo pueden enviar solicitudes GET.

Parámetros

urlquery · stringobligatorio
La página de perfil de un creador, codificada para URL.

Solicitud

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

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

Buscar muchos creadores

POST/batches

Cada fila se cobra solo si encuentra cuentas, y las filas que tu cuenta pagó en los últimos 30 días son gratis. Las filas que no son enlaces de perfil se omiten y nunca se cobran. Consulta el lote y luego descarga el CSV.

Parámetros

urlsbody · string[] | stringobligatorio
Hasta 500 URLs de perfil, como array o una por línea.
namebody · string
Una etiqueta para el lote.

Solicitud

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

Respuesta (201)

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

Consultar un lote

GET/batches/{id}

Consulta cada pocos segundos hasta que el estado sea "completed", "partial" o "failed". Cada elemento lleva su propio estado y las cuentas encontradas.

Parámetros

idpath · uuidobligatorio
El id que devolvió POST /batches.

Solicitud

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

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

Descargar un lote en CSV

GET/batches/{id}/export

Listo para una hoja de cálculo o para importar en un CRM.

Parámetros

idpath · uuidobligatorio
El id del lote.

Solicitud

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

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

Listar tus lotes

GET/batches

Útil para retomar donde lo dejaste.

Parámetros

Ninguno.

Solicitud

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

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

Detener un lote

POST/batches/{id}/cancel

Las filas en curso terminan. Devuelve 409 si el lote ya terminó.

Parámetros

idpath · uuidobligatorio
El id del lote.

Solicitud

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

Respuesta (200)

{ "ok": true }

Consultar tu saldo

GET/balance

Los mismos créditos que usa el sitio web. Compra paquetes en https://sociallinks.dev/pricing.

Parámetros

Ninguno.

Solicitud

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

Respuesta (200)

{ "credits": 742 }

Errores

Todo error tiene la forma { "error": { "message", "code" } }. El mensaje es legible; el código está ahí para cuando quieras ramificar según él.

Estado	Código	Significado
400	`—`	No es una URL de perfil (se rechazan publicaciones, reels, vídeos y @usuarios sueltos), o falta el cuerpo.
401	`invalid_api_key`	La clave es desconocida o fue revocada.
401	`login_required`	No se envió ninguna clave.
402	`out_of_credits`	No quedan créditos. No se cobró nada; compra un paquete y vuelve a intentarlo.
404	`—`	No existe ese lote en esta cuenta.
409	`—`	El lote ya terminó.
429	`—`	Demasiadas búsquedas nuevas. Espera los segundos de Retry-After o envía la lista a /batches.
502	`—`	La búsqueda falló por nuestra parte. No se te cobró; inténtalo de nuevo.

Límites de uso

Búsquedas nuevas por clave	5 por minuto
Creadores ya buscados	Sin límite; respuesta inmediata
Perfiles por lote	500
Claves de API activas por cuenta	10

Soporte

¿Preguntas o un error? Escribe a support@youtubetranscript.dev.