tiktok-shop/
search

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

TikTok Shop Search API

Поиск товаров
Региональные каталоги
Торговые показатели
0,7 кредита за результат
Готово
Готово

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

README

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

TikTok Shop Search

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

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

  • Ключевое слово и выбор рынкаСочетайте товарный запрос с одним из 16 поддерживаемых значений региона, чтобы искать в нужном публичном каталоге рынка.
  • Ограниченный сбор уникальных товаровЗапрашивайте от 20 до 2 000 результатов; страницы сбора очищаются от дубликатов по публичному идентификатору товара.
  • Идентификация товара и продавцаВозвращает ID товаров, названия, описания, канонические ссылки и доступные данные о продавце или магазине.
  • Цены и видимые торговые показателиСохраняет цену продажи, исходную цену, валюту, скидку, рейтинг, число отзывов и число продаж, если они доступны.
  • Медиа и контекст товараХранит с каждой записью публичные изображения, категории, структуры SKU, статус, поисковый запрос, регион и время сбора.

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

ПараметрыОбязательныйОписание
queryОбязательныйОбязательное непустое ключевое слово или фраза для поиска товаров.
results_limitНеобязательныйЗапрашиваемый лимит уникальных результатов от 20 до 2 000. По умолчанию 100.
regionНеобязательныйРегион рынка: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP или IE. По умолчанию US.

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

Выберите конкретную товарную фразу и рынок, а затем отправьте один асинхронный поисковый запрос.

  1. Задайте непустой query, выберите поддерживаемый region и укажите results_limit от 20 до 2 000.
  2. Отправьте запрос методом POST на /v1/tiktok-shop/search и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. Читайте data.results.items. Если has_more равно true, продолжайте с next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Поиск товаров по регионам: Составляйте карту публичных товаров, соответствующих категории, потребности, бренду или товарной фразе на выбранном рынке.
  • Сравнение цен и скидок: Сравнивайте доступные поля цены продажи, исходной цены, валюты и скидки у возвращенных товаров.
  • Сравнение репутации и спроса: Сравнивайте доступные рейтинги, число отзывов и число продаж, не превращая отсутствующие метрики в ноль.
  • Шорт-лист товаров и магазинов: Используйте ссылки на товары, данные о продавце, изображения, категории и SKU, чтобы отбирать кандидатов для более детального анализа.

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

  • Всегда сохраняйте query и region вместе: одна и та же фраза может давать результаты из разных публичных каталогов.
  • Задавайте results_limit по нужному объему и переходите по next_cursor, пока has_more не станет false, чтобы прочитать весь результат задачи.
  • Считайте отсутствующие цену, рейтинг, число отзывов или число продаж недоступными, а не нулевыми.
  • Сохраняйте search_query и collected_at с каждой записью, чтобы региональные снимки оставались воспроизводимыми.
  • Передавайте выбранный URL страницы товара в TikTok Shop Product API, когда нужно свежее обогащение на уровне деталей товара.

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

  • TikTok Shop Products API — Собирайте публичные товары по URL одного магазина TikTok Shop: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
  • TikTok Shop Product API — Получайте один публичный товар TikTok Shop по URL карточки товара: продавец, цена, медиа, категория, SKU, рейтинг, отзывы и число продаж.
  • TikTok Shop Product Reviews API — Собирайте публичные отзывы по URL одной карточки товара TikTok Shop: текст, оценка, автор, изображения, SKU, страна и контекст покупки.
  • TikTok Shop User Showcase API — Собирайте публичные товары с витрины одного пользователя TikTok: цена, продавец, медиа, рейтинг, отзывы, число продаж и региональный контекст.
  • TikTok Shop Hot Products API — Собирайте самые продаваемые товары рынка TikTok Shop по коду региона в порядке рейтинга: цена, валюта, продажи, оценка и магазин.
  • TikTok Shop Search Suggestions API — Получайте до 20 ранжированных подсказок, которые TikTok Shop предлагает для начала покупательского запроса на одном рынке.

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

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

TikTok Shop Search API — FAQ

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

Нет. TikTok Shop Search — это отдельный торговый эндпоинт для публичных товаров, а TikTok Search находит публичные видео и контент авторов в соцсети.

query обязателен, results_limit — целое число от 20 до 2 000 со значением по умолчанию 100, а region по умолчанию равен US.

Поддерживаются значения US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP и IE. Доступность товаров за пределами США зависит от публичного каталога конкретного рынка.

Результаты могут содержать данные о товаре и продавце, канонический URL, описание, изображения, сведения о цене, категории, SKU, статус, рейтинг, число отзывов, число продаж, регион, запрос и время сбора.

На выбранном публичном рынке может быть меньше подходящих товаров, а сбор останавливается, когда после удаления дубликатов страниц источника больше нет. Поэтому успешная задача может не содержать элементов или содержать меньше элементов, чем запрошено.

Опрашивайте /v1/tasks/{task_id}, после успешного завершения читайте data.results.items и запрашивайте следующую страницу результатов задачи с next_cursor, пока has_more равно true.

Каждый возвращенный нормализованный товар стоит 0,7 кредита SocQ. За пустые результаты плата не взимается.