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
Выберите конкретную товарную фразу и рынок, а затем отправьте один асинхронный поисковый запрос.
- Задайте непустой query, выберите поддерживаемый region и укажите results_limit от 20 до 2 000.
- Отправьте запрос методом POST на /v1/tiktok-shop/search и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- Читайте 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, когда нужно свежее обогащение на уровне деталей товара.
Связанные 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 предлагает для начала покупательского запроса на одном рынке.