Ссылка в био автора обычно ведет на страницу Linktree, Komi, lnk.bio или Link.me. Именно там авторы могут указать контактный email, другие аккаунты в соцсетях, свой магазин, последнее видео и спонсоров. Если вы исследуете авторов в больших объемах, эти страницы — полезные данные, но читать их вручную утомительно.
2026-11-17 SocQ запустил Link in Bio API на новой платформе Link in Bio. Он читает до 50 страниц за запрос во всех четырех сервисах и возвращает каждую в виде структурированной записи. В этом руководстве разобраны запрос, поля, цена и то, как использовать эндпоинт в конвейере аутрича.
Коротко: отправьте до 50 URL страниц в
urlsнаPOST /v1/link-in-bio/profile. URL Linktree, Komi, lnk.bio и Link.me можно передавать в одном запросе. ОпрашивайтеGET /v1/tasks/{task_id}и читайте по одной строке на страницу изdata.results.items. Каждая найденная страница стоит 0.5 кредита ($0.0025).
Что возвращает эндпоинт
1 кредит SocQ = $0.005.
| Эндпоинт | Что возвращает | Цена |
|---|---|---|
| Link in Bio API | Одна строка на страницу: сервис, имя страницы, отображаемое имя, био, аватар, значок верификации, контактный email, связанные профили в соцсетях и все ссылки на странице с заголовком, адресом назначения, типом и миниатюрой | 0.5 кредита ($0.0025) за найденную страницу |
Страницы, которых больше не существует, пропускаются. Задача завершается ошибкой с возвратом кредитов, только если не удалось прочитать ни одной страницы.
Аутентификация и асинхронные задачи
Все запросы к SocQ аутентифицируются API-ключом, и один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Каждый сбор данных выполняется как фоновая задача:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Ответ на отправку содержит data.task_id и data.status. Опрашивайте задачу по этому ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Когда status равен succeeded, ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500; если has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Пока задача находится в состоянии queued, running или failed, эндпоинт возвращает метаданные задачи без results.
Необязательный callback_url в теле запроса заставляет SocQ отправить один POST со сводкой задачи после ее завершения; сами записи читайте через GET /v1/tasks/{task_id}. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не платите за дубликат. 402 означает недостаточно кредитов; 429 означает, что ключ достиг лимита запросов или кредитов.
Запрос страниц link-in-bio
Укажите до 50 URL страниц в urls в формате linktr.ee/name, name.komi.io, lnk.bio/name или link.me/name. Смешанный список, собранный из био в Instagram или TikTok, не нужно предварительно сортировать.
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"
]
}'
Оплата зависит от числа возвращенных страниц. SocQ может зарезервировать кредиты исходя из числа отправленных URL и после завершения задачи рассчитывает итоговое списание по фактическому result_count, возвращая неиспользованные кредиты.
Структура записи страницы
Сокращенная строка из примера в документации:
{
"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
}
Поля, которые понадобятся чаще всего:
id: сервис и имя страницы, напримерlinktree:miguelangeles. Используйте его как стабильный ключ.serviceиusername: какой сервис размещает страницу и имя страницы на нем.name,text,avatar_urlиis_verified: отображаемое имя, био, фото профиля и наличие на странице значка верификации сервиса.email: контактный email, указанный на странице, если он есть.social_urls: профили в соцсетях и сайты, на которые ведут иконки страницы.links: все ссылки в порядке отображения, сtitle,url,type(в том виде, в каком его сообщает сервис, напримерlinkилиspotify_album) иthumbnail_url.links_count: число ссылок на странице.
Полная схема — в документации Link in Bio.
Пакетная обработка большого списка
Разбейте длинный список на группы по 50 и отправляйте по одной задаче на группу. Минимальный шаблон на 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])
Перед использованием в продакшене добавьте проверку HTTP-статусов, ограниченное число повторов и пагинацию по курсору, а также сохраняйте каждый task_id вместе с его входным пакетом.
Когда использовать
Контактные данные для аутрича. Если автор указывает контактный email на странице, он попадает в email. Если поле пустое, запустите Influencer Email Finder API для основного профиля автора; он тоже проверяет страницы link-in-bio, связанные сайты и другие аккаунты.
Карта аккаунтов автора. social_urls дает собственный список профилей автора. Сочетайте его с Social Media Profile Finder, когда нужна оценка уверенности. Оба эндпоинта описаны в руководстве по API Creator.
Исследование спонсоров и партнерских программ. links показывает магазины, промокоды, брендовых партнеров и контент, которые автор продвигает прямо сейчас. Отслеживайте их во времени и сравнивайте снимки по collected_at.
Обогащение каталога. links_count, is_verified и значения type у ссылок помогают размечать и фильтровать базу авторов, не открывая каждую страницу.
FAQ
Что такое API link in bio?
Это API, который читает страницы link-in-bio — посадочные страницы, которые авторы указывают в био в соцсетях, — и возвращает их в виде структурированных данных. Версия SocQ поддерживает Linktree, Komi, lnk.bio и Link.me.
Можно ли смешивать сервисы в одном запросе?
Да. URL Linktree, Komi, lnk.bio и Link.me можно передавать в одном массиве urls, до 50 на запрос.
Что происходит, если страница удалена?
Страницы, которых больше не существует, пропускаются и не оплачиваются. Задача завершается ошибкой с возвратом кредитов, только если не удалось прочитать ни одной из отправленных страниц.
Есть ли email на каждой странице?
Нет. email заполняется, только если автор указал его на странице; иначе он равен null.
Сколько стоит прочитать 1,000 страниц?
При цене 0.5 кредита за найденную страницу 1,000 страниц стоят 500 кредитов, или $2.50, и отправляются как 20 запросов по 50 URL.
LINK IN BIO API
Проверить сценарий на публичном URL Link in Bio
Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.
API для Link in Bio