SocQ уже поддерживал публичные профили TikTok, видео, комментарии, поиск и хештеги; они разобраны в руководстве по парсингу TikTok. 2026-11-17 на странице платформы TikTok заработали еще 14 эндпоинтов TikTok. Они отвечают на вопросы, на которые базовые эндпоинты ответить не могли: где живут подписчики автора, настоящие ли просмотры у видео, что люди ищут сегодня и что прямо сейчас продается в LIVE-эфире.
В этом руководстве новые эндпоинты сгруппированы по задачам: для каждого приведены один запрос, цена и сценарий использования.
Коротко: каждый эндпоинт — это
POSTнаhttps://api.socq.ai/v1/tiktok/<endpoint>с JSON-телом. Вызов возвращаетtask_id; опрашивайтеGET /v1/tasks/{task_id}, покаstatusне станетsucceeded, затем читайтеdata.results.items.
Новые эндпоинты TikTok вкратце
1 кредит SocQ = $0.005. У эндпоинтов с оплатой за результат нет базовой платы, поэтому пустой результат ничего не стоит.
| Эндпоинт | Что возвращает | Цена |
|---|---|---|
| TikTok Audience Demographics API | Страны подписчиков с долей и числом подписчиков в выборке | 20 кредитов ($0.10) за вызов |
| TikTok Fake Views Checker API | Оценка накрутки, расчетные накрученные просмотры и их доля, уровень трафика, основная причина | 5 кредитов ($0.025) за вызов |
| TikTok Similar Accounts API | Аккаунты, которые TikTok рекомендует как похожие, с био и счетчиками | 0.5 кредита ($0.0025) за аккаунт |
| TikTok Reposts API | Видео, которые аккаунт репостнул, с исходным автором и статистикой | 0.5 кредита ($0.0025) за видео |
| TikTok Playlists API | Публичные плейлисты с названием, обложкой и числом видео | 0.5 кредита ($0.0025) за плейлист |
| TikTok Trending Searches API | Около 100 сегодняшних трендовых запросов по порядку | 0.5 кредита ($0.0025) за вызов |
| TikTok Creator Search Insights API | 20 популярных запросов с оценкой популярности и трендом из семи точек | 1 кредит ($0.005) за вызов |
| TikTok Hashtag Views API | Общее число видео и просмотров для до 20 хештегов | 0.5 кредита ($0.0025) за хештег |
| TikTok Comment Keywords API | Ранжированные ключевые слова из комментариев вместе с самими комментариями | 1 кредит ($0.005) за вызов |
| TikTok Sound Search API | Звуки с исполнителем, длительностью, превью и числом использований | 0.6 кредита ($0.003) за звук |
| TikTok Photo Search API | Публикации-карусели с фото со всеми изображениями и вовлеченностью | 0.6 кредита ($0.003) за публикацию |
| TikTok Live Search API | LIVE-эфиры, идущие сейчас, с ведущим, зрителями и лайками | 0.6 кредита ($0.003) за эфир |
| TikTok Live Ranking API | До 99 ведущих из ежедневного рейтинга LIVE с оценкой по подаркам | 0.5 кредита ($0.0025) за вызов |
| TikTok Live Shopping API | Товары в корзине LIVE-эфира с ценой и числом проданных единиц | 0.1 кредита ($0.0005) за товар |
Аутентификация и асинхронные задачи
Все запросы аутентифицируются 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, ответ содержит result_count, credits_amount и первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если results.has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Задача с ошибкой содержит error_message.
В тело любого запроса ниже можно добавить необязательный callback_url. Тогда SocQ отправит один POST со сводкой задачи после ее завершения; записи читайте через эндпоинт задачи. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не отправляйте ее повторно. 402 означает, что у аккаунта закончились кредиты, а 429 — что ключ достиг лимита запросов или кредитов.
Проверка автора перед оплатой
Эти пять эндпоинтов помогают решить, стоит ли заключать сделку с автором.
Audience Demographics перечисляет все страны в выборке подписчиков с их долей и числом подписчиков из выборки, начиная с самых крупных. Используйте его, чтобы проверить, что охват автора приходится на рынок, где вы продаете. username принимается с @ или без него. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame"}'
Fake Views Checker принимает URL видео или фото-публикации и возвращает fake_score, is_suspicious, confidence_level, estimated_fake_views, fake_view_percentage, estimated_organic_views, traffic_tier и main_reason. Необязательный category (по умолчанию general, а также entertainment, education, product, verified_large) выбирает эталонные показатели вовлеченности. Запускайте его для спонсорских публикаций и для авторов, которым вы собираетесь платить за охват. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/fake-views" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Similar Accounts возвращает аккаунты, которые сам TikTok рекомендует как похожие на заданное имя пользователя, в порядке TikTok, с био, числом подписчиков и видео и статусом верификации. Если один автор вам подходит, этот эндпоинт расширяет шорт-лист вокруг него. По умолчанию results_limit равен 30 (от 1 до 300). (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame", "results_limit": 30}'
Reposts показывает, что аккаунт продвигает помимо собственных загрузок: каждое репостнутое видео с исходным автором, подписью, просмотрами, лайками, хештегами и видеофайлом, от новых к старым. По умолчанию results_limit равен 20 (от 1 до 500). (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "mrbeast", "results_limit": 20}'
Playlists перечисляет публичные плейлисты автора с названием, обложкой и item_count, что показывает серии и форматы, к которым он постоянно возвращается. По умолчанию results_limit равен 20 (от 1 до 100). (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "zachking"}'
Полная проверка одного автора — Audience Demographics, Fake Views для трех недавних видео и 30 похожих аккаунтов — стоит 20 + 15 + 15 = 50 кредитов ($0.25).
Что люди ищут и обсуждают
Trending Searches не требует входных данных и возвращает около 100 сегодняшних трендовых запросов в порядке TikTok, каждый со ссылкой на поиск. Список обновляется ежедневно, поэтому из него получается хорошая утренняя лента идей для контента. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Creator Search Insights возвращает 20 популярных запросов, каждый с оценкой популярности от 0 до 100, трендом из семи точек, числом связанных видео, категорией и метками. Все поля необязательны: language (по умолчанию en; также ar, de, es, fr, id, ja, ko, pt, th, tr, vi), category (fashion, food, gaming, science, sports, tourism) и filter_by. Установите filter_by в content_gap, чтобы получить запросы, на которые есть спрос, но пока мало видео. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category": "food", "filter_by": "content_gap"}'
Hashtag Views сравнивает до 20 хештегов в одном запросе по общему числу видео и общему числу просмотров. Несуществующие теги пропускаются и не оплачиваются. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags": ["cooking", "booktok"]}'
Comment Keywords читает за вас оживленный раздел комментариев: самые частые ключевые слова по порядку, каждое с комментариями, в которых оно встречается, и их лайками. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/comment-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Поисковые подсказки, которые TikTok показывает под запросом, разобраны в руководстве по TikTok Top Search.
Поиск звуков и фото-публикаций
Sound Search ищет по библиотеке звуков по названию, исполнителю или настроению и возвращает ID звуков, исполнителя, обложку, длительность, воспроизводимое превью и metrics.videos_count. sort_by принимает значения relevance (по умолчанию), most_used или latest; region по умолчанию US. Используйте ID с TikTok Song Videos или сравнивайте с чартами из руководства по TikTok Music Chart. По умолчанию results_limit равен 20 (от 1 до 500). (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "lofi", "results_limit": 20}'
Photo Search возвращает только публикации-карусели с фото, со всеми изображениями карусели, а также подписью, автором, хештегами, просмотрами, лайками, комментариями и репостами. По умолчанию results_limit равен 20 (от 1 до 500). (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "outfit ideas", "results_limit": 20}'
TikTok LIVE и LIVE-шопинг
Live Search находит эфиры, идущие в момент запроса, с названием, ведущим, текущим числом зрителей, лайками и временем начала. По умолчанию results_limit равен 20 (от 1 до 200). (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "deals", "results_limit": 20}'
Live Shopping перечисляет товары в корзине эфира с названием, текущей ценой, числом проданных единиц, продавцом и изображением. id и author.id каждого результата Live Search — это те самые room_id и user_id, которые он принимает, поэтому вызывайте его, пока эфир еще идет. По умолчанию results_limit равен 100 (от 1 до 500), а эфир без товаров не оплачивается. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id": "7704767945901132575", "user_id": "7153432386608251946", "results_limit": 100}'
Live Ranking не требует входных данных и возвращает до 99 ведущих из текущего ежедневного рейтинга LIVE с местом, оценкой по подаркам, именем пользователя и числом подписчиков. (документация)
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Чтобы проверить, ведут ли эфир конкретные аккаунты, используйте эндпоинт из руководства по TikTok Live Status.
Другие руководства по TikTok
Реклама и ставки авторов из TikTok Creative Center описаны в руководстве по API TikTok Creative Center, а новые эндпоинты TikTok Shop — в руководстве по исследованию товаров TikTok Shop. Чтобы сравнить SocQ с другими поставщиками, прочитайте 7 лучших API для парсинга TikTok и Альтернативы API TikTok.
FAQ
Списываются ли кредиты, если у аккаунта нет репостов или плейлистов?
Нет. У эндпоинтов с оплатой за результат нет базовой платы, и в документации указано, что пустой результат не оплачивается.
Как Fake Views Checker определяет, что просмотры накручены?
Он сравнивает вовлеченность видео с эталонными показателями для типа контента, который вы выбираете в category, и возвращает оценку, расчетное число накрученных просмотров и их долю, уровень трафика и основную причину. Считайте это оценкой для проверки, а не вердиктом.
Откуда брать room_id и user_id для Live Shopping?
Из TikTok Live Search: id результата — это room_id, а его author.id — это user_id. Эфир должен еще идти.
Чем Trending Searches отличается от Creator Search Insights?
Trending Searches — это ранжированный список TikTok примерно из 100 запросов за сегодня за 0.5 кредита. Creator Search Insights возвращает 20 запросов с оценкой популярности и трендом из семи точек, с фильтрами по языку, категории и незанятым темам, за 1 кредит.
TIKTOK API
Проверить сценарий на публичном URL TikTok
Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.
API для TikTok