Come trovare i profili social di un creator con un'API

Hai trovato un creator su YouTube e vuoi lavorare con lui. Prima di inviare una proposta di sponsorizzazione, vuoi vedere il resto del quadro: il suo Instagram, il suo TikTok, il suo account X, magari un sito web o un podcast. Per un solo creator bastano pochi minuti di clic. Per una lista di 300 creator in un foglio di calcolo servono giorni, e gli errori si accumulano.

Questa guida copre entrambi i casi. Prima il metodo manuale per trovare i profili social di un creator, compreso il motivo per cui uno username uguale non basta. Poi come automatizzarlo con un'API di ricerca profili social, un profilo alla volta o per un'intera lista in blocco, con codice funzionante.

Una nota sull'ambito prima di cominciare: tutto ciò che segue riguarda gli account pubblici di creator e aziende, persone che pubblicano con un nome pubblico e vogliono essere trovate dal pubblico e dai brand. Non è una guida per seguire privati cittadini, e non devi usarla in quel modo.

Perché ti serve l'impronta social completa di un creator

Un solo profilo raramente basta per prendere una decisione. I team cercano gli altri account di un creator per alcuni motivi ricorrenti:

• Influencer marketing. Un creator con un canale YouTube di medie dimensioni può avere un TikTok molto più grande, o il contrario. Vuoi vedere tutto il pubblico prima di decidere un budget o un mix di canali.
• Proposte di sponsorizzazione. I contatti commerciali spesso si trovano su una sola piattaforma, come una pagina link in bio o la descrizione di un canale.
• Database di creator e CRM. Le liste acquistate, ottenute con scraping o raccolte a mano di solito hanno uno username per creator e colonne vuote per tutto il resto.
• Verifica. Un creator ti scrive dicendo di gestire un account popolare. Vuoi confermare che l'Instagram che ti ha mandato e il canale YouTube che conosci appartengano davvero alla stessa persona, e non a un impostore o a un omonimo.

Il metodo manuale: segui i link del creator

La prova più affidabile è un link inserito dal creator stesso. Solo il proprietario può modificare un profilo, quindi un link da un account di cui ti fidi già verso un altro account è quasi una prova. Passa in rassegna queste fonti nell'ordine.

Link del canale e descrizione

Su YouTube, apri il pannello della descrizione del canale. I creator elencano lì le loro altre piattaforme, e molti canali mostrano anche un'opzione di contatto commerciale. I link nell'intestazione del canale portano negli stessi posti.

Descrizioni dei video

Molti creator incollano tutti i loro link social sotto ogni video. Controlla alcuni video recenti, perché le descrizioni più vecchie possono rimandare ad account rinominati o abbandonati.

Pagine link in bio

Molti creator mettono nella bio un solo link che apre una pagina di link, da servizi come Linktree, Beacons o Stan, oppure una pagina sul proprio dominio. Queste pagine elencano spesso tutte le piattaforme che il creator usa. Annota l'URL della pagina di link stessa, così puoi mostrare da dove viene la prova.

Il sito web del creator

Se il creator ha un sito personale, controlla intestazione, footer, pagina "chi sono" e qualsiasi pagina stampa o media kit. Nel footer compaiono spesso icone social di account che il creator non cita da nessun'altra parte.

Menzioni incrociate nei contenuti

I creator citano i loro altri account mentre parlano: "seguitemi su TikTok per la versione breve" oppure "ho pubblicato la ricetta completa su Instagram". Se hai la trascrizione del video, una rapida ricerca dei nomi delle piattaforme trova queste menzioni senza dover riguardare nulla. La nostra guida alle API per le trascrizioni di YouTube spiega come ottenere trascrizioni in blocco se lo fai su molti canali.

Per una spiegazione più approfondita del metodo manuale, con operatori di ricerca e ricerca inversa delle immagini, sociallinks.dev ha una guida completa su come trovare tutti i profili social di un creator.

Perché uno username uguale da solo non è affidabile

La scorciatoia più veloce è prendere lo username del creator e digitarlo nello schema di URL di ogni piattaforma. Se il canale YouTube è youtube.com/@leoruns, prova instagram.com/leoruns e tiktok.com/@leoruns.

È una prima ipotesi utile, ma uno username uguale da solo non dimostra nulla:

• Qualcun altro può avere quel nome. Nomi comuni e username brevi sono spesso già presi da persone estranee su altre piattaforme.
• Gli account di fan, parodia e impostori copiano gli username. I creator popolari li attirano, e a prima vista possono sembrare convincenti.
• I creator usano varianti. Quando il loro nome è occupato, ripiegano su versioni come leo.runs, leoruns_ o leorunstv, quindi la corrispondenza esatta può non esistere anche se il creator c'è.
• Gli username cambiano. Un creator può rinominare un account, e qualcun altro può poi prendersi il vecchio username. Un vecchio link oggi può portare a un'altra persona.

Quindi considera ogni username uguale come un indizio. Accettalo solo quando hai prove a supporto: un link da un account affidabile, una menzione incrociata, oppure nome e foto profilo corrispondenti con contenuti coerenti. Annota quale prova hai usato, così la decisione si può verificare in seguito.

Il problema quando i numeri crescono

Il metodo manuale funziona bene per un creator. Con una lista crolla:

• Pochi minuti per creator diventano giorni di lavoro per una lista di 500 creator.
• Persone diverse applicano criteri diversi: un ricercatore accetta gli username uguali, un altro no.
• Nessuno annota le prove, quindi una corrispondenza sbagliata nel CRM non si può ricostruire.
• Gli account cambiano, e una lista ripulita sei mesi fa è già superata.

Qui un'API aiuta. Ti serve qualcosa che prenda l'unico profilo che hai, segua e verifichi i link al posto tuo e restituisca risultati strutturati con le prove allegate, così il tuo codice decide cosa accettare e una persona controlla solo i casi incerti.

Usare un'API di ricerca profili social

sociallinks.dev è il nostro prodotto gemello, creato proprio per questo. Gli dai un URL di profilo Instagram, TikTok, YouTube o X e restituisce gli account del creator sulle altre piattaforme, ognuno con un verdetto, un punteggio di affidabilità netto e le prove a supporto. Riconosce 15 reti, tra cui Instagram, YouTube, TikTok, X, Facebook, Twitch, LinkedIn, Threads, Kick, Snapchat, Spotify, Substack, Patreon, Reddit e GitHub, oltre a siti web e pagine link in bio.

Ogni ricerca analizza il profilo, legge i link nella bio del creator e la sua pagina link in bio, esegue ricerche mirate sulle principali reti e poi sottopone ogni candidato a un controllo di identità. Le ricerche avvengono in tempo reale sulle piattaforme, non su un database datato.

Funziona in tre modi, tutti con gli stessi crediti:

• App web: incolla un link di profilo e controlla i risultati.
• In blocco: incolla o carica fino a 500 link di profilo (uno per riga, oppure un file .csv o .txt) e scarica un CSV.
• API: un'API REST su https://sociallinks.dev/v1, più un server MCP ospitato per gli assistenti AI.

Cercare un creator con l'API

Crea una chiave API nella tua dashboard di sociallinks.dev, nella sezione API. Inviala con ogni richiesta in un header Authorization: Bearer (funziona anche un header x-api-key). Le chiavi vengono mostrate una sola volta, quando le crei.

Per cercare un creator, invia l'URL del suo profilo a POST /resolve. Dato che la maggior parte dei nostri lettori parte da YouTube, ecco una ricerca che inizia da un canale 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"}'

L'url deve essere la pagina profilo di un creator. Post, reel, video e semplici @username vengono rifiutati con un errore 400. Se il tuo strumento può inviare solo richieste GET, GET /resolve fa la stessa cosa con il link del profilo codificato nel parametro di query url.

Le nuove ricerche richiedono da 10 a 40 secondi. I creator già cercati tornano all'istante. Ecco la risposta di esempio della documentazione, per una ricerca partita da un profilo 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
}

Alcuni campi da conoscere:

• verdict indica come ogni profilo è legato alla ricerca. Il profilo che hai inviato torna come "seed", e gli account trovati possono tornare come "confirmed".
• net_confidence combina la forza della ricerca e il controllo di identità in un unico numero per account. Vengono mostrate solo le corrispondenze con almeno il 50% di affidabilità.
• evidence elenca come e dove è stato trovato ogni account, così puoi verificarlo con un clic.
• rejected conta i candidati esaminati e scartati.

Ecco la stessa chiamata in Python, che stampa ogni account con le sue prove:

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"])

L'header di risposta X-Credits-Remaining contiene il tuo saldo, e GET /balance lo restituisce su richiesta.

Elaborare un'intera lista di creator in blocco

Per le liste, non fare un ciclo su /resolve. Le nuove ricerche sono limitate a 5 al minuto per chiave, e l'API risponde con un 429 e un header Retry-After quando superi il limite. Invia invece la lista a POST /batches: fino a 500 URL di profilo per batch, elaborati in background.

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

La risposta ti dà un id di batch più il numero di righe, righe non valide e duplicati. Poi interroga GET /batches/{id} ogni pochi secondi finché lo stato non è "completed", "partial" o "failed", e scarica i risultati con GET /batches/{id}/export.

Questo script Python legge gli URL dei canali YouTube da un file di testo, li elabora in un unico batch e salva il 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"])

Il CSV ha una riga per ogni profilo inviato e una colonna per piattaforma, più lo stato e i crediti addebitati. Le colonne sono:

Si importa direttamente in un foglio di calcolo o in un CRM e riempie le colonne vuote di Instagram, TikTok e X accanto ai canali YouTube da cui sei partito. GET /batches elenca i tuoi batch se devi riprendere da dove avevi lasciato, e POST /batches/{id}/cancel ne interrompe uno (le righe già in corso vengono comunque completate).

Prezzi e limiti

sociallinks.dev addebita per creator, non per piattaforma. Una ricerca costa 1 credito quando viene trovato almeno un account oltre a quello che hai inviato, indipendentemente da quante piattaforme emergono. Le ricerche che non trovano nulla e quelle non riuscite sono gratuite. La stessa regola vale per ogni riga di un batch, e le righe che non sono link di profilo vengono saltate e mai addebitate. Anche cercare un creator che il tuo account ha già pagato negli ultimi 30 giorni è gratuito.

I crediti si acquistano in pacchetti una tantum, senza abbonamento, e non scadono mai:

I nuovi account ricevono 3 ricerche gratuite, senza carta di credito. I limiti documentati dell'API:

Consulta la pagina dei prezzi e la documentazione dell'API per i dettagli aggiornati.

Gestione degli errori

Ogni errore viene restituito come oggetto JSON con un messaggio leggibile e, quando serve, un codice su cui basare la logica. Quelli che incontrerai più spesso:

Usarlo da Claude, Cursor e altri strumenti AI

Se lavori con un assistente AI, sociallinks.dev offre anche un server MCP ospitato su https://sociallinks.dev/mcp. In Claude Code basta un comando per aggiungerlo:

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

Funziona con Cursor, VS Code, Windsurf, Gemini CLI e qualsiasi client compatibile con MCP remoto. Gli strumenti (lookup_creator, check_balance, start_batch e get_batch) vengono addebitati esattamente come gli endpoint REST, quindi puoi chiedere al tuo assistente di trovare gli account di un creator mentre costruisci una shortlist.

Buone pratiche per cercare i creator

• Parti dal profilo più solido che hai. Il canale principale di un creator, con i link nella descrizione, dà risultati migliori di un piccolo account secondario.
• Salva le prove, non solo lo username. Registra verdetto, punteggio di affidabilità e fonte della prova accanto a ogni account, così chiunque può vedere perché è stato accettato.
• Stabilisci una regola di accettazione. Per esempio, accetta automaticamente le corrispondenze confermate e manda il resto a una persona per la revisione.
• Ricontrolla prima delle decisioni importanti. Gli account vengono rinominati e abbandonati. Cerca di nuovo un creator prima di firmare un contratto, invece di fidarti di una riga vecchia di mesi.
• Limitati ai creator pubblici. Cerca persone che pubblicano pubblicamente come creator o aziende, per partnership, ricerca e verifica. Non usare questi strumenti per seguire privati cittadini.

Una volta trovati gli account di un creator, il passo successivo di solito è capire cosa dice davvero. Se YouTube è il suo canale principale, le trascrizioni sono il modo più rapido per controllare temi, tono e sponsor passati prima di contattarlo. La nostra API per le trascrizioni di YouTube le restituisce come segmenti JSON con timestamp, e se stai pianificando le sponsorizzazioni del tuo canale, leggi come guadagnare su YouTube.