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
Выполните поиск по ключевому слову и пролистайте найденные публикации с фото по страницам.
- Отправьте {"query": "outfit ideas", "results_limit": 20} методом POST на /v1/tiktok/search-photos.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте публикации с фото из 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: многие публикации с фото используют собственный звук автора, у которого вместо названия стоит лишь общая метка оригинального звука.
Связанные API
Помимо 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 Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API