tiktok/
search-photos

Ищите фотокарусели TikTok по ключевому слову без видео в результатах и получайте все изображения слайдов, а также подпись, хештеги, автора и число просмотров, лайков, комментариев и репостов.

TikTok Photo Search API

Поиск по ключевому слову
Только публикации с фото
Все изображения карусели
0,6 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

TikTok Photo Search

Публикация с фото в TikTok — это пролистываемый набор статичных изображений с подписью, хештегами и звуком, который собирает те же счетчики просмотров, лайков, комментариев и репостов, что и видео. Поиск только по таким публикациям показывает, какие визуальные форматы работают в теме: от подборок образов и пошаговых рецептов до списков и обзоров товаров.

Возможности TikTok Photo Search API

  • Только публикации с фотоКаждый результат — фотокарусель, видео исключены, поэтому поиск по ключевому слову не разбавляется видеороликами.
  • Каждый слайд с размерамиmedia перечисляет все изображения публикации в порядке слайдов, с их type, url, width и height.
  • Вовлеченность и контекст публикацииmetrics содержит лайки, комментарии, репосты, воспроизведения и просмотры, а к каждой публикации прилагаются подпись в text, хештеги, упоминания, звук и поля профиля автора.

Параметры TikTok Photo Search API

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово, по которому ищутся публикации с фото.
results_limitНеобязательныйСколько публикаций с фото вернуть, от 1 до 500. По умолчанию 20.

Как использовать TikTok Photo Search API

Выполните поиск по ключевому слову и пролистайте найденные публикации с фото по страницам.

  1. Отправьте {"query": "outfit ideas", "results_limit": 20} методом POST на /v1/tiktok/search-photos.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте публикации с фото из results.items и передавайте обратно results.next_cursor, пока has_more равно true.
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}'

# media holds every image of each carousel, in slide order.

Сценарии использования TikTok Photo Search API

  • Бенчмаркинг формата слайд-шоу: Сопоставляйте число изображений в media с лайками, комментариями, репостами и просмотрами по каруселям одного ключевого слова, чтобы увидеть, какая длина вызывает отклик.
  • Исследование подписей и хештегов: Читайте text и hashtags самых сильных публикаций с фото по ключевому слову, чтобы понять, как авторы формулируют и размечают успешный контент.
  • Доски визуальных трендов: Собирайте изображения слайдов из топовых публикаций по ключевому слову, например outfit ideas, чтобы составлять доски референсов для контента о моде, еде или путешествиях.

Практические советы по TikTok Photo Search API

  • Ранжируйте публикации по сумме лайков, комментариев и репостов, деленной на views_count, а не по числу лайков, чтобы сильная публикация небольшого аккаунта не терялась на фоне крупного; пропускайте публикации, у которых views_count пуст или равен нулю.
  • Запускайте каждую формулировку темы отдельным query, например outfit ideas и ootd, и убирайте дубли по id при объединении результатов: одно слайд-шоу может совпасть с несколькими запросами.
  • Если файлы вам нужны, скачивайте изображения слайдов вскоре после завершения задачи: TikTok отдает их по подписанным ссылкам, срок действия которых истекает.
  • Группируйте публикации по audio.id, а не по audio.title: многие публикации с фото используют собственный звук автора, у которого вместо названия стоит лишь общая метка оригинального звука.

Помимо TikTok Photo Search API, используйте эти API, когда нужен другой тип публичных данных TikTok.

  • TikTok Profiles API — Получайте по имени пользователя публичные данные профиля, описание, признаки аккаунта и счетчики аудитории.
  • TikTok Hashtags API — Собирайте публичные видео, авторов, медиа, звук и вовлеченность по заданным хештегам.
  • TikTok Comments API — Собирайте публичные комментарии верхнего уровня, авторов, вовлеченность, упоминания и признаки взаимодействия с автором видео.
  • TikTok Search API — Ищите публичные видео по ключевому слову с поддерживаемой сортировкой и фильтрами по дате публикации.
  • TikTok Live Room Info API — Получайте данные об одном известном прямом эфире по паре ID эфира и владельца: статус, контекст владельца, обложка и число зрителей.
  • TikTok Comment Keywords API — Находите ключевые слова, которые чаще всего встречаются в комментариях к видео, вместе с самими комментариями.

Другие платформы

Объединяйте данные TikTok с публичными данными других поддерживаемых соцсетей.

TikTok Photo Search API — FAQ

TikTok Photo Search API — это программный интерфейс для поиска фотокаруселей TikTok по ключевому слову. Он возвращает все изображения каждой публикации вместе с подписью, автором, хештегами и числом просмотров, лайков, комментариев и репостов.

Этот эндпоинт возвращает только фотокарусели, видео в результаты не попадают.

На практике да. TikTok называет этот формат публикациями с фото или Photo Mode, а авторы — слайд-шоу или каруселями; каждый результат здесь — одна такая публикация со слайдами в media.

Все. media перечисляет каждое изображение в порядке слайдов, у каждого есть url, width и height.

Нет. Результат содержит лайки, комментарии, репосты, воспроизведения и просмотры, но числа сохранений в нем нет.

Top Search возвращает по ключевому слову видео и фотокарусели вперемешку, а Photo Search оставляет только карусели, поэтому у каждого результата изображения лежат в media.

results_limit принимает значения от 1 до 500, по умолчанию 20. Каждая возвращенная публикация с фото стоит 0,6 кредита, а поиск без подходящих публикаций ничего не стоит.