Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия eBay: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите карточки товаров eBay по keyword. | $1.39 за 1 000 запросов | Норма |
Магазинstore | Получайте карточки товаров из магазина одного продавца eBay по точному имени пользователя, переданному в seller: цену, состояние, сведения о доставке и изображение каждого товара. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Получите отзывы покупателей об одной карточке товара eBay. | $1.39 за 1 000 запросов | Норма |
Проданные товарыsold | Отслеживайте завершённые продажи на eBay по keyword за указанный период в днях. | $1.39 за 1 000 запросов | Норма |
Сведения о товареproduct_detail | Получите полные данные об одной карточке товара eBay по ссылке или числовому ID: цену, состояние, наличие, формат продажи, признак возможности предложить свою цену, условия доставки и возврата, число пользователей, следящих за товаром, бренд и каталожные коды, путь категории, все изображения, а также рейтинг продавца по отзывам и долю положительных отзывов. | $0.96 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API eBay?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите карточки товаров eBay по | keyword | condition, country, domain, max_price, min_price, sold_only | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
storeМагазин Получайте карточки товаров из магазина одного продавца eBay по точному имени пользователя, переданному в | seller | country, domain, store, url, username | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
reviewsОтзывы Получите отзывы покупателей об одной карточке товара eBay. Чтобы указать карточку, передайте имя пользователя продавца в | seller, item_id | country, domain, product_id, q, seller_name, url, username | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | text · rating · rating_scale · username · submitted_at · seller_reply · image_count · reviewer_feedback_score · reviewer_feedback_star · product_name · product_id · product_price · platform · image_url · images |
soldПроданные товары Отслеживайте завершённые продажи на eBay по | keyword | days, min_price, site, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · name · sold_price · shipping_price · total_price · currency · sold_at · condition · listing_type · best_offer_accepted · category · seller_username · seller_feedback_score · seller_positive_percent · image_url · platform |
product_detailСведения о товаре Получите полные данные об одной карточке товара eBay по ссылке или числовому ID: цену, состояние, наличие, формат продажи, признак возможности предложить свою цену, условия доставки и возврата, число пользователей, следящих за товаром, бренд и каталожные коды, путь категории, все изображения, а также рейтинг продавца по отзывам и долю положительных отзывов. Поля аукциона, такие как | url | — | Режим выдачи: Sync | — | $0.96 за 1 000 запросов | item_id · title · subtitle · url · price · currency · condition · availability · listing_type · bid_count · best_offer_enabled · ends_at · quantity_available · quantity_sold · watchers · brand · model · mpn · gtin · product_id · categories · image_url · images · item_location · shipping_price · free_shipping · returns_accepted · seller · seller_url · seller_feedback_score · seller_positive_percent · updated_at · platform |
Что означают параметры действия search в API eBay?
Находите карточки товаров eBay по keyword. Получайте запрашиваемую цену, валюту, состояние, условия доставки и продавца. Можно фильтровать по состоянию, домену сайта или диапазону цен. sold_only оставляет только карточки, отмеченные как проданные. Этот фильтр не позволяет оценить общий объём рынка.
keywordОбязательный- Поисковый запрос по активным карточкам товаров в действиях
searchлибо по завершённым карточкам и карточкам проданных товаров в действияхsold. Не следует считать, что цена предложения в активной карточке совпадёт с итоговой суммой сделки. conditionНеобязательный- Фильтрует результаты поиска по состоянию товара. Сохраняйте регистр и пробелы: New, Used, Refurbished или For parts or not working. Это фильтр по состоянию товара, а не по положительным или отрицательным отзывам.
countryНеобязательный- Параметр совместимости для domain, который тоже принимает домен сайта eBay, например ebay.com, а не код страны вроде US или DE. Если переданы оба, приоритет у domain.
domainНеобязательный- Выбирает домен сайта eBay, например ebay.com, ebay.de или ebay.co.uk, без схемы и пути. По умолчанию ebay.com; используется для формирования страниц для search, store и reviews.
max_priceНеобязательный- Задаёт числовую верхнюю границу цены товара в search. Используйте вместе с min_price, чтобы задать диапазон, и не рассчитывайте, что доставка или налоги включены.
min_priceНеобязательный- Задаёт числовую нижнюю границу цены товара. В действиях
searchфильтрует цены активных карточек товаров, а в действияхsold— цены завершённых и проданных карточек товаров. Валюта определяется сайтом целевой площадки и данными карточки, а не оплатой API. Вsoldфильтрация выполняется по целым числам, а дробные значения округляются вниз. sold_onlyНеобязательный- Логический переключатель в действиях
search: приtrueвозвращаются только завершённые продажи. Передавайте булево значение JSON, а не строку ("false").
Что означают параметры действия store в API eBay?
Получайте карточки товаров из магазина одного продавца eBay по точному имени пользователя, переданному в seller: цену, состояние, сведения о доставке и изображение каждого товара. Возвращаются только карточки товаров, без баланса продавца, непубличных данных о его репутации и внутренних данных об остатках.
sellerОбязательный- Точное имя пользователя аккаунта продавца eBay, а не отображаемое название магазина или компании. Используется в запросах
storeдля получения карточек товаров продавца и в запросахreviewsвместе сitem_idдля получения отзывов покупателей. countryНеобязательный- Параметр совместимости для domain, который тоже принимает домен сайта eBay, например ebay.com, а не код страны вроде US или DE. Если переданы оба, приоритет у domain.
domainНеобязательный- Выбирает домен сайта eBay, например ebay.com, ebay.de или ebay.co.uk, без схемы и пути. По умолчанию ebay.com; используется для формирования страниц для search, store и reviews.
storeНеобязательный- Псевдоним
sellerдля совместимости: имя пользователя аккаунта продавца, а не произвольное название магазина. Для действияstoreосновной параметрsellerпо-прежнему обязателен. urlНеобязательный- Заменяет автоматически сформированный URL прямой ссылкой на страницу магазина или карточек товаров продавца eBay в действиях
storeлибо на страницу отзывов/fdbk/в действияхreviews. Передача URL не отменяет обязательность параметровsellerилиitem_id. usernameНеобязательный- Псевдоним параметра
sellerдля совместимости, принимающий имя пользователя аккаунта продавца в действияхstoreиreviews. Параметрsellerимеет приоритет и остаётся обязательным; это поле не обозначает имена покупателей или авторов отзывов.
Что означают параметры действия reviews в API eBay?
Получите отзывы покупателей об одной карточке товара eBay. Чтобы указать карточку, передайте имя пользователя продавца в seller, а ID товара — в item_id. В ответе есть оценка, ответ продавца, собственный рейтинг автора отзыва на eBay и сведения о товаре. Полная история отзывов может быть недоступна.
sellerОбязательный- Точное имя пользователя аккаунта продавца eBay, а не отображаемое название магазина или компании. Используется в запросах
storeдля получения карточек товаров продавца и в запросахreviewsвместе сitem_idдля получения отзывов покупателей.eBay: профиль отзывов по сделкам — Отзывы по сделкам на eBay — это положительные, нейтральные или отрицательные оценки с короткими комментариями; профиль отзывов участника отличается от обычных отзывов о товарах с оценкой от 1 до 5 звёзд. · Проверено item_idОбязательный- Числовой идентификатор товара eBay, связанный с карточкой товара продавца (обычно берётся из URL вида
/itm/); используется вместе сsellerв запросахreviews. Обозначает конкретную карточку товара, а не общий ID товара в каталоге и не ID отзыва. countryНеобязательный- Параметр совместимости для domain, который тоже принимает домен сайта eBay, например ebay.com, а не код страны вроде US или DE. Если переданы оба, приоритет у domain.
domainНеобязательный- Выбирает домен сайта eBay, например ebay.com, ebay.de или ebay.co.uk, без схемы и пути. По умолчанию ebay.com; используется для формирования страниц для search, store и reviews.
product_idНеобязательный- Псевдоним
item_idдля совместимости, принимающий числовой идентификатор товара eBay. Для действийreviewsпо-прежнему требуетсяitem_id. qНеобязательный- Псевдоним
item_idдля совместимости, принимающий числовой идентификатор товара eBay в действияхreviews. Не используется как поисковый запрос в свободной форме; для поиска товаров используйтеkeyword. seller_nameНеобязательный- Имя пользователя аккаунта продавца eBay.
urlНеобязательный- Заменяет автоматически сформированный URL прямой ссылкой на страницу магазина или карточек товаров продавца eBay в действиях
storeлибо на страницу отзывов/fdbk/в действияхreviews. Передача URL не отменяет обязательность параметровsellerилиitem_id. usernameНеобязательный- Псевдоним параметра
sellerдля совместимости, принимающий имя пользователя аккаунта продавца в действияхstoreиreviews. Параметрsellerимеет приоритет и остаётся обязательным; это поле не обозначает имена покупателей или авторов отзывов.
Что означают параметры действия sold в API eBay?
Отслеживайте завершённые продажи на eBay по keyword за указанный период в днях. Получайте цену продажи, стоимость доставки, итоговую цену, дату продажи, тип карточки товара и рейтинг продавца. Эти данные описывают каждую завершённую карточку товара. Они не позволяют оценить чистую выручку или будущий спрос.
keywordОбязательный- Поисковый запрос по активным карточкам товаров в действиях
searchлибо по завершённым карточкам и карточкам проданных товаров в действияхsold. Не следует считать, что цена предложения в активной карточке совпадёт с итоговой суммой сделки. daysНеобязательный- Целое число: глубина выборки в днях для запросов
sold(по умолчанию30). Задаёт временной диапазон, а не срок размещения карточки и не количество возвращаемых товаров; полнота данных для произвольного числа дней не гарантируется. min_priceНеобязательный- Задаёт числовую нижнюю границу цены товара. В действиях
searchфильтрует цены активных карточек товаров, а в действияхsold— цены завершённых и проданных карточек товаров. Валюта определяется сайтом целевой площадки и данными карточки, а не оплатой API. Вsoldфильтрация выполняется по целым числам, а дробные значения округляются вниз. siteНеобязательный- Домен eBay для запросов
sold(например,ebay.comилиebay.co.uk), по умолчаниюebay.com. Отличается от параметраdomain, который используется в действияхsearch,storeиreviews; валюта цен соответствует возвращённым записям карточек товаров. sortНеобязательный- Порядок сортировки для действий
sold; допустимые значения:newest(по времени завершения, начиная с самых недавних) иdistance(по удалённости). Сортировка по первоначальной дате создания карточки товара не поддерживается. Если параметр не передан, результаты сортируются по времени завершения, начиная с самых недавних.Допустимые значения:distancenewest
Что означают параметры действия product_detail в API eBay?
Получите полные данные об одной карточке товара eBay по ссылке или числовому ID: цену, состояние, наличие, формат продажи, признак возможности предложить свою цену, условия доставки и возврата, число пользователей, следящих за товаром, бренд и каталожные коды, путь категории, все изображения, а также рейтинг продавца по отзывам и долю положительных отзывов. Поля аукциона, такие как bid_count и ends_at, и коды вроде gtin присутствуют, только если они указаны в карточке.
urlОбязательный- Одна карточка товара eBay: ссылка на неё, например https://www.ebay.com/itm/133576802017 (параметры отслеживания и часть URL с названием отбрасываются), или только числовой ID товара, для которого данные считываются с ebay.com. Данные по ссылкам с других сайтов eBay считываются с соответствующего сайта. Страницы магазинов и поиска, а также страницы со списками товаров отклоняются до выполнения вызова.
Как использовать API eBay
- 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":"ebay","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API eBay
Какие данные можно получить через API eBay?
Укажите в platform значение ebay. В текущем каталоге: поиск, магазин, отзывы, проданные товары и сведения о товаре. Эти названия действий соответствуют разным объектам или представлениям eBay; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе eBay?
Поисковый запрос по активным карточкам товаров в действиях search либо по завершённым карточкам и карточкам проданных товаров в действиях sold. Не следует считать, что цена предложения в активной карточке совпадёт с итоговой суммой сделки. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе eBay?
Объявленная схема включает item_id, title, price и price_text. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия eBay возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.