API Shopee Сведения
Состояние API
- Состояние за 24 ч
- 98%
- Среднее время за 24 ч
- 42.20 s
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Откройте страницу товара Shopee по полному url: описание, диапазон цен по вариантам, остаток, число продаж, лайки, бренд и статус предзаказа. Несмотря на название, это действие описывает товар, а не покупателя или продавца. Сокращённые ссылки сначала разверните до конечной страницы.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Shopee Сведения (shopee/profile).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: shopee и action: profile, а параметры передайте в params.
- Обязательные параметры:
- url: Полный URL товара Shopee для profile и product_detail. profile извлекает идентификаторы по шаблону i.shop_id.product_id.
- Необязательные параметры:
- country: Код региона; имеет приоритет над region и определением по URL. Для search, profile и shop по умолчанию используется id (Индонезия). (допустимые значения: br / cl / co / id / mx / my / ph / sg)
- Возвращает один объект. Основные поля: shop_id, item_id, name, url, description, price, price_min, price_max, original_price, discount_pct, currency, rating; всего полей: 23, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=shopee.
- Пример тела запроса:
{
"platform": "shopee",
"action": "profile",
"params": {
"url": "https://shopee.co.id/Case-Casing-for-iPhone-XS-X-6-6s-13-XR-SE2-8-7Plus-15-PlusProMax-12-Max-SE3-Plus-14-XS-11-soft-case-hp-lucu-unik-KQ04060401-i.1761879954.56511647417"
}
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | shopee | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | profile | Идентификатор возможности, фиксированное значение. |
url | body.params | string | Да | - | Полный URL товара Shopee для profile и product_detail. profile извлекает идентификаторы по шаблону i.shop_id.product_id. Короткие ссылки сначала нужно развернуть до URL конечной страницы, их прямой разбор не гарантируется. |
country | body.params | string (enum) | Нет | - | Код региона; имеет приоритет над region и определением по URL. Для search, profile и shop по умолчанию используется id (Индонезия). Распознаются домены sg, my, th, ph, vn, br, tw, mx, co и cl, но распознанный домен не гарантирует наличие данных для каждого региона. product_detail обычно берёт регион из URL товара.Допустимые значенияbrclcoidmxmyphsgthtwvn |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "shopee",
"action": "profile",
"params": {
"url": "https://shopee.co.id/Case-Casing-for-iPhone-XS-X-6-6s-13-XR-SE2-8-7Plus-15-PlusProMax-12-Max-SE3-Plus-14-XS-11-soft-case-hp-lucu-unik-KQ04060401-i.1761879954.56511647417"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "shopee",
"action": "profile",
"results": {
"shop_id": 1761879954,
"item_id": 56511647417,
"name": "Case Casing for iPhone XS X 6 6s 13 XR SE2 8 7Plus 15 PlusProMax 12 Max SE3 Plus 14 XS 11 soft case hp lucu unik KQ04060401",
"description": "Selamat datang!\nPesanan yang dilakukan sebelum pukul 12 siang akan dikirim pada hari yang sama dan pesanan yang dilakukan setelah pukul 12 siang akan dikirim keesokan harinya dalam kondisi normal (kecuali dalam kondisi khusus), kecuali hari libur dan acara khusus.\n\n\nPengiriman Lo…",
"price": 17000,
"price_min": 17000,
"price_max": 17000,
"discount_pct": 73,
"currency": "IDR",
"rating": 4.9,
"rating_count": [],
"sold_count": 5000,
"is_pre_order": false,
"has_video": true,
"platform": "shopee",
"images": [
"https://down-id.img.susercontent.com/file/sg-11134201-823qk-mp1vma3mmole2f",
"https://down-id.img.susercontent.com/file/sg-11134201-823pe-mp1vmbgs9t7149",
"https://down-id.img.susercontent.com/file/sg-11134201-823q5-mp1vmcnrxrf175"
],
"shop": {
"shop_id": 1761879954,
"name": "case lucu id",
"username": "•••",
"location": "KAB. TANGERANG",
"rating": 4.872473,
"item_count": 2815,
"follower_count": 1764,
"response_rate": 97,
"is_official_shop": false,
"is_shopee_verified": false
},
"rating_scale": 5
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
shop_id | Трактуется так же, как на самой платформе |
item_id | Трактуется так же, как на самой платформе |
name | Название самого объекта для возможностей по аккаунтам, товарам и компаниям. |
url | Ссылка на запись на платформе. |
description | Краткое содержание или описание, обычно короче text. |
price | Цена числом без символа валюты; см. currency. |
price_min | Трактуется так же, как на самой платформе |
price_max | Трактуется так же, как на самой платформе |
original_price | Трактуется так же, как на самой платформе |
discount_pct | Трактуется так же, как на самой платформе |
currency | Код валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте. |
rating | Рейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным. |
rating_scale | Максимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг. |
rating_count | Количество оценивших. null означает, что значение не раскрыто, а не 0. |
sold_count | Трактуется так же, как на самой платформе |
stock | Трактуется так же, как на самой платформе |
liked_count | Трактуется так же, как на самой платформе |
view_count | Просмотры или воспроизведения. null означает, что значение не раскрыто, а не 0. |
brand | Трактуется так же, как на самой платформе |
is_pre_order | Трактуется так же, как на самой платформе |
has_video | Трактуется так же, как на самой платформе |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
images | Массив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет. |
shop | Трактуется так же, как на самой платформе |
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.
Официальные источники
Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.
- Shopee: где найти Shop ID и Item ID ↗
Обучающие материалы Shopee для продавцов разделяют Shop ID, Item ID, имя пользователя и отображаемое название магазина и предупреждают, что эти идентификаторы нельзя путать. Здесь эти термины приводятся без гарантии, что действия в панели продавца в других регионах будут такими же.
Проверено 2026-09-04