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

API Xianyu Сведения о карточке товара

POST

Состояние API

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

Получите полные карточки товаров Xianyu по 1–20 ID товаров или ссылкам goofish.com. Вы получите описание, оценку состояния, стоимость доставки, местоположение и подробную статистику продавца. condition_level использует 10-балльную шкалу. sold_count равен null, если Xianyu его скрывает. Если карточку не удаётся прочитать, средства за неё возвращаются.

Цена: $5.56 за 1 000 запросов ($0.005556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Только синхронный режим: все данные, которые возвращает эндпоинт (по каждой цели в пакете или каждому SKU товара), считываются в рамках этого вызова, а при указании "mode": "async" эндпоинт возвращает ошибку 422 до списания средств.

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: xianyu и action: item_detail, а параметры передайте в params.
- Обязательные параметры:
  - urls: Для item_detail: массив из 1–20 карточек товаров Xianyu. Каждый элемент содержит числовой ID товара (item_id из search) или ссылку https://www.goofish.com/item?id=<digits>, и каждая карточка может встречаться только один…
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.
- Возвращает список записей. Основные поля каждой записи: item_id (Числовой ID карточки товара на Xianyu (…), url, title, text, price, original_price (Исходная цена, указанная продавцом, в ю…), currency, shipping_fee, condition_level, status, quantity, want_count (Число пользователей, нажавших кнопку «Х…); всего полей: 45, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=xianyu.
- Пример тела запроса:
{
  "platform": "xianyu",
  "action": "item_detail",
  "params": {
    "urls": [
      "https://www.goofish.com/item?id=<ITEM_ID>"
    ]
  }
}
- Цена: $5.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Этот эндпоинт работает только синхронно; не добавляйте "mode": "async" в тело запроса.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

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

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаxianyuИдентификатор платформы, фиксированное значение.
actionbodystringДаitem_detailИдентификатор возможности, фиксированное значение.
urlsbody.paramsarrayДа-Для item_detail: массив из 1–20 карточек товаров Xianyu. Каждый элемент содержит числовой ID товара (item_id из search) или ссылку https://www.goofish.com/item?id=<digits>, и каждая карточка может встречаться только один раз. Оплата взимается за каждую карточку, а за карточки, которые не удалось прочитать, оформляется возврат средств. Короткие ссылки «Поделиться» из приложения не принимаются.
limitbody.paramsinteger (1–)Нет-Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.

Примеры кода

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": "xianyu",
  "action": "item_detail",
  "params": {
    "urls": [
      "https://www.goofish.com/item?id=<ITEM_ID>"
    ]
  }
}'

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

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

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json
{
  "id": "req_…",
  "platform": "xianyu",
  "action": "item_detail",
  "results": [
    {
      "item_id": …,
      "url": …,
      "title": …,
      "text": …,
      "price": …,
      "original_price": …,
      "currency": …,
      "shipping_fee": …,
      "condition_level": …,
      "status": …,
      "quantity": …,
      "want_count": …,
      "view_count": …,
      "collect_count": …,
      "sold_count": …,
      "province": …,
      "city": …,
      "category_id": …,
      "image_url": …,
      "images": …,
      "posted_at": …,
      "seller_id": …,
      "seller_name": …,
      "seller_url": …,
      "seller_item_count": …,
      "seller_sold_count": …,
      "seller_good_review_rate": …,
      "seller_reply_rate_24h": …,
      "district": …,
      "division_id": …,
      "lat": …,
      "lng": …,
      "poi_name": …,
      "poi_id": …,
      "seller_avatar_url": …,
      "seller_city": …,
      "seller_bio": …,
      "seller_joined_at": …,
      "seller_last_seen": …,
      "seller_zhima_verified": …,
      "seller_zhima_level": …,
      "seller_zhima_level_code": …,
      "seller_credit_level": …,
      "seller_identity_tags": …,
      "seller_other_items": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

ПолеЗначение
item_idЧисловой ID карточки товара на Xianyu (строка); передавайте его как есть в urls для item_detail.
urlСсылка на запись на платформе.
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
priceЦена числом без символа валюты; см. currency.
original_priceИсходная цена, указанная продавцом, в юанях; null, если не указана.
currencyКод валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте.
shipping_feeТрактуется так же, как на самой платформе
condition_levelТрактуется так же, как на самой платформе
statusТрактуется так же, как на самой платформе
quantityТрактуется так же, как на самой платформе
want_countЧисло пользователей, нажавших кнопку «Хочу». В поиске значение берётся из метки на карточке и равно null, если карточка его не показывает; null не означает ноль.
view_countПросмотры или воспроизведения. null означает, что значение не раскрыто, а не 0.
collect_countСохранения или добавления в избранное. null означает, что значение не раскрыто, а не 0.
sold_countТрактуется так же, как на самой платформе
provinceТрактуется так же, как на самой платформе
cityМестоположение по карточке товара на уровне города, как его показывает Xianyu; в некоторых карточках указана только провинция. Более точное местоположение, если оно есть в карточке, передаётся в district, lat, lng и poi_name.
category_idID категории Xianyu (строка).
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
imagesМассив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет.
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
seller_idЧисловой ID продавца (строка).
seller_nameНикнейм продавца. Для посетителей без входа в аккаунт Xianyu частично скрывает его, и он возвращается в том виде, как показан на странице.
seller_urlТрактуется так же, как на самой платформе
seller_item_countТрактуется так же, как на самой платформе
seller_sold_countТрактуется так же, как на самой платформе
seller_good_review_rateТрактуется так же, как на самой платформе
seller_reply_rate_24hТрактуется так же, как на самой платформе
districtТрактуется так же, как на самой платформе
division_idТрактуется так же, как на самой платформе
latТрактуется так же, как на самой платформе
lngТрактуется так же, как на самой платформе
poi_nameТрактуется так же, как на самой платформе
poi_idТрактуется так же, как на самой платформе
seller_avatar_urlURL фото профиля продавца.
seller_cityТрактуется так же, как на самой платформе
seller_bioТрактуется так же, как на самой платформе
seller_joined_atТрактуется так же, как на самой платформе
seller_last_seenТрактуется так же, как на самой платформе
seller_zhima_verifiedТрактуется так же, как на самой платформе
seller_zhima_levelТрактуется так же, как на самой платформе
seller_zhima_level_codeТрактуется так же, как на самой платформе
seller_credit_levelТрактуется так же, как на самой платформе
seller_identity_tagsТрактуется так же, как на самой платформе
seller_other_itemsТрактуется так же, как на самой платформе
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

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

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

Ошибки

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

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

  • Открытая платформа Alibaba: ID товаров Xianyu и оценка состояния ↗

    API Alibaba для запроса товаров, предназначенный для авторизованных ISV-партнёров Xianyu, идентифицирует карточку товара по числовому ID товара Xianyu и оценивает состояние через stuff_status: 100 — совершенно новый, 95 — новый на 95%, -1 — почти новый. Для вызовов нужна авторизация в партнёрской среде Alibaba; источник подтверждает только терминологию идентификаторов и состояния и не означает, что EveryInfra использует этот API или может читать все поля любой карточки товара.

    Проверено 2026-09-29