TikTok Shop Search Suggestions
TikTok Shop Search Suggestions — это автодополнения, которые поисковая строка магазина предлагает, пока покупатель печатает, и каждое из них представляет собой полную ключевую фразу с позицией в списке и рынком, на котором она предложена. Поскольку они основаны на реальных поисках людей, эти фразы показывают варианты товаров, совместимые модели и покупательские мотивы, на которые стоит ориентировать названия товаров, рекламу и контент.
Возможности TikTok Shop Search Suggestions API
- Автодополнения для начала запросаquery принимает первые слова поиска, например phone case, и каждая строка возвращает более длинную фразу, которой покупатели его завершают, например phone cases 17 pro max.
- Собственный порядок подсказок TikTok Shoprank нумерует подсказки от 1 в том порядке, в каком их показывает TikTok Shop, до 20 на запрос.
- Подсказки по рынкамregion выбирает один из рынков US, SG, MY, PH, TH, VN, ID, JP и MX, по умолчанию US, а каждая строка повторяет свои query и region, так что результаты легко отследить.
Параметры TikTok Shop Search Suggestions API
| Параметры | Обязательный | Описание |
|---|---|---|
query | Обязательный | Начало покупательского запроса, которое нужно дополнить, например phone case. |
region | Необязательный | Рынок поиска: US, SG, MY, PH, TH, VN, ID, JP или MX. По умолчанию US. |
Как использовать TikTok Shop Search Suggestions API
Отправьте первые слова покупательского запроса и прочитайте автодополнения по порядку.
- Отправьте {"query": "phone case", "region": "US"} методом POST на /v1/tiktok-shop/search-suggestions.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте keyword и rank из results.items; когда has_more равно true, получите остаток с results.next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"phone case","region":"US"}'Сценарии использования TikTok Shop Search Suggestions API
- Выбор ключевых слов для названий товаров: Выбирайте ключевые фразы с моделями, размерами или вариантами и включайте их в названия и описания товаров.
- Наборы ключевых слов для рекламы и контента: Собирайте столбец keyword по нескольким исходным запросам, чтобы составить списки ключевых слов для рекламы, подписей к видео и планирования контента.
- Отслеживание изменений подсказок: Периодически повторяйте те же query и region и сравнивайте rank по каждому keyword, чтобы видеть, какие фразы поднимаются, опускаются или появляются впервые.
- Сравнение того, как рынки завершают запрос: Отправьте один query в несколько регионов и сопоставьте списки keyword, чтобы увидеть, как покупатели на каждом рынке дополняют одни и те же слова.
Практические советы по TikTok Shop Search Suggestions API
- Начинайте с короткой основы, а не с полной фразы: подсказки продолжают начало запроса, и длинной фразе почти нечего дополнять.
- Спускайтесь на уровень глубже, отправляя полученный keyword как новый query, — так одна основа превращается в дерево более длинных фраз.
- Удаляйте дубликаты результатов из нескольких основ по keyword, который также служит id строки: близкие основы могут вернуть одну и ту же фразу.
- Передавайте перспективный keyword в TikTok Shop Search с тем же region, чтобы увидеть товары за этой подсказкой.
Связанные API
Помимо TikTok Shop Search Suggestions API, используйте эти API, когда нужен другой тип публичных данных TikTok Shop.
- TikTok Shop Search 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 Hot Products API — Собирайте самые продаваемые товары рынка TikTok Shop по коду региона в порядке рейтинга: цена, валюта, продажи, оценка и магазин.
- TikTok Shop Categories API — Получайте полное дерево категорий рынка TikTok Shop: ID, названия, английские slug, уровни, родители и пути.