Le lien placé dans la bio d’un créateur mène généralement à une page Linktree, Komi, lnk.bio ou Link.me. C’est sur cette page que les créateurs peuvent indiquer un e-mail de contact, leurs autres comptes sociaux, leur boutique, leur dernière vidéo et leurs sponsors. Si vous étudiez des créateurs à grande échelle, ces pages sont des données utiles, et fastidieuses à lire à la main.
Le 2026-11-17, SocQ a lancé l’API Link in Bio sur la nouvelle plateforme Link in Bio. Elle lit jusqu’à 50 pages par requête, sur les quatre services, et renvoie chacune sous forme d’enregistrement structuré. Ce guide présente la requête, les champs, le prix et la manière de l’utiliser dans un pipeline de prospection.
Réponse rapide : envoyez jusqu’à 50 URL de pages dans
urlsàPOST /v1/link-in-bio/profile. Les URL Linktree, Komi, lnk.bio et Link.me peuvent figurer dans la même requête. InterrogezGET /v1/tasks/{task_id}et lisez une ligne par page dansdata.results.items. Chaque page trouvée coûte 0,5 crédit ($0,0025).
Ce que renvoie l’endpoint
1 crédit SocQ = $0,005.
| Endpoint | Ce qu’il renvoie | Prix |
|---|---|---|
| Link in Bio API | Une ligne par page : service, nom de la page, nom affiché, bio, avatar, badge vérifié, e-mail de contact, profils sociaux liés et chaque lien de la page avec titre, destination, type et vignette | 0,5 crédit ($0,0025) par page trouvée |
Les pages qui n’existent plus sont ignorées. La tâche échoue avec remboursement uniquement lorsqu’aucune des pages ne peut être lue.
Authentification et flux de tâches asynchrones
Toutes les requêtes SocQ s’authentifient avec une clé API, et le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Chaque collecte s’exécute comme une tâche en arrière-plan :
submit -> task_id -> queued -> running -> succeeded
\-> failed
La réponse à l’envoi contient data.task_id et data.status. Interrogez la tâche avec cet ID :
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Lorsque status vaut succeeded, la réponse contient la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500 ; si has_more est vrai, passez results.next_cursor comme cursor pour lire la page suivante. Tant qu’une tâche est queued, running ou failed, l’endpoint renvoie les métadonnées de la tâche sans results.
Un callback_url facultatif dans le corps de l’envoi permet à SocQ d’envoyer un POST contenant un résumé de la tâche lorsqu’elle se termine ; lisez ensuite les enregistrements avec GET /v1/tasks/{task_id}. Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même ID de tâche plutôt que de payer un doublon. 402 signifie que les crédits sont insuffisants ; 429 signifie que la clé a atteint une limite de débit ou de crédits.
Demander des pages link-in-bio
Indiquez jusqu’à 50 URL de pages dans urls, sous les formes linktr.ee/name, name.komi.io, lnk.bio/name ou link.me/name. Une liste mixte extraite de bios Instagram ou TikTok n’a pas besoin d’être triée au préalable.
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"
]
}'
La facturation suit les pages renvoyées. SocQ peut réserver des crédits en fonction du nombre d’URL envoyées, puis règle la facturation finale d’après le result_count réel une fois la tâche terminée, en restituant les crédits inutilisés.
Comprendre l’enregistrement d’une page
Une ligne abrégée tirée de l’exemple de la documentation :
{
"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
}
Les champs que vous utiliserez le plus :
id: le service et le nom de la page, commelinktree:miguelangeles. Utilisez-le comme clé stable.serviceetusername: le service qui héberge la page et le nom de la page sur ce service.name,text,avatar_urletis_verified: nom affiché, bio, photo de profil et présence du badge vérifié du service sur la page.email: l’e-mail de contact indiqué sur la page, lorsqu’il y en a un.social_urls: les profils sociaux et sites web liés depuis les icônes de la page.links: chaque lien dans l’ordre d’affichage, avectitle,url,type(tel qu’indiqué par le service, commelinkouspotify_album) etthumbnail_url.links_count: le nombre de liens sur la page.
Le schéma complet figure dans la documentation Link in Bio.
Traiter une grande liste par lots
Découpez une longue liste en groupes de 50 et envoyez une tâche par groupe. Un modèle Python minimal :
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])
Ajoutez des vérifications de statut HTTP, des nouvelles tentatives limitées et la pagination par curseur avant une utilisation en production, et stockez chaque task_id avec son lot d’entrée.
Quand l’utiliser
Données de contact pour la prospection. Lorsqu’un créateur indique un e-mail de contact sur la page, email le contient. S’il est vide, lancez l’Influencer Email Finder API sur le profil principal du créateur ; elle vérifie aussi les pages link-in-bio, les sites web liés et les autres comptes.
Cartographier les comptes d’un créateur. social_urls vous donne la liste de profils établie par le créateur lui-même. Combinez-la avec le Social Media Profile Finder lorsque vous avez besoin d’un score de confiance. Les deux sont présentés dans le guide de l’API Creator.
Recherche de sponsors et d’affiliations. links montre les boutiques, codes promo, marques partenaires et contenus qu’un créateur met en avant en ce moment. Suivez-le dans le temps et comparez les instantanés par collected_at.
Enrichissement de catalogue. links_count, is_verified et les valeurs type des liens vous aident à étiqueter et filtrer une base de créateurs sans ouvrir chaque page.
FAQ
Qu’est-ce qu’une API link in bio ?
Une API qui lit les pages link-in-bio, les pages d’atterrissage que les créateurs placent dans leurs bios sociales, et les renvoie sous forme de données structurées. La version de SocQ couvre Linktree, Komi, lnk.bio et Link.me.
Puis-je mélanger plusieurs services dans une même requête ?
Oui. Les URL Linktree, Komi, lnk.bio et Link.me peuvent figurer dans le même tableau urls, jusqu’à 50 par requête.
Que se passe-t-il si une page a été supprimée ?
Les pages qui n’existent plus sont ignorées et ne sont pas facturées. La tâche échoue avec remboursement uniquement lorsqu’aucune des pages envoyées ne peut être lue.
Chaque page contient-elle un e-mail ?
Non. email n’est renseigné que si le créateur en indique un sur la page ; sinon, il vaut null.
Combien coûte la lecture de pages ?
À 0,5 crédit par page trouvée, pages coûtent 500 crédits, soit $2,50, envoyées en 20 requêtes de 50 URL.
LINK IN BIO API
Tester le workflow avec une URL publique Link in Bio
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API Link in Bio