tiktok-shop/
product

Получайте публичный товар TikTok Shop по URL страницы товара (PDP): идентификация, продавец, цена, видимые рейтинги и продажи, медиа, категории и SKU в одной нормализованной записи.

TikTok Shop Product API

Публичные данные о товаре
URL PDP на входе
Одна нормализованная запись
0,7 кредита за результат
Готово
Готово

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

README

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

TikTok Shop Product

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

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

  • Детали одной страницы PDPОтправьте один поддерживаемый URL публичной страницы товара TikTok Shop и получите не более одной нормализованной записи товара: эндпоинт подходит для обогащения известного товара, а не для поиска товаров.
  • Продавец, цена и видимые торговые показателиЗапись товара сохраняет доступные данные о продавце, цену продажи и исходную цену, валюту, скидку, рейтинг, число отзывов и число продаж для прямой оценки по каждому полю.
  • Медиа, категории и SKUВозвращаемые записи содержат доступные изображения товара с размерами, а также структуру категорий и SKU или вариантов с публичной страницы товара.

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

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный URL публичного товара TikTok Shop вида /shop/pdp/{numeric_id} или /shop/pdp/{slug}/{numeric_id}; одна задача принимает один товар.
regionНеобязательныйНеобязательный регион рынка TikTok Shop; по умолчанию US, при этом доступность товаров в других поддерживаемых регионах может различаться.

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

Отправьте поддерживаемый URL товара, сохраните ID асинхронной задачи и прочитайте нормализованный товар после успешного завершения задачи.

  1. Отправьте POST-запрос на /v1/tiktok-shop/product с одним поддерживаемым url страницы PDP и необязательным region.
  2. Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  3. После успешного завершения читайте data.results.items и переходите по next_cursor, только если has_more равно true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

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

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

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

  • Перед отправкой проверяйте, что на входе полный URL страницы товара на tiktok.com с числовым ID товара, иначе запрос будет отклонен.
  • Оставляйте region равным US, если товар не относится к другому поддерживаемому рынку, а пустой результат для региона вне US считайте возможной границей доступности.
  • Не передавайте results_limit: одна задача принимает один URL товара и возвращает не более одной нормализованной записи.
  • Считайте поля продавца, цены, показателей, медиа, категорий и SKU, которые могут быть null, снимком публичной страницы, а успешную задачу без элемента обрабатывайте, не создавая товар-заглушку.

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

  • TikTok Shop Search API — Ищите публичные товары TikTok Shop по ключевому слову и региону рынка: продавец, цена, медиа, рейтинг, отзывы и число продаж.
  • TikTok Shop Products API — Собирайте публичные товары по URL одного магазина TikTok Shop: продавец, цена, медиа, категория, 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 Categories API — Получайте полное дерево категорий рынка TikTok Shop: ID, названия, английские slug, уровни, родители и пути.

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

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

TikTok Shop Product API — FAQ

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

Используйте URL на tiktok.com или поддомене TikTok, путь которого имеет вид /shop/pdp/{numeric_id} или /shop/pdp/{slug}/{numeric_id}. Другие URL TikTok отклоняются как некорректные входные данные.

Нет. Каждая задача принимает один URL товара, не принимает results_limit и возвращает не более одной нормализованной записи товара.

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

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

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