Главная / Документация API

Справочник API

API Social links

Один профиль автора на входе, все его аккаунты на выходе. Отправьте ссылку на профиль в Instagram, TikTok, YouTube или X и получите аккаунты автора на других платформах — у каждого вердикт, оценка уверенности и доказательства.

Базовый URLhttps://sociallinks.dev/v1

Что можно сделать

Найти автораОдна ссылка на профиль на входе, остальные аккаунты автора на выходе.POST /resolveНайти много авторовПоставьте в очередь до 500 профилей; они обрабатываются в фоне.POST /batchesСкачать пакет в CSVСтрока на каждый отправленный профиль, столбец на каждую платформу, плюс статус и списанные кредиты.GET /batches/{id}/exportПроверить балансОставшиеся кредиты на аккаунте, к которому привязан ключ.GET /balance

Спецификация OpenAPIПолный контракт для генераторов кода и ИИ-агентов.

Открыть

Аутентификация

Создайте ключ в разделе Панель → API и отправляйте его с каждым запросом как Authorization: Bearer sl_… (или x-api-key: sl_…). Ключи расходуют кредиты вашего аккаунта. Ключ показывается один раз при создании; после отзыва он сразу перестаёт работать.

MCP-сервер

Запускайте поиск из Claude Code, Cursor, VS Code, Windsurf, Gemini CLI или любого MCP-клиента. Добавьте https://sociallinks.dev/mcp как удалённый сервер (Streamable HTTP) и передавайте API-ключ в заголовке Authorization. Инструменты тарифицируются так же, как REST-эндпоинты.

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

Куда вставить: Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

Инструменты

lookup_creator
Ищет автора по ссылке на профиль; списывается, только если аккаунты найдены.
check_balance
Остаток кредитов на аккаунте ключа. Бесплатно.
start_batch
Ставит в очередь много ссылок на профили для фонового поиска.
get_batch
Ход выполнения и строки пакета.

Оплата

1 кредит за автора, если мы находим хотя бы один аккаунт помимо отправленного. Поиски без результатов и неудачные поиски бесплатны. Повторный поиск автора, за которого ваш аккаунт заплатил за последние 30 дней, бесплатен. Кредиты общие с сайтом; см. цены.

Найти автора

POST/resolve

Отправьте один URL профиля в Instagram, TikTok, YouTube или X. Вы получите аккаунты автора на других платформах — у каждого вердикт, итоговая оценка уверенности и доказательства. Новый поиск занимает 10–40 секунд; авторы, которые у нас уже есть, возвращаются сразу. 1 кредит, если найден хотя бы один аккаунт; если ничего не найдено — бесплатно. Заголовок X-Credits-Remaining содержит ваш баланс.

Параметры

urlbody · stringобязательно
Страница профиля автора. Публикации, рилсы, видео и одиночные @хэндлы отклоняются с кодом 400.

Запрос

curl -X POST "https://sociallinks.dev/v1/resolve" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/mkbhd"}'

Ответ (200)

{
  "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
}

Найти автора (GET)

GET/resolve

То же, что POST /resolve, для инструментов, которые умеют отправлять только GET-запросы.

Параметры

urlquery · stringобязательно
Страница профиля автора в URL-кодировке.

Запрос

curl "https://sociallinks.dev/v1/resolve?url=https%3A%2F%2Fwww.instagram.com%2Fmkbhd" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

Ответ (200)

{
  "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
}

Найти много авторов

POST/batches

Строка оплачивается, только если в ней найдены аккаунты, а строки, за которые ваш аккаунт заплатил за последние 30 дней, бесплатны. Строки, которые не являются ссылками на профиль, пропускаются и никогда не оплачиваются. Опрашивайте пакет, затем скачайте CSV.

Параметры

urlsbody · string[] | stringобязательно
До 500 URL профилей — массивом или по одному на строку.
namebody · string
Название пакета.

Запрос

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

Ответ (201)

{
  "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
  "rows": 2,
  "invalid": 0,
  "duplicates": 0
}

Проверить пакет

GET/batches/{id}

Опрашивайте каждые несколько секунд, пока статус не станет "completed", "partial" или "failed". У каждого элемента свой статус и найденные аккаунты.

Параметры

idpath · uuidобязательно
id, который вернул POST /batches.

Запрос

curl "https://sociallinks.dev/v1/batches/$BATCH_ID" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

Ответ (200)

{
  "batch": {
    "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
    "name": "Q4 shortlist",
    "status": "completed",
    "total": 2,
    "succeeded": 2,
    "empty": 0,
    "failed": 0,
    "skipped": 0,
    "charged": 2,
    "created_at": "2026-10-19T09:30:00Z"
  },
  "items": [
    {
      "position": 0,
      "input": { "url": "https://www.tiktok.com/@zachking" },
      "status": "succeeded",
      "charged": 1,
      "result": {
        "name": "Zach King",
        "profiles": [{ "platform": "youtube", "handle": "ZachKing", "url": "https://www.youtube.com/@ZachKing", "verdict": "confirmed" }],
        "notFound": ["linkedin"]
      }
    }
  ]
}

Скачать пакет в CSV

GET/batches/{id}/export

Готово для таблицы или импорта в CRM.

Параметры

idpath · uuidобязательно
id пакета.

Запрос

curl "https://sociallinks.dev/v1/batches/$BATCH_ID/export" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" -o results.csv

Ответ (200)

row,input,status,credits,creator,verified_creator,instagram,youtube,tiktok,x,twitch,facebook,linkedin,nothing_found_on,error
1,https://www.tiktok.com/@zachking,succeeded,1,Zach King,no,https://www.instagram.com/zachking,https://www.youtube.com/@ZachKing,https://www.tiktok.com/@zachking,https://x.com/zachking,,https://www.facebook.com/zachking,,linkedin,

Список ваших пакетов

GET/batches

Удобно, чтобы продолжить с того места, где остановились.

Параметры

Нет.

Запрос

curl "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

Ответ (200)

{
  "batches": [
    {
      "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
      "name": "Q4 shortlist",
      "status": "completed",
      "total": 2,
      "succeeded": 2,
      "empty": 0,
      "failed": 0,
      "skipped": 0,
      "charged": 2,
      "created_at": "2026-10-19T09:30:00Z"
    }
  ]
}

Остановить пакет

POST/batches/{id}/cancel

Строки, которые уже выполняются, завершаются. Возвращает 409, если пакет уже завершён.

Параметры

idpath · uuidобязательно
id пакета.

Запрос

curl -X POST "https://sociallinks.dev/v1/batches/$BATCH_ID/cancel" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

Ответ (200)

{ "ok": true }

Проверить баланс

GET/balance

Те же кредиты, что и на сайте. Пакеты можно купить на https://sociallinks.dev/pricing.

Параметры

Нет.

Запрос

curl "https://sociallinks.dev/v1/balance" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

Ответ (200)

{ "credits": 742 }

Ошибки

Каждая ошибка имеет вид { "error": { "message", "code" } }. Сообщение понятно человеку, а код пригодится, если нужно обрабатывать случаи по-разному.

Статус	Код	Значение
400	`—`	Это не URL профиля (публикации, рилсы, видео и одиночные @хэндлы отклоняются) или нет тела запроса.
401	`invalid_api_key`	Ключ неизвестен или отозван.
401	`login_required`	Ключ не отправлен.
402	`out_of_credits`	Кредиты закончились. Ничего не списано; купите пакет и повторите попытку.
404	`—`	В этом аккаунте нет такого пакета.
409	`—`	Пакет уже завершён.
429	`—`	Слишком много новых поисков. Подождите столько секунд, сколько указано в Retry-After, или отправьте список в /batches.
502	`—`	Поиск сломался на нашей стороне. Ничего не списано; попробуйте ещё раз.

Лимиты запросов

Новых поисков на ключ	5 в минуту
Авторы, которых уже искали	Без ограничений; ответ сразу
Профилей в пакете	500
Активных API-ключей на аккаунт	10

Поддержка

Вопросы или нашли ошибку? Напишите на support@youtubetranscript.dev.