AliExpress · Поиск товаров

Бета

Публичные данные соцсетей с оплатой за вызов — тот же ключ API и тот же баланс, что и для вызовов моделей.

Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC. · Вызов оплачивается, только если он вернул HTTP 200 и непустое поле data; пустые результаты, отклонённые параметры и сбои источника не оплачиваются.

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

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

Название	Тип	Обязательный	Пример	Описание
`keyword`	string	Да	`"coffee cup"`	Search keyword. Results are normalized product records, not the raw platform response.
`limit`	integer	Нет	`5`	Maximum records returned per call: 5. Price covers this single bounded batch; larger requests are rejected before dispatch. По умолчанию `5`

Пример запроса

curl --get "https://api.chinaapi.ai/v1/social/aliexpress/product-search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=coffee cup'

Структура ответа

Успешный ответ возвращает данные эндпоинта в data: исходные данные платформы либо объект/массив в едином формате. Проверьте схему и поле data_type в каталоге, если оно есть. Передавайте токены пагинации без изменений тому же эндпоинту.

{
  "object": "social.result",
  "platform": "aliexpress",
  "capability": "product-search",
  "data": { … }
}

Пагинация

У этого эндпоинта нет параметров пагинации.

Ошибки и что не оплачивается

Код состояния	Код ошибки	Значение
400	—	Параметр неизвестен, повторяется, слишком длинный, неверного типа или отсутствует, в том числе если не передан ни один член группы «хотя бы один из». Какой именно случай, показывает `code` ошибки, например `unknown_parameter` или `missing_parameter`.
403	—	У API-ключа нет разрешения на этот запрос.
404	`social_data_no_result`	Такой пары платформы и возможности нет, или платформа ничего не нашла по этим параметрам (`social_data_no_result`).
429	`data_api_daily_limit_exceededsocial_data_capacity_reached`	Дневной лимит беты исчерпан и сбросится в 00:00 UTC, либо платформа перегружена и достаточно повторить через несколько секунд. Не повторяйте запросы в плотном цикле. Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC.
502	`social_data_no_result`	Источник данных не ответил или ответил без данных.
503	`social_data_unavailable`	Этот эндпоинт сейчас приостановлен; в живом каталоге он помечен как `paused`.

Ни один из этих ответов не оплачивается.

Каждый ответ содержит заголовок X-Oneapi-Request-Id; укажите его, обращаясь в поддержку, и мы найдём именно этот вызов.

Условия беты

Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC. У беты нет SLA, а её платформы, эндпоинты и цены могут меняться.

Соблюдайте условия каждой платформы и применимые к вам правила защиты данных. Не используйте этот API для составления профилей людей. Вход в аккаунты, извлечение контактных данных, накрутка вовлечённости и доступ к закрытому или платному контенту в эту бету не входят.

Лимиты скорости API данных

Платные аккаунты начинают с 10 запросов/с. Лимит автоматически растёт с суммарными чистыми расходами до 100 запросов/с.

Неоплаченные аккаунты: до 50 вызовов в день. Платные аккаунты: без дневного лимита вызовов. Сброс в 00:00 UTC.

Суммарные чистые расходы	Запросов в секунду
Начальный платный лимит	10/s
Более 50 USD	20/s
Более 500 USD	50/s
Более 1500 USD	100/s

Основа расчёта: оплаченные вызовы API данных за вычетом возвратов за вызовы. Пополнения и расходы на API моделей не учитываются.

Все API-ключи аккаунта используют общий лимит. Это число запросов в секунду, а не одновременных запросов.

У интерфейсов поставщиков есть отдельные ограничения мощности, которые также влияют на доступную пропускную способность.

Нужна более высокая скорость? Напишите нам на [email protected].