eBay API by APISH

Get public eBay data as clean, consistent JSON: eBay member feedback, eBay item, eBay search, eBay seller store. 4 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

1. Pick an Endpoint. Each option shows what it returns and its price in credits.
2. Enter its Parameters as JSON, for example {"q":"lego star wars"}. All parameters are listed below.
3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

Endpoint	Returns	Required parameters	Credits
/ebay/v1/feedback	eBay member feedback	—	1
/ebay/v1/item	eBay item	—	1
/ebay/v1/search	eBay search	q	2
/ebay/v1/store	eBay seller store	—	1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

eBay member feedback

Endpoint /ebay/v1/feedback · 1 credit per successful call.

A member's feedback profile: comments (25 a page, eBay's own paging), rating counts and detailed seller ratings. Give the member's user id, or a store name (resolved to its owner through the store's Feedback tab). Pass next_page from the previous response; next_page is null on the last page.

Parameters:

• username: eBay user id (the name in ebay.com/usr/
• store: eBay store name (ebay.com/str/
• page: Page number. Pass next_page from the previous response.
• rating — one of positive, neutral, negative: Only this rating.
• period — one of all, 12m, 6m, 1m: Time window (default all; 12m when rating is set, as on eBay).
• role — one of seller, buyer: Feedback received as seller (default) or as buyer.

eBay item

Endpoint /ebay/v1/item · 1 credit per successful call.

One listing: price, condition, seller feedback, quantity available and sold, item specifics, shipping, delivery, returns, item location, ships-to list, images and the seller description URL.

Parameters:

• url: The listing URL (https://www.ebay.com/itm/...).
• id: The item number instead of url.

eBay search

Endpoint /ebay/v1/search · 2 credits per successful call.

Listings for a query on ebay.com with eBay's own sort and filters: price range, condition, buying format, free shipping, returns, sold listings, item location and category. 60 listings per page; pass next_page back as page.

Parameters:

• q (required): Search terms.
• page: Page number (60 listings per page). Pass next_page from the previous response.
• sort — one of best_match, price_asc, price_desc, newest, ending_soon, distance: best_match (default), price_asc, price_desc, newest, ending_soon, distance.
• min_price: Minimum price, USD.
• max_price: Maximum price, USD.
• condition — one of new, open_box, refurbished, used, parts: new, open_box, refurbished, used or parts.
• buying — one of buy_it_now, auction, best_offer: buy_it_now, auction or best_offer.
• free_shipping: 1 for free shipping only.
• returns: 1 for listings that accept returns.
• sold: 1 for sold and completed listings (price history). eBay currently shows these only to signed-in visitors, so this returns 503 (not charged).
• location — one of us, north_america, worldwide: us, north_america or worldwide (item location).
• category: eBay category id.

Example parameters: {"q":"lego star wars"}

eBay seller store

Endpoint /ebay/v1/store · 1 credit per successful call.

A seller's eBay Store page: store name, seller username, positive feedback %, items sold, followers, listings for sale, Top Rated status, location, member since, about text and logo.

Parameters:

• name: Store name, as in ebay.com/str/
• url: An ebay.com/str/

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.