Como encontrar as redes sociais de um criador com uma API

Você encontrou um criador no YouTube e quer trabalhar com ele. Antes de enviar uma proposta de patrocínio, você quer ver o resto do quadro: o Instagram, o TikTok, a conta no X, talvez um site ou um podcast. Para um criador, isso leva alguns minutos de cliques. Para uma lista de 300 criadores numa planilha, leva dias, e os erros se acumulam.

Este guia cobre os dois casos. Primeiro, o método manual para encontrar as redes sociais de um criador, incluindo por que um nome de usuário igual não basta. Depois, como automatizar isso com uma API de busca de redes sociais, para um perfil por vez ou para uma lista inteira em massa, com código que funciona.

Uma observação sobre o escopo antes de começar: tudo aqui trata de contas públicas de criadores e empresas, pessoas que publicam com um nome público e querem ser encontradas pelo público e por marcas. Não é um guia para rastrear pessoas comuns, e você não deve usá-lo assim.

Por que você precisa da presença social completa de um criador

Um único perfil raramente basta para tomar uma decisão. As equipes buscam as outras contas de um criador por alguns motivos comuns:

• Marketing de influência. Um criador com um canal médio no YouTube pode ter um TikTok muito maior, ou o contrário. Você quer ver a audiência inteira antes de definir um orçamento ou um mix de canais.
• Propostas de patrocínio. Os contatos comerciais muitas vezes ficam em uma única plataforma, como uma página de link na bio ou a descrição de um canal.
• Bases de dados de criadores e CRMs. Listas compradas, raspadas ou montadas à mão geralmente têm um nome de usuário por criador e colunas vazias para todo o resto.
• Verificação. Um criador manda um e-mail dizendo que administra uma conta popular. Você quer confirmar que o Instagram que ele enviou e o canal do YouTube que você conhece pertencem mesmo à mesma pessoa, e não a um impostor ou a um homônimo.

O método manual: siga os links do próprio criador

A evidência mais confiável é um link que o próprio criador colocou. Só o dono pode editar um perfil, então um link de uma conta em que você já confia para outra conta é quase uma prova. Percorra estas fontes em ordem.

Links do canal e descrição

No YouTube, abra o painel de descrição do canal. Os criadores listam ali suas outras plataformas, e muitos canais também mostram uma opção de contato comercial. Os links no cabeçalho do canal apontam para os mesmos lugares.

Descrições dos vídeos

Muitos criadores colam todos os seus links sociais embaixo de cada vídeo. Confira alguns vídeos recentes, porque descrições antigas podem apontar para contas que foram renomeadas ou abandonadas.

Páginas de link na bio

Muitos criadores colocam na bio um único link que abre uma página de links, de serviços como Linktree, Beacons ou Stan, ou uma página no próprio domínio. Essas páginas costumam listar todas as plataformas que o criador usa. Anote a URL da própria página de links para poder mostrar de onde veio a evidência.

O site do próprio criador

Se o criador tem um site pessoal, confira o cabeçalho, o rodapé, a página "sobre" e qualquer página de imprensa ou mídia kit. O rodapé muitas vezes traz ícones de contas que o criador não menciona em nenhum outro lugar.

Menções cruzadas no conteúdo

Os criadores mencionam suas outras contas enquanto falam: "me siga no TikTok para a versão curta" ou "postei a receita completa no Instagram". Se você tem a transcrição do vídeo, uma busca rápida pelos nomes das plataformas encontra essas menções sem precisar assistir a nada de novo. Nosso guia de APIs de transcrição do YouTube explica como obter transcrições em massa se você faz isso em muitos canais.

Para um passo a passo mais detalhado do método manual, com operadores de busca e busca reversa de imagens, a sociallinks.dev tem um guia completo sobre como encontrar todas as redes sociais de um criador.

Por que um nome de usuário igual não é confiável

O atalho mais rápido é pegar o nome de usuário do criador e digitá-lo no padrão de URL de cada plataforma. Se o canal do YouTube é youtube.com/@leoruns, tente instagram.com/leoruns e tiktok.com/@leoruns.

É um bom primeiro palpite, mas um nome de usuário igual, sozinho, não prova nada:

• Outra pessoa pode ter o nome. Nomes comuns e nomes de usuário curtos costumam estar ocupados por pessoas sem relação em outras plataformas.
• Contas de fãs, de paródia e de impostores copiam nomes de usuário. Criadores populares atraem essas contas, e elas podem parecer convincentes à primeira vista.
• Criadores usam variações. Quando o nome está ocupado, os criadores recorrem a versões como leo.runs, leoruns_ ou leorunstv, então a correspondência exata pode não existir mesmo que o criador esteja lá.
• Nomes de usuário mudam. Um criador pode renomear uma conta, e outra pessoa pode então pegar o nome antigo. Um link antigo pode apontar hoje para outra pessoa.

Por isso, trate cada nome de usuário igual como uma pista. Aceite-o só quando tiver evidências de apoio: um link de uma conta confiável, uma menção cruzada, ou um nome e uma foto de perfil iguais com conteúdo coerente. Anote qual evidência você usou, para que a decisão possa ser conferida depois.

O problema de fazer isso em escala

O método manual funciona bem para um criador. Para uma lista, ele não se sustenta:

• Alguns minutos por criador viram dias de trabalho numa lista de 500 criadores.
• Pessoas diferentes usam critérios diferentes, então um pesquisador aceita nomes de usuário iguais e outro não.
• Ninguém registra as evidências, então uma correspondência errada no CRM não pode ser rastreada.
• As contas mudam, e uma lista limpa há seis meses já está ficando desatualizada.

É aí que uma API ajuda. Você quer algo que pegue o único perfil que você tem, siga e confira os links por você e devolva resultados estruturados com as evidências anexadas, para que seu código decida o que aceitar e uma pessoa só revise os casos incertos.

Como usar uma API de busca de redes sociais

A sociallinks.dev é nosso produto irmão, criado exatamente para isso. Você informa uma URL de perfil do Instagram, TikTok, YouTube ou X e ela devolve 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. Ela reconhece 15 redes, entre elas Instagram, YouTube, TikTok, X, Facebook, Twitch, LinkedIn, Threads, Kick, Snapchat, Spotify, Substack, Patreon, Reddit e GitHub, além de sites e páginas de link na bio.

Cada busca analisa o perfil, lê os links da bio do criador e a página de link na bio, faz buscas direcionadas nas principais redes e depois roda uma verificação de identidade em cada candidato. As buscas acontecem ao vivo nas plataformas, não numa base de dados desatualizada.

Ela funciona de três formas, todas com os mesmos créditos:

• App web: cole um link de perfil e revise os resultados.
• Em massa: cole ou envie até 500 links de perfil (um por linha, ou um arquivo .csv ou .txt) e baixe um CSV.
• API: uma API REST em https://sociallinks.dev/v1, além de um servidor MCP hospedado para assistentes de IA.

Buscar um criador com a API

Crie uma chave de API no seu painel da sociallinks.dev, na seção API. Envie-a em cada requisição num cabeçalho Authorization: Bearer (um cabeçalho x-api-key também funciona). As chaves são mostradas uma única vez, quando você as cria.

Para buscar um criador, envie a URL do perfil para POST /resolve. Como a maioria dos nossos leitores parte do YouTube, aqui está uma busca que começa em um canal do YouTube:

curl -X POST "https://sociallinks.dev/v1/resolve" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/@mkbhd"}'

A url precisa ser a página de perfil de um criador. Posts, reels, vídeos e @usuários soltos são recusados com um erro 400. Se a sua ferramenta só consegue enviar requisições GET, GET /resolve faz o mesmo com o link do perfil codificado em um parâmetro de consulta url.

Buscas novas levam de 10 a 40 segundos. Criadores que já foram buscados voltam na hora. Esta é a resposta de exemplo da documentação, para uma busca que começou em um perfil do Instagram:

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

Vale conhecer alguns campos:

• verdict diz como cada perfil se relaciona com a busca. O perfil que você enviou volta como "seed", e as contas encontradas podem voltar como "confirmed".
• net_confidence combina a força da busca e a verificação de identidade em um único número por conta. Só aparecem correspondências com 50% de confiança ou mais.
• evidence lista como e onde cada conta foi encontrada, para você conferir com um clique.
• rejected conta os candidatos que foram analisados e descartados.

Esta é a mesma chamada em Python, imprimindo cada conta com suas evidências:

import os
import requests

API = "https://sociallinks.dev/v1"
HEADERS = {"Authorization": "Bearer " + os.environ["SOCIALLINKS_KEY"]}

def resolve(profile_url):
    r = requests.post(API + "/resolve", headers=HEADERS, json={"url": profile_url}, timeout=90)
    r.raise_for_status()
    print("Credits left:", r.headers.get("X-Credits-Remaining"))
    return r.json()

data = resolve("https://www.youtube.com/@mkbhd")
print(data["creator"]["name"], "identity confidence:", data["identity_confidence"])

for p in data["profiles"]:
    print(p["platform"], p["handle"], p["verdict"], p["net_confidence"])
    for e in p.get("evidence", []):
        print("   ", e["kind"], "|", e["detail"], "|", e["source"])

for w in data.get("websites", []):
    print("website", w["url"])

O cabeçalho de resposta X-Credits-Remaining traz o seu saldo, e GET /balance o retorna quando você quiser.

Processar uma lista inteira de criadores em massa

Para listas, não faça um loop sobre /resolve. Buscas novas são limitadas a 5 por minuto por chave, e a API responde com um 429 e um cabeçalho Retry-After quando você passa do limite. Envie a lista para POST /batches: até 500 URLs de perfil por lote, processadas em segundo plano.

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

A resposta traz um id de lote e a contagem de linhas, linhas inválidas e duplicadas. Depois consulte GET /batches/{id} a cada poucos segundos até o status ser "completed", "partial" ou "failed", e baixe os resultados com GET /batches/{id}/export.

Este script em Python lê URLs de canais do YouTube de um arquivo de texto, processa todas em um lote e salva o CSV:

import os
import time
import requests

API = "https://sociallinks.dev/v1"
HEADERS = {"Authorization": "Bearer " + os.environ["SOCIALLINKS_KEY"]}

with open("channels.txt") as f:
    urls = [line.strip() for line in f if line.strip()][:500]

r = requests.post(API + "/batches", headers=HEADERS, json={"name": "YouTube shortlist", "urls": urls})
r.raise_for_status()
batch = r.json()
print("Queued", batch["rows"], "rows,", batch["invalid"], "invalid,", batch["duplicates"], "duplicates")

while True:
    status = requests.get(API + "/batches/" + batch["id"], headers=HEADERS).json()["batch"]
    print(status["status"], status["succeeded"], "of", status["total"], "done")
    if status["status"] in ("completed", "partial", "failed"):
        break
    time.sleep(5)

csv = requests.get(API + "/batches/" + batch["id"] + "/export", headers=HEADERS)
with open("results.csv", "wb") as f:
    f.write(csv.content)
print("Credits charged:", status["charged"])

O CSV tem uma linha por perfil enviado e uma coluna por plataforma, além do status e dos créditos cobrados. As colunas são:

Ele entra direto numa planilha ou numa importação de CRM, preenchendo as colunas vazias de Instagram, TikTok e X ao lado dos canais do YouTube com que você começou. GET /batches lista seus lotes caso você precise retomar de onde parou, e POST /batches/{id}/cancel interrompe um lote (as linhas que já estão em andamento terminam mesmo assim).

Preços e limites

A sociallinks.dev cobra por criador, não por plataforma. Uma busca custa 1 crédito quando pelo menos uma conta é encontrada além da que você enviou, não importa quantas plataformas apareçam. Buscas que não encontram nada e buscas que falham são gratuitas. A mesma regra vale para cada linha de um lote, e linhas que não são links de perfil são ignoradas e nunca cobradas. Buscar um criador pelo qual sua conta já pagou nos últimos 30 dias também é grátis.

Os créditos vêm em pacotes de pagamento único, sem assinatura, e nunca expiram:

Contas novas ganham 3 buscas grátis, sem cartão de crédito. Os limites documentados da API:

Confira a página de preços e a documentação da API para ver os detalhes atuais.

Tratamento de erros

Todo erro volta como um objeto JSON com uma mensagem legível e, quando útil, um código para você tratar cada caso. Os que você vai ver com mais frequência:

Como usar no Claude, Cursor e outras ferramentas de IA

Se você trabalha com um assistente de IA, a sociallinks.dev também mantém um servidor MCP hospedado em https://sociallinks.dev/mcp. No Claude Code, um único comando o adiciona:

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

Ele funciona com Cursor, VS Code, Windsurf, Gemini CLI e qualquer cliente compatível com MCP remoto. As ferramentas (lookup_creator, check_balance, start_batch e get_batch) são cobradas exatamente como os endpoints REST, então você pode pedir ao seu assistente que encontre as contas de um criador enquanto monta uma lista de candidatos.

Boas práticas para buscar criadores

• Comece pelo perfil mais forte que você tiver. O canal principal de um criador, com links na descrição, dá resultados melhores do que uma pequena conta secundária.
• Guarde as evidências, não só o nome de usuário. Salve o veredito, a pontuação de confiança e a fonte da evidência ao lado de cada conta, para que qualquer pessoa veja por que ela foi aceita.
• Defina uma regra de aceitação. Por exemplo, aceite automaticamente as correspondências confirmadas e mande o resto para uma pessoa revisar.
• Confira de novo antes de grandes decisões. Contas são renomeadas e abandonadas. Busque o criador outra vez antes de assinar um contrato, em vez de confiar numa linha de meses atrás.
• Fique nos criadores públicos. Busque pessoas que publicam publicamente como criadores ou empresas, para parcerias, pesquisa e verificação. Não use estas ferramentas para seguir pessoas comuns.

Depois de ter as contas de um criador, o próximo passo costuma ser entender o que ele realmente diz. Se o YouTube é o canal principal dele, as transcrições são a forma mais rápida de conferir temas, tom e patrocinadores anteriores antes de entrar em contato. Nossa API de transcrição do YouTube as retorna como segmentos JSON com tempo, e se você está planejando os patrocínios do seu próprio canal, veja como ganhar dinheiro no YouTube.