API Xianyu
Xianyu (Goofish) — площадка Alibaba для подержанных товаров. search возвращает карточки товаров, соответствующие ключевому слову. item_detail получает данные сразу о нескольких карточках по числовому ID товара или ссылке на товар на goofish.com; каждой карточке соответствует одна запись.
Подержанные товары быстро продаются или снимаются с продажи, поэтому каждая запись отражает состояние на момент запроса. В результатах поиска want_count берётся из карточки товара и равен null, если карточка его не показывает. item_detail дополнительно возвращает состояние товара по десятибалльной шкале, число просмотров и добавлений в избранное, все фотографии, описание и долю положительных отзывов о продавце. Карточки, которые не удалось прочитать, возвращаются в missed и не оплачиваются.
Доступность платформы
- Состояние за 24 ч
- 100%
За последние 30 дней
Доступные возможности
Все действия Xianyu: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Просматривайте карточки б/у товаров на Xianyu по поисковой фразе. | $5.56 за 1 000 запросов | Работает стабильно · состояние 100% |
Сведения о карточке товараitem_detail | Получите полные карточки товаров Xianyu по 1–20 ID товаров или ссылкам goofish.com. | $5.56 за 1 000 запросов | Работает стабильно · состояние 100% |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Xianyu?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Просматривайте карточки б/у товаров на Xianyu по поисковой фразе. За один вызов возвращается до 50 карточек. Получите цену, город, число «хочу», теги, признак аукциона и уровень доверия продавца. Китайские термины и номера моделей лучше всего совпадают с заголовками карточек, составленными продавцами. Значение null в | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $5.56 за 1 000 запросов | item_id · url · title · price · original_price · currency · city · image_url · want_count · tags · category_id · free_shipping · is_auction · has_video · posted_at · seller_id · seller_name · seller_avatar_url · seller_credit_label · platform |
item_detailСведения о карточке товара Получите полные карточки товаров Xianyu по 1–20 ID товаров или ссылкам goofish.com. Вы получите описание, оценку состояния, стоимость доставки, местоположение и подробную статистику продавца. | urls | — | Режим выдачи: Sync | — | $5.56 за 1 000 запросов | 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 |
Что означают параметры действия search в API Xianyu?
Просматривайте карточки б/у товаров на Xianyu по поисковой фразе. За один вызов возвращается до 50 карточек. Получите цену, город, число «хочу», теги, признак аукциона и уровень доверия продавца. Китайские термины и номера моделей лучше всего совпадают с заголовками карточек, составленными продавцами. Значение null в want_count означает, что карточка его не показывала, а не ноль.
keywordОбязательный- Поисковая фраза Xianyu для
search, от 1 до 100 символов. Китайские слова и номера моделей чаще совпадают с заголовками продавцов, чем английские переводы. Это не ID товара и не имя продавца.
Что означают параметры действия item_detail в API Xianyu?
Получите полные карточки товаров Xianyu по 1–20 ID товаров или ссылкам goofish.com. Вы получите описание, оценку состояния, стоимость доставки, местоположение и подробную статистику продавца. condition_level использует 10-балльную шкалу. sold_count равен null, если Xianyu его скрывает. Если карточку не удаётся прочитать, средства за неё возвращаются.
urlsОбязательный- Для
item_detail: массив из 1–20 карточек товаров Xianyu. Каждый элемент содержит числовой ID товара (item_idизsearch) или ссылкуhttps://www.goofish.com/item?id=<digits>, и каждая карточка может встречаться только один раз. Оплата взимается за каждую карточку, а за карточки, которые не удалось прочитать, оформляется возврат средств. Короткие ссылки «Поделиться» из приложения не принимаются.Открытая платформа Alibaba: ID товаров Xianyu и оценка состояния — API Alibaba для запроса товаров, предназначенный для авторизованных ISV-партнёров Xianyu, идентифицирует карточку товара по числовому ID товара Xianyu и оценивает состояние через stuff_status: 100 — совершенно новый, 95 — новый на 95%, -1 — почти новый. Для вызовов нужна авторизация в партнёрской среде Alibaba; источник подтверждает только терминологию идентификаторов и состояния и не означает, что EveryInfra использует этот API или может читать все поля любой карточки товара. · Проверено
Как использовать API Xianyu
- 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":"xianyu","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Xianyu
Какие данные можно получить через API Xianyu?
Укажите в platform значение xianyu. В текущем каталоге: поиск и сведения о карточке товара. Эти названия действий соответствуют разным объектам или представлениям Xianyu; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Xianyu?
Поисковая фраза Xianyu для search, от 1 до 100 символов. Китайские слова и номера моделей чаще совпадают с заголовками продавцов, чем английские переводы. Это не ID товара и не имя продавца. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Xianyu?
Объявленная схема включает item_id, title, price и original_price. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Xianyu возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. item_detail runs только синхронно: оно получает все возвращаемые данные (по каждой цели пакета или каждому SKU товара) в рамках одного вызова API, а запрос с "mode": "async" получает ошибку 422 до какого-либо списания. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.