El enlace de la biografía de un creador suele llevar a una página de Linktree, Komi, lnk.bio o Link.me. En esa página los creadores pueden indicar un email de contacto, sus otras cuentas sociales, su tienda, su último video y sus patrocinadores. Si investiga creadores a escala, esas páginas son datos útiles y tediosos de leer a mano.
El 2026-11-17, SocQ lanzó la Link in Bio API en la nueva plataforma Link in Bio. Lee hasta 50 páginas por solicitud, de los cuatro servicios, y devuelve cada una como un registro estructurado. Esta guía explica la solicitud, los campos, el precio y cómo usarla en un flujo de contacto con creadores.
Respuesta rápida: envíe hasta 50 URL de páginas en
urlsaPOST /v1/link-in-bio/profile. Las URL de Linktree, Komi, lnk.bio y Link.me pueden ir en la misma solicitud. ConsulteGET /v1/tasks/{task_id}y lea una fila por página endata.results.items. Cada página encontrada cuesta 0.5 créditos ($0.0025).
Qué devuelve el endpoint
1 crédito de SocQ = $0.005.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| Link in Bio API | Una fila por página: servicio, nombre de la página, nombre visible, biografía, avatar, insignia de verificación, email de contacto, perfiles sociales vinculados y cada enlace de la página con título, destino, tipo y miniatura | 0.5 créditos ($0.0025) por página encontrada |
Las páginas que ya no existen se omiten. La tarea solo falla, con reembolso, cuando no se puede leer ninguna de las páginas.
Autenticación y flujo de tareas asíncronas
Todas las solicitudes a SocQ se autentican con una clave de API, y se usa el mismo encabezado para el envío, el estado de la tarea y la obtención de resultados:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada recopilación se ejecuta como una tarea en segundo plano:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La respuesta del envío contiene data.task_id y data.status. Consulte la tarea con ese ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Cuando status es succeeded, la respuesta incluye la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y llega hasta 500; si has_more es true, pase results.next_cursor como cursor para leer la página siguiente. Mientras una tarea está en queued, running o failed, el endpoint devuelve los metadatos de la tarea sin results.
Un callback_url opcional en el cuerpo del envío hace que SocQ envíe un único POST con un resumen de la tarea cuando esta termina; lea los registros con GET /v1/tasks/{task_id}. Un tiempo de espera agotado en el cliente no cancela la tarea, así que reanude con el mismo ID de tarea en lugar de pagar por un duplicado. 402 significa créditos insuficientes; 429 significa que la clave alcanzó un límite de frecuencia o de créditos.
Solicite páginas de link in bio
Indique hasta 50 URL de páginas en urls, con los formatos linktr.ee/name, name.komi.io, lnk.bio/name o link.me/name. Una lista mixta extraída de biografías de Instagram o TikTok no necesita ordenarse antes.
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 facturación sigue a las páginas devueltas. SocQ puede reservar créditos según el número de URL enviadas y liquida el cargo final a partir del result_count real cuando termina la tarea, devolviendo los créditos no utilizados.
Entienda el registro de la página
Una fila recortada del ejemplo de la documentación:
{
"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
}
Los campos que usará con más frecuencia:
id: el servicio y el nombre de la página, comolinktree:miguelangeles. Úselo como clave estable.serviceyusername: qué servicio aloja la página y el nombre de la página en él.name,text,avatar_urleis_verified: nombre visible, biografía, foto de perfil y si la página lleva la insignia de verificación del servicio.email: el email de contacto indicado en la página, cuando lo hay.social_urls: perfiles sociales y sitios web vinculados desde los iconos de la página.links: cada enlace en el orden mostrado, contitle,url,type(tal como lo informa el servicio, por ejemplolinkospotify_album) ythumbnail_url.links_count: el número de enlaces de la página.
El esquema completo está en la documentación de Link in Bio.
Procese una lista grande por lotes
Divida una lista larga en grupos de 50 y envíe una tarea por grupo. Un patrón mínimo en Python:
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])
Añada comprobaciones de estado HTTP, reintentos acotados y paginación por cursor antes de usarlo en producción, y guarde cada task_id junto con su lote de entrada.
Cuándo usarla
Datos de contacto para outreach. Cuando un creador indica un email de contacto en la página, email lo contiene. Si está vacío, ejecute la Influencer Email Finder API sobre el perfil principal del creador; también revisa páginas de link in bio, sitios web vinculados y otras cuentas.
Mapear las cuentas de un creador. social_urls le da la lista de perfiles que el propio creador publica. Combínela con Social Media Profile Finder cuando necesite una puntuación de confianza. Ambas se tratan en la guía de las Creator API.
Investigación de patrocinadores y afiliados. links muestra las tiendas, códigos de descuento, marcas asociadas y contenidos que un creador promociona en este momento. Haga un seguimiento en el tiempo y compare instantáneas por collected_at.
Enriquecimiento de catálogos. links_count, is_verified y los valores de type de los enlaces le ayudan a etiquetar y filtrar una base de datos de creadores sin abrir cada página.
Preguntas frecuentes
¿Qué es una API de link in bio?
Una API que lee páginas de link in bio, las páginas de destino que los creadores ponen en sus biografías sociales, y las devuelve como datos estructurados. La versión de SocQ cubre Linktree, Komi, lnk.bio y Link.me.
¿Puedo mezclar servicios en una solicitud?
Sí. Las URL de Linktree, Komi, lnk.bio y Link.me pueden ir en el mismo array urls, hasta 50 por solicitud.
¿Qué ocurre si una página se ha eliminado?
Las páginas que ya no existen se omiten y no se cobran. La tarea solo falla, con reembolso, cuando no se puede leer ninguna de las páginas enviadas.
¿Todas las páginas incluyen un email?
No. email solo se rellena cuando el creador indica uno en la página; en caso contrario es null.
¿Cuánto cuesta leer 1,000 páginas?
A 0.5 créditos por página encontrada, 1,000 páginas cuestan 500 créditos, es decir, $2.50, enviadas en 20 solicitudes de 50 URL.
LINK IN BIO API
Probar el flujo de trabajo con una URL pública de Link in Bio
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de Link in Bio