Link in BioLinktreeDati sui creatorOutreach influencerGuida alle API

API Link in Bio: leggi in blocco le pagine Linktree, Komi, lnk.bio e Link.me

Leggi fino a 50 pagine Linktree, Komi, lnk.bio e Link.me per richiesta e ottieni bio, avatar, email di contatto, social collegati e tutti i link della pagina, a 0.5 crediti per pagina.

SocQAggiornato il 19 novembre 20266 min di lettura

Il link nella bio di un creator di solito porta a una pagina Linktree, Komi, lnk.bio o Link.me. È lì che i creator possono indicare un'email di contatto, gli altri account social, il proprio shop, l'ultimo video e gli sponsor. Se fai ricerca sui creator su larga scala, quelle pagine sono dati utili e noiose da leggere a mano.

Il 2026-11-17 SocQ ha lanciato l'API Link in Bio sulla nuova piattaforma Link in Bio. Legge fino a 50 pagine per richiesta, su tutti e quattro i servizi, e restituisce ciascuna come record strutturato. Questa guida spiega la richiesta, i campi, il prezzo e come usarla in una pipeline di outreach.

Risposta rapida: invia fino a 50 URL di pagine in urls a POST /v1/link-in-bio/profile. URL di Linktree, Komi, lnk.bio e Link.me possono stare nella stessa richiesta. Interroga GET /v1/tasks/{task_id} e leggi una riga per pagina da data.results.items. Ogni pagina trovata costa 0.5 crediti ($0.0025).

Cosa restituisce l'endpoint

1 credito SocQ = $0.005.

EndpointCosa restituiscePrezzo
Link in Bio APIUna riga per pagina: servizio, nome della pagina, nome visualizzato, bio, avatar, badge di verifica, email di contatto, profili social collegati e tutti i link della pagina con titolo, destinazione, tipo e miniatura0.5 crediti ($0.0025) per pagina trovata

Le pagine che non esistono più vengono saltate. Il task fallisce con rimborso solo quando nessuna delle pagine può essere letta.

Autenticazione e flusso asincrono dei task

Tutte le richieste SocQ si autenticano con una chiave API, e lo stesso header vale per l'invio, lo stato del task e la lettura dei risultati:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Ogni raccolta viene eseguita come task in background:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La risposta all'invio contiene data.task_id e data.status. Interroga il task con quell'ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Quando status è succeeded, la risposta include la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500; se has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. Mentre un task è queued, running o failed, l'endpoint restituisce i metadati del task senza results.

Un callback_url facoltativo nel corpo dell'invio fa sì che SocQ invii una POST con il riepilogo del task quando termina; leggi poi i record con GET /v1/tasks/{task_id}. Un timeout lato client non annulla il task, quindi riprendi con lo stesso ID invece di pagare un duplicato. 402 indica crediti insufficienti; 429 indica che la chiave ha raggiunto un limite di frequenza o di crediti.

Fornisci fino a 50 URL di pagine in urls, nelle forme linktr.ee/name, name.komi.io, lnk.bio/name o link.me/name. Un elenco misto raccolto dalle bio di Instagram o TikTok non va prima ordinato.

curl -X POST "https://api.socq.ai/v1/link-in-bio/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://linktr.ee/miguelangeles",
      "https://kimkardashian.komi.io",
      "https://lnk.bio/msjennafischer",
      "https://link.me/danucd"
    ]
  }'

L'addebito segue le pagine restituite. SocQ può riservare crediti in base al numero di URL inviati e salda l'importo finale sul result_count effettivo al termine del task, restituendo i crediti non usati.

Capire il record della pagina

Una riga ridotta, tratta dall'esempio della documentazione:

{
  "id": "komi:kimkardashian",
  "platform": "link-in-bio",
  "resource": "profile",
  "type": "page",
  "url": "https://kimkardashian.komi.io",
  "service": "komi",
  "username": "kimkardashian",
  "name": "Kim Kardashian",
  "email": null,
  "social_urls": [
    "https://www.instagram.com/kimkardashian/",
    "https://www.tiktok.com/@kimkardashian",
    "https://www.youtube.com/@KUWTK"
  ],
  "links": [
    {
      "title": "Visit SKIMS",
      "url": "https://skims.social/shop-skims",
      "type": "link",
      "thumbnail_url": "https://komi-production-assets.s3-accelerate.amazonaws.com/photos/x_LQCBYzoWiel0-yrAnrF.jpg"
    }
  ],
  "links_count": 21
}

I campi che userai di più:

  • id: servizio e nome della pagina, ad esempio linktree:miguelangeles. Usalo come chiave stabile.
  • service e username: il servizio che ospita la pagina e il nome della pagina su quel servizio.
  • name, text, avatar_url e is_verified: nome visualizzato, bio, foto profilo e se la pagina ha il badge di verifica del servizio.
  • email: l'email di contatto indicata nella pagina, se presente.
  • social_urls: profili social e siti web collegati dalle icone della pagina.
  • links: tutti i link nell'ordine in cui compaiono, con title, url, type (come riportato dal servizio, ad esempio link o spotify_album) e thumbnail_url.
  • links_count: il numero di link nella pagina.

Lo schema completo è nella documentazione di Link in Bio.

Elaborare in blocco un elenco lungo

Dividi un elenco lungo in gruppi da 50 e invia un task per gruppo. Uno schema Python minimo:

import os, time, requests

API = "https://api.socq.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SOCQ_API_KEY']}"}

def read_pages(urls):
    task = requests.post(f"{API}/link-in-bio/profile",
                         json={"urls": urls}, headers=HEADERS).json()
    task_id = task["data"]["task_id"]
    while True:
        time.sleep(3)
        data = requests.get(f"{API}/tasks/{task_id}",
                            params={"limit": 50}, headers=HEADERS).json()["data"]
        if data["status"] in ("succeeded", "failed"):
            return data

for i in range(0, len(all_urls), 50):
    result = read_pages(all_urls[i:i + 50])

Prima di andare in produzione aggiungi controlli sullo stato HTTP, retry limitati e paginazione tramite cursore, e salva ogni task_id insieme al suo lotto di input.

Quando usarla

Dati di contatto per l'outreach. Quando un creator indica un'email di contatto nella pagina, la trovi in email. Se è vuota, usa l'API Influencer Email Finder sul profilo principale del creator; controlla anche le pagine link in bio, i siti web collegati e gli altri account.

Mappare gli account di un creator. social_urls ti dà l'elenco dei profili indicato dal creator stesso. Combinalo con il Social Media Profile Finder quando ti serve un punteggio di affidabilità. Entrambi sono trattati nella guida alle API Creator.

Ricerca su sponsor e affiliazioni. links mostra gli shop, i codici sconto, i brand partner e i contenuti che un creator sta promuovendo in questo momento. Monitoralo nel tempo e confronta le istantanee tramite collected_at.

Arricchimento del catalogo. links_count, is_verified e i valori type dei link ti aiutano a etichettare e filtrare un database di creator senza aprire ogni pagina.

FAQ

Un'API che legge le pagine link in bio, le landing page che i creator inseriscono nelle loro bio social, e le restituisce come dati strutturati. La versione di SocQ copre Linktree, Komi, lnk.bio e Link.me.

Posso mescolare servizi diversi in una sola richiesta?

Sì. URL di Linktree, Komi, lnk.bio e Link.me possono stare nello stesso array urls, fino a 50 per richiesta.

Cosa succede se una pagina è stata eliminata?

Le pagine che non esistono più vengono saltate e non addebitate. Il task fallisce con rimborso solo quando nessuna delle pagine inviate può essere letta.

Ogni pagina include un'email?

No. email viene compilato solo quando il creator ne indica una nella pagina; altrimenti è null.

Quanto costa leggere 1,000 pagine?

A 0.5 crediti per pagina trovata, 1,000 pagine costano 500 crediti, cioè $2.50, inviate come 20 richieste da 50 URL.

LINK IN BIO API

Prova il flusso di lavoro con un URL pubblico di Link in Bio

Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.

Scopri le API di Link in Bio