Início / Documentação da API

Referência da API

API do Social links

Um perfil de criador entra, todas as contas saem. Envie um link de perfil do Instagram, TikTok, YouTube ou X e receba as contas do criador nas outras plataformas, cada uma com um veredito, uma pontuação de confiança e as evidências por trás dela.

URL basehttps://sociallinks.dev/v1

O que você pode fazer

Buscar um criadorUm link de perfil entra, as outras contas do criador saem.POST /resolveBuscar vários criadoresColoque até 500 perfis na fila; eles rodam em segundo plano.POST /batchesBaixar um lote em CSVUma linha por perfil enviado, uma coluna por plataforma, mais o status e os créditos cobrados.GET /batches/{id}/exportConsultar seu saldoCréditos restantes na conta da chave.GET /balance

Especificação OpenAPIO contrato completo, para geradores de código e agentes de IA.

Ver

Autenticação

Crie uma chave em Painel → API e envie-a em cada requisição como Authorization: Bearer sl_… (ou x-api-key: sl_…). As chaves gastam os créditos da sua conta. A chave é mostrada uma única vez, ao ser criada; se você a revogar, ela para de funcionar na hora.

Servidor MCP

Faça buscas pelo Claude Code, Cursor, VS Code, Windsurf, Gemini CLI ou qualquer cliente MCP. Adicione https://sociallinks.dev/mcp como servidor remoto (Streamable HTTP) e envie sua chave de API no cabeçalho Authorization. As ferramentas são cobradas exatamente como os endpoints REST.

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

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

Ferramentas

lookup_creator
Busca um criador a partir da URL de um perfil; cobra só quando encontra contas.
check_balance
Créditos restantes na conta da chave. Grátis.
start_batch
Coloca muitas URLs de perfis na fila para buscar em segundo plano.
get_batch
Progresso e linhas de um lote.

Cobrança

1 crédito por criador quando encontramos pelo menos uma conta além da que você enviou. Buscas que não encontram nada, e buscas que falham, são grátis. Buscar de novo um criador que sua conta pagou nos últimos 30 dias é grátis. Os créditos são compartilhados com o site; veja os preços.

Buscar um criador

POST/resolve

Envie uma URL de perfil do Instagram, TikTok, YouTube ou X. Você recebe as contas do criador nas outras plataformas, cada uma com um veredito, uma pontuação de confiança líquida e as evidências por trás dela. Buscas novas levam de 10 a 40 segundos; criadores que já temos voltam na hora. 1 crédito quando pelo menos uma conta é encontrada; se nada for encontrado, é grátis. O cabeçalho X-Credits-Remaining traz o seu saldo.

Parâmetros

urlbody · stringobrigatório
A página de perfil de um criador. Posts, reels, vídeos e @usuários soltos são recusados com 400.

Requisição

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

Resposta (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 um criador (GET)

GET/resolve

Idêntico ao POST /resolve, para ferramentas que só conseguem enviar requisições GET.

Parâmetros

urlquery · stringobrigatório
A página de perfil de um criador, codificada para URL.

Requisição

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

Resposta (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 vários criadores

POST/batches

Cada linha só é cobrada se encontrar contas, e linhas que sua conta pagou nos últimos 30 dias são grátis. Linhas que não são links de perfil são ignoradas e nunca cobradas. Consulte o lote e depois baixe o CSV.

Parâmetros

urlsbody · string[] | stringobrigatório
Até 500 URLs de perfil, como array ou uma por linha.
namebody · string
Um nome para o lote.

Requisição

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

Resposta (201)

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

Consultar um lote

GET/batches/{id}

Consulte a cada poucos segundos até o status ser "completed", "partial" ou "failed". Cada item traz seu próprio status e as contas encontradas.

Parâmetros

idpath · uuidobrigatório
O id que o POST /batches retornou.

Requisição

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

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

Baixar um lote em CSV

GET/batches/{id}/export

Pronto para uma planilha ou uma importação no CRM.

Parâmetros

idpath · uuidobrigatório
O id do lote.

Requisição

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

Resposta (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 seus lotes

GET/batches

Útil para continuar de onde você parou.

Parâmetros

Nenhum.

Requisição

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

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

Parar um lote

POST/batches/{id}/cancel

Linhas em andamento terminam. Retorna 409 se o lote já terminou.

Parâmetros

idpath · uuidobrigatório
O id do lote.

Requisição

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

Resposta (200)

{ "ok": true }

Consultar seu saldo

GET/balance

Os mesmos créditos que o site usa. Compre pacotes em https://sociallinks.dev/pricing.

Parâmetros

Nenhum.

Requisição

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

Resposta (200)

{ "credits": 742 }

Erros

Todo erro tem o formato { "error": { "message", "code" } }. A mensagem é legível; o código existe para quando você quiser ramificar por ele.

Status	Código	Significado
400	`—`	Não é uma URL de perfil (posts, reels, vídeos e @usuários soltos são recusados), ou o corpo está vazio.
401	`invalid_api_key`	A chave é desconhecida ou foi revogada.
401	`login_required`	Nenhuma chave foi enviada.
402	`out_of_credits`	Sem créditos. Nada foi cobrado; compre um pacote e tente de novo.
404	`—`	Não existe esse lote nesta conta.
409	`—`	O lote já terminou.
429	`—`	Buscas novas demais. Aguarde os segundos de Retry-After ou envie a lista para /batches.
502	`—`	A busca falhou do nosso lado. Nada foi cobrado; tente de novo.

Limites de uso

Buscas novas por chave	5 por minuto
Criadores já buscados	Sem limite; resposta imediata
Perfis por lote	500
Chaves de API ativas por conta	10

Suporte

Dúvidas ou um bug? Escreva para support@youtubetranscript.dev.