API AliExpress Variants

POST

Состояние API

Состояние за 24 ч: 98%
Среднее время за 24 ч: 29.80 s

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Работает стабильно

Последние 24 часа

Последние 30 дней

Получите варианты и SKU товара AliExpress со свойствами, цветом, изображением и ценой каждой опции, если они указаны в карточке. Отсутствие комбинации не означает, что она распродана, а список не является полным учётом остатков.

Те же параметры и поля, что и у product_detail, но результат возвращается, только если у товара есть список вариантов SKU; товар без такого списка считается пустым результатом и не оплачивается.

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

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: aliexpress и action: variants, а параметры передайте в 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": "variants",
  "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 время и повторите попытку.

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

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

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`platform`	body	`string`	Да	`aliexpress`	Идентификатор платформы, фиксированное значение.
`action`	body	`string`	Да	`variants`	Идентификатор возможности, фиксированное значение.
`url`	body.params	`string`	Да	-	Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html). Используйте url с profile, чтобы получить метаданные товара, с variants для получения SKU, с reviews или ratings для сводок отзывов или с product_detail (это действие также принимает числовой ID товара).
`country`	body.params	`string`	Нет	-	Код страны или региона, например US, для которого profile, variants и product_detail получают данные о товаре (по умолчанию US, приводится к верхнему регистру). Параметр выбирает региональную версию товара и не меняет страну вашего аккаунта или адрес доставки реального заказа.
`currency`	body.params	`string`	Нет	-	Валюта цен товаров, которые возвращают 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": "variants",
  "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": "variants",
  "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_id`	ID категории AliExpress.
`category_path`	Путь категорий AliExpress.
`ship_to`	Страна или регион доставки, к которым относятся эта цена и расчёт доставки.
`total_stock`	Общий остаток по всем вариантам; остаток каждого варианта указан в его записи в variants.
`video_url`	Ссылка на видео товара.
`store_id`	ID магазина.
`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).

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

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

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

AliExpress: SKU-атрибуты и общие атрибуты категории ↗
Эндпоинты открытой платформы для получения атрибутов разделяют SKU-атрибуты и общие атрибуты категории и возвращают такие поля, как название атрибута, значение атрибута и признак обязательности. Это пояснение нужно только для терминологии вариантов товаров AliExpress и не означает, что этот эндпоинт поддерживает размещение товаров или гарантирует возврат всех комбинаций категорий.
Проверено 2026-09-05