Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

EveryInfra
Поиск⌘K
Русский
ВойтиНачать бесплатно

API AliExpress Сведения о товаре

POST

Состояние API

Состояние за 24 ч
99%
Среднее время за 24 ч
28.78 s
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Работает стабильно

Получите полную страницу товара AliExpress: цену и скидку, число проданных единиц, рейтинг, доставку, варианты, атрибуты, общий остаток и сведения о магазине. country и currency задают региональный контекст, а sold_text содержит округлённое значение со страницы, а не точное число.

AliExpress Product details читает один товар AliExpress по ссылке на него или по числовому ID и возвращает всю карточку товара: название, описание, текущую цену, зачёркнутую исходную цену, скидку, валюту, число продаж, рейтинг и число отзывов, стоимость и способ доставки, варианты, название и ссылку магазина, галерею изображений в том же порядке, что и на странице товара, и изображения из описания. Дропшипперы, трансграничные продавцы и команды закупок используют эту возможность, чтобы проверить товар перед размещением, следить за ценами и условиями доставки поставщика или переносить точные характеристики в свой каталог.

country (по умолчанию США) задаёт регион, из которого просматривается товар, а currency (по умолчанию доллары США) — валюту отображаемых цен. Чтобы увидеть реальную скидку, сравните original_price с price. Прежде чем называть товар дешёвым, посмотрите shipping: стоимость доставки входит в сумму, которую платит покупатель. images сохраняет галерею в том порядке, в котором её показывает страница товара, а variants перечисляет варианты, из которых может выбирать покупатель.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra AliExpress Сведения о товаре (aliexpress/product_detail).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: aliexpress и action: product_detail, а параметры передайте в params.
- Обязательные параметры:
  - url: Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html).
- Необязательные параметры:
  - country: Код страны или региона, например US, для которого profile, variants и product_detail получают данные о товаре (по умолчанию US, приводится к верхнему регистру).
  - currency: Валюта цен товаров, которые возвращают profile, variants и product_detail, например USD (по умолчанию USD, приводится к верхнему регистру).
- Возвращает один объект. Основные поля: id, url, name, text, price, original_price, currency, discount, sold_count, rating, rating_scale, review_count; всего полей: 36, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=aliexpress.
- Пример тела запроса:
{
  "platform": "aliexpress",
  "action": "product_detail",
  "params": {
    "url": "https://www.aliexpress.com/item/3256806025886958.html"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаaliexpressИдентификатор платформы, фиксированное значение.
actionbodystringДаproduct_detailИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html). Используйте url с profile, чтобы получить метаданные товара, с variants для получения SKU, с reviews или ratings для сводок отзывов или с product_detail (это действие также принимает числовой ID товара).
countrybody.paramsstringНет-Код страны или региона, например US, для которого profile, variants и product_detail получают данные о товаре (по умолчанию US, приводится к верхнему регистру). Параметр выбирает региональную версию товара и не меняет страну вашего аккаунта или адрес доставки реального заказа.
currencybody.paramsstringНет-Валюта цен товаров, которые возвращают profile, variants и product_detail, например USD (по умолчанию USD, приводится к верхнему регистру). Она меняет только отображаемые цены и не связана с оплатой вызовов API EveryInfra.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "aliexpress",
  "action": "product_detail",
  "params": {
    "url": "https://www.aliexpress.com/item/3256806025886958.html"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено October 24, 2026 at 18:28 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "aliexpress",
  "action": "product_detail",
  "results": {
    "id": "•••",
    "url": "https://www.aliexpress.com/item/3256806025886958.html",
    "name": "Thermal Underwear Tops Men Spring Clothes Thermal Shirt Autumn Men's Winter Tights High Neck Thin Slim Fit Long Sleeve T-shirt",
    "price": 1.91,
    "original_price": 11.06,
    "currency": "USD",
    "discount": 83,
    "rating": 4.4,
    "review_count": 404,
    "shipping": [
      {
        "method": "AliExpress Selection Standard Shipping",
        "free_shipping": false,
        "ship_from": "China",
        "ship_to": "US",
        "delivery_days_min": 8,
        "delivery_days_max": 13,
        "estimated_delivery": "Nov. 01 – Nov. 06",
        "tracking": true
      }
    ],
    "variants": [
      {
        "sku_id": "12000036301240276",
        "properties": {
          "Color": "Dark Grey",
          "Size": "S"
        },
        "price": 2.23,
        "original_price": 11.78,
        "stock": 6,
        "available": true,
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sd1b109e7315a4b0bb6a0e676dbe81f11N.jpg",
        "max_buy_count": 1
      },
      {
        "sku_id": "12000036301240277",
        "properties": {
          "Color": "Dark Grey",
          "Size": "M"
        },
        "price": 2.43,
        "original_price": 12.22,
        "stock": 3,
        "available": true,
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sd1b109e7315a4b0bb6a0e676dbe81f11N.jpg",
        "max_buy_count": 1
      },
      {
        "sku_id": "12000036301240278",
        "properties": {
          "Color": "Dark Grey",
          "Size": "L"
        },
        "price": 2.21,
        "original_price": 11.74,
        "stock": 0,
        "available": false,
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sd1b109e7315a4b0bb6a0e676dbe81f11N.jpg",
        "max_buy_count": 0
      }
    ],
    "store_name": "Shop1102888504 Store",
    "store_url": "https://www.aliexpress.com/store/1102892506",
    "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S702341bd952e48d19070fda1b1b2c15eI.jpg",
    "images": [
      "https://ae-pic-a1.aliexpress-media.com/kf/S702341bd952e48d19070fda1b1b2c15eI.jpg",
      "https://ae-pic-a1.aliexpress-media.com/kf/S2259b7a7b87445c484e782f739f76593E.jpg",
      "https://ae-pic-a1.aliexpress-media.com/kf/S6e96c6eeaa8b44d3bd0189288bd92471o.jpg"
    ],
    "price_max": 3.15,
    "original_price_max": 13.84,
    "sold_text": "2,000+ sold",
    "attributes": [
      {
        "name": "Special Features",
        "value": "Lightweight"
      },
      {
        "name": "Product Care Instructions",
        "value": "Dry Clean Only"
      },
      {
        "name": "Closure Type",
        "value": "Pull On"
      }
    ],
    "category_id": "200000783",
    "category_path": "•••/•••/•••",
    "ship_to": "US",
    "total_stock": 96,
    "video_url": "https://video.aliexpress-media.com/play/u/ae_sg_item/2215998649727/p/1/e/6/t/10301/5000232324880.mp4",
    "store_id": "1102892506",
    "seller_id": "•••",
    "store_country": "China",
    "store_opened_at": "2023-06-12 01:35:24",
    "store_positive_rate": "93.9%",
    "store_sold_180d": "20,000+",
    "store_is_top_rated": false,
    "platform": "aliexpress",
    "rating_scale": 5
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
urlСсылка на запись на платформе.
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
priceЦена числом без символа валюты; см. currency.
original_priceТрактуется так же, как на самой платформе
currencyКод валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте.
discountТрактуется так же, как на самой платформе
sold_countТрактуется так же, как на самой платформе
ratingРейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным.
rating_scaleМаксимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг.
review_countКоличество отзывов для возможностей по товарам и компаниям. null означает, что значение не раскрыто, а не 0.
shippingТрактуется так же, как на самой платформе
variantsСписок SKU, по одной записи на вариант: sku_id, properties (название опции → значение, например Color и Size), price, original_price, stock, available, image_url и max_buy_count; ключи, которые платформа не показывает, не включаются.
store_nameТрактуется так же, как на самой платформе
store_urlТрактуется так же, как на самой платформе
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
imagesСсылки на изображения: для возможностей, связанных с товарами, — галерея товара в порядке расположения изображений на странице; для reviews — фотографии покупателя.
description_imagesТрактуется так же, как на самой платформе
price_maxВерхняя граница диапазона цен для товаров, варианты которых стоят по-разному.
original_price_maxВерхняя граница диапазона цен до скидки для товаров с несколькими вариантами.
sold_textПоказатель продаж в том виде, как он отображается (например, «10 000+ продано»); это округлённое, а не точное значение.
attributesХарактеристики товара в виде записей {name, value} (материал, модель и т. д.).
category_idID категории AliExpress.
category_pathПуть категорий AliExpress.
ship_toСтрана или регион доставки, к которым относятся эта цена и расчёт доставки.
total_stockОбщий остаток по всем вариантам; остаток каждого варианта указан в его записи в variants.
video_urlСсылка на видео товара.
store_idID магазина.
seller_idПубличный ID продавца, присвоенный AliExpress.
store_countryСтрана или регион магазина.
store_opened_atКогда открылся магазин.
store_positive_rateДоля положительных отзывов о магазине в том виде, как она показана (например, 95,2 %).
store_ratingРейтинг магазина.
store_sold_180dПродажи магазина за последние 180 дней в том виде, как они показаны.
store_is_top_ratedИмеет ли магазин статус продавца AliExpress Top Rated.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Можно ли передать ID товара вместо ссылки?

Да. Эта возможность принимает как числовой ID товара, так и ссылку вида https://www.aliexpress.com/item/<product ID>.html; страница магазина или поиска не подойдёт. Другие возможности AliExpress, которые читают товар, например Reviews и Variants, требуют ссылку на товар, поэтому храните её вместе с ID.

На что влияют country и currency?

country выбирает регион, из которого просматривается товар, например US, а currency — валюту, в которой показаны цены. Оба значения автоматически переводятся в верхний регистр. Они ничего не меняют в вашем аккаунте, не задают адрес доставки и не влияют на валюту, в которой оплачиваются вызовы API. Сохраняйте оба значения с каждой записанной ценой, чтобы не смешивать цены, полученные для разных регионов.

Как получить отзывы и распределение оценок для этого товара?

Передайте ту же ссылку на товар в AliExpress Reviews, чтобы получить отдельные отзывы покупателей с текстом, звёздами, вариантом и страной, или в AliExpress Rating summary, чтобы получить распределение по числу звёзд и доли положительных, нейтральных и отрицательных оценок. Здесь rating и review_count дают только общие показатели товара.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки