tiktok-shop/
search-suggestions

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

TikTok Shop Search Suggestions API

Начало запроса на входе
До 20 автодополнений
Позиции от 1
0,5 кредита за запрос
Готово
Готово

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

README

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

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

Отправьте первые слова покупательского запроса и прочитайте автодополнения по порядку.

  1. Отправьте {"query": "phone case", "region": "US"} методом POST на /v1/tiktok-shop/search-suggestions.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте 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, чтобы увидеть товары за этой подсказкой.

Помимо 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, уровни, родители и пути.

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

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

TikTok Shop Search Suggestions API — FAQ

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

Каждый запрос принимает один query. Чтобы охватить несколько исходных слов, отправьте по запросу на каждое и объедините результаты по keyword.

Каждый вызов стоит 0,5 кредита и возвращает до 20 подсказок; цена указана за вызов, а не за подсказку.