API AliExpress
Получайте данные о товарах трансграничной торговли, подробные сведения об их вариантах, распределение оценок и отзывы покупателей, чтобы сравнивать товары и собирать мнения потребителей.
Локализуйте поиск с помощью кода страны доставки и валюты отображения. Учтите, что полученный вариант товара не обязательно останется доступным для покупки.
Доступность платформы
- Состояние за 24 ч
- 99%
За последние 30 дней
Доступные возможности
Все действия AliExpress: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Просматривайте карточки товаров AliExpress по ключевому слову. | $1.39 за 1 000 запросовКаждые 50 записей считаются одним вызовом API | Норма |
Сведенияprofile | Откройте ссылку на товар AliExpress и получите страницу товара в виде JSON: название, цены, валюту, рейтинг, число продаж, доставку, данные магазина и признаки наличия. | $1.39 за 1 000 запросов | Норма |
Variantsvariants | Получите варианты и SKU товара AliExpress со свойствами, цветом, изображением и ценой каждой опции, если они указаны в карточке. | $1.39 за 1 000 запросов | Работает стабильно · состояние 99% |
Отзывыreviews | Собирайте отзывы покупателей о товаре AliExpress с оценкой, страной, купленным вариантом, способом доставки, отметками «полезно» и фото. | $1.39 за 1 000 запросов | Норма |
Сводка оценокratings | Получите средний рейтинг в звёздах и общее число отзывов об одном товаре AliExpress. | $1.39 за 1 000 запросов | Норма |
Сведения о товареproduct_detail | Получите полную страницу товара AliExpress: цену и скидку, число проданных единиц, рейтинг, доставку, варианты, атрибуты, общий остаток и сведения о магазине. | $1.39 за 1 000 запросов | Работает стабильно · состояние 99% |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API AliExpress?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Просматривайте карточки товаров AliExpress по ключевому слову. Для каждой карточки доступны текущая и исходная цены, скидка, число заказов, рейтинг, место отправки и данные продавца. Можно задать минимальную цену, минимальный рейтинг и порядок сортировки. Эти показатели относятся к отдельным карточкам и не отражают спрос или маржу. | keyword | min_price, min_rating, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросовКаждые 50 записей считаются одним вызовом API | product_id · title · url · price · original_price · currency · discount · rating · rating_scale · orders_count · review_count · image_url · ships_from · seller_name · category · is_top_rated · free_shipping · images · search_rank · seller_rating · seller_url · platform · tags |
profileСведения Откройте ссылку на товар AliExpress и получите страницу товара в виде JSON: название, цены, валюту, рейтинг, число продаж, доставку, данные магазина и признаки наличия. Несмотря на название, | url | country, currency | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
variantsVariants Получите варианты и SKU товара AliExpress со свойствами, цветом, изображением и ценой каждой опции, если они указаны в карточке. Отсутствие комбинации не означает, что она распродана, а список не является полным учётом остатков. | url | country, currency | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
reviewsОтзывы Собирайте отзывы покупателей о товаре AliExpress с оценкой, страной, купленным вариантом, способом доставки, отметками «полезно» и фото. Если | url | sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · is_anonymous · unhelpful_count · language · original_text · is_translated · review_labels · sku_id · platform · images |
ratingsСводка оценок Получите средний рейтинг в звёздах и общее число отзывов об одном товаре AliExpress. Распределение по звёздам и доли положительных, нейтральных и отрицательных отзывов временно недоступны. Отдельные отзывы получайте через | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · platform |
product_detailСведения о товаре Получите полную страницу товара AliExpress: цену и скидку, число проданных единиц, рейтинг, доставку, варианты, атрибуты, общий остаток и сведения о магазине. | url | country, currency | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
Что означают параметры действия search в API AliExpress?
Просматривайте карточки товаров AliExpress по ключевому слову. Для каждой карточки доступны текущая и исходная цены, скидка, число заказов, рейтинг, место отправки и данные продавца. Можно задать минимальную цену, минимальный рейтинг и порядок сортировки. Эти показатели относятся к отдельным карточкам и не отражают спрос или маржу.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Задаёт поисковый запрос по товарам (например, беспроводные наушники), чтобы получить подборку карточек товаров. Передавайте ключевые слова, а не ID продавцов; сведения о товаре, варианты и отзывы получайте по URL товаров.
min_priceНеобязательный- Задаёт числовой порог минимальной цены товара для поисковых запросов, чтобы исключить более дешёвые товары. Это фильтр по цене товара, а не процент скидки и не бюджет запросов к API; валюта результатов зависит от метаданных поиска.
min_ratingНеобязательный- Фильтрует поиск товаров по минимальному рейтингу по шкале от 0 до 5 (например, 4.5). Учитывается общий рейтинг товара, а не число отзывов, доля положительных отзывов или оценки отдельных отзывов.
sortНеобязательный- Сортирует результаты действия по допустимым значениям. Для search доступны relevance (по умолчанию), popular, price_asc, price_desc и top_rated (поддерживаются устаревшие значения default, orders, rating). Для reviews доступны relevance (по умолчанию) и newest, которое сортирует по дате отправки отзыва, а не по дате публикации карточки товара. Для ratings сортировка не задаётся.Допустимые значения:
popularprice_ascprice_descrelevancetop_rated
Что означают параметры действия profile в API AliExpress?
Откройте ссылку на товар AliExpress и получите страницу товара в виде JSON: название, цены, валюту, рейтинг, число продаж, доставку, данные магазина и признаки наличия. Несмотря на название, profile описывает товар, а не профиль покупателя. Данные об остатках не гарантируют наличие товара на складе.
urlОбязательный- Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html). Используйте url с profile, чтобы получить метаданные товара, с variants для получения SKU, с reviews или ratings для сводок отзывов или с product_detail (это действие также принимает числовой ID товара).
countryНеобязательный- Код страны или региона, например US, для которого profile, variants и product_detail получают данные о товаре (по умолчанию US, приводится к верхнему регистру). Параметр выбирает региональную версию товара и не меняет страну вашего аккаунта или адрес доставки реального заказа.
currencyНеобязательный- Валюта цен товаров, которые возвращают profile, variants и product_detail, например USD (по умолчанию USD, приводится к верхнему регистру). Она меняет только отображаемые цены и не связана с оплатой вызовов API EveryInfra.
Что означают параметры действия variants в API AliExpress?
Получите варианты и SKU товара AliExpress со свойствами, цветом, изображением и ценой каждой опции, если они указаны в карточке. Отсутствие комбинации не означает, что она распродана, а список не является полным учётом остатков.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html). Используйте url с profile, чтобы получить метаданные товара, с variants для получения SKU, с reviews или ratings для сводок отзывов или с product_detail (это действие также принимает числовой ID товара).AliExpress: SKU-атрибуты и общие атрибуты категории — Эндпоинты открытой платформы для получения атрибутов разделяют SKU-атрибуты и общие атрибуты категории и возвращают такие поля, как название атрибута, значение атрибута и признак обязательности. Это пояснение нужно только для терминологии вариантов товаров AliExpress и не означает, что этот эндпоинт поддерживает размещение товаров или гарантирует возврат всех комбинаций категорий. · Проверено
countryНеобязательный- Код страны или региона, например US, для которого profile, variants и product_detail получают данные о товаре (по умолчанию US, приводится к верхнему регистру). Параметр выбирает региональную версию товара и не меняет страну вашего аккаунта или адрес доставки реального заказа.
currencyНеобязательный- Валюта цен товаров, которые возвращают profile, variants и product_detail, например USD (по умолчанию USD, приводится к верхнему регистру). Она меняет только отображаемые цены и не связана с оплатой вызовов API EveryInfra.
Что означают параметры действия reviews в API AliExpress?
Собирайте отзывы покупателей о товаре AliExpress с оценкой, страной, купленным вариантом, способом доставки, отметками «полезно» и фото. Если is_translated равно true, text содержит перевод, а в original_text хранится исходный текст автора.
urlОбязательный- Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html). Используйте url с profile, чтобы получить метаданные товара, с variants для получения SKU, с reviews или ratings для сводок отзывов или с product_detail (это действие также принимает числовой ID товара).
sortНеобязательный- Сортирует результаты действия по допустимым значениям. Для search доступны relevance (по умолчанию), popular, price_asc, price_desc и top_rated (поддерживаются устаревшие значения default, orders, rating). Для reviews доступны relevance (по умолчанию) и newest, которое сортирует по дате отправки отзыва, а не по дате публикации карточки товара. Для ratings сортировка не задаётся.Допустимые значения:
newestrelevance
Что означают параметры действия ratings в API AliExpress?
Получите средний рейтинг в звёздах и общее число отзывов об одном товаре AliExpress. Распределение по звёздам и доли положительных, нейтральных и отрицательных отзывов временно недоступны. Отдельные отзывы получайте через reviews.
urlОбязательный- Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html). Используйте url с profile, чтобы получить метаданные товара, с variants для получения SKU, с reviews или ratings для сводок отзывов или с product_detail (это действие также принимает числовой ID товара).
Что означают параметры действия product_detail в API AliExpress?
Получите полную страницу товара AliExpress: цену и скидку, число проданных единиц, рейтинг, доставку, варианты, атрибуты, общий остаток и сведения о магазине. country и currency задают региональный контекст, а sold_text содержит округлённое значение со страницы, а не точное число.
urlОбязательный- Задаёт целевой товар AliExpress полным URL (например, https://www.aliexpress.com/item/<item_id>.html). Используйте url с profile, чтобы получить метаданные товара, с variants для получения SKU, с reviews или ratings для сводок отзывов или с product_detail (это действие также принимает числовой ID товара).
countryНеобязательный- Код страны или региона, например US, для которого profile, variants и product_detail получают данные о товаре (по умолчанию US, приводится к верхнему регистру). Параметр выбирает региональную версию товара и не меняет страну вашего аккаунта или адрес доставки реального заказа.
currencyНеобязательный- Валюта цен товаров, которые возвращают profile, variants и product_detail, например USD (по умолчанию USD, приводится к верхнему регистру). Она меняет только отображаемые цены и не связана с оплатой вызовов API EveryInfra.
Как использовать API AliExpress
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"aliexpress","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API AliExpress
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Монетизация парсинга цен: как построить продукт мониторинга цен, который продавцы будут продлевать
Почему продавцы платят за мониторинг цен и почему отменяют подписку. Разбираем способы поставки ценовых данных, единицы тарификации и приёмку пилота через сопоставление товаров, списки исключений и процессы согласования цен.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюСбои API, возврат кредитов и сверка: как проверить чистое списание за запрос
Разделяйте задачи, попытки вызова, состояния доставки и события кошелька, чтобы без двойного учёта обрабатывать отказы до списания, пустые результаты и частичный возврат кредитов; офлайн-примеры построены на целых числах.
Читать статьюВопросы об API AliExpress
Какие данные можно получить через API AliExpress?
Укажите в platform значение aliexpress. В текущем каталоге: поиск, сведения, variants, отзывы, сводка оценок и more. Эти названия действий соответствуют разным объектам или представлениям AliExpress; это не взаимозаменяемые режимы поиска.
Есть ли у AliExpress официальный API?
У AliExpress Open Platform есть API для продавцов (они работают только с магазинами, авторизовавшими ваше приложение, и охватывают их собственные товары и заказы), для партнёров (сначала нужно зарегистрироваться в AliExpress Portals как издатель и получить одобрение профиля разработчика) и для дропшипперов.
Официальные источники: «AliExpress Open Platform: Global APIs overview» · «AliExpress Open Platform: affiliate quick start» · Проверено
Нужен ли аккаунт разработчика AliExpress или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика AliExpress, запрашивать доступ к API AliExpress или входить через аккаунт AliExpress. Действия возвращают только публичные данные AliExpress.
Сколько стоит AliExpress API за 1 000 запросов?
$1.39 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе AliExpress?
Задаёт поисковый запрос по товарам (например, беспроводные наушники), чтобы получить подборку карточек товаров. Передавайте ключевые слова, а не ID продавцов; сведения о товаре, варианты и отзывы получайте по URL товаров. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе AliExpress?
Объявленная схема включает product_id, title, price и original_price. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия AliExpress возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.