App Logo
ebay.com

Search eBay listings

TL;DR

Automatically search eBay listings on ebay.com. One page of active listings (about 60) with price, shipping cost and the seller's feedback score for each.

About

The job it does best is pricing something before you list it. Say a Canon AE-1 Program turned up in a drawer: search "canon ae-1 program body" and you get the active listings eBay shows for it, each with price, shipping cost and seller feedback. Add shippingCost to price for a rough landed cost before tax (shippingCost is null when a card has no delivery line). Then drop anything marked "for parts" or bundled with a lens, and send the closest body-only matches to get_listing for condition and photos. The catch is that nothing here has sold yet. A Buy It Now price is what a seller hopes to get and an auction bid will probably still climb, so check the buying-format line in attributes before trusting a number. Keywords are the only input, with no condition or price filter. Items eBay tacks on as "matching fewer words" go to relatedResults, kept apart from the real matches.

Input

query required

Search keywords, e.g. "vintage camera"

Output

query required
results required

Listings eBay returned as matches for the query.

returned optional

How many matching listings this page yielded, excluding the loosely-related ones.

relatedResults optional

Listings eBay appended when the query ran out of matches. They are not results for the query and are kept apart so they cannot be mistaken for matches; usually empty.

resultCountText optional

eBay's own count heading, verbatim ("130,000+ results for vintage camera"). Compare it with `returned`: it is the site's total for the query, while the script reads one page.

Example output

Shape only: placeholder values generated from the output schema, not a real run.

{ "query": "…", "results": [ { "price": 3.5, "title": "Example", "itemId": "abc123", "currency": "…", "attributes": [ "…" ], "shippingCost": 3.5, "sellerFeedbackCount": 3, "sellerFeedbackPercent": 3.5 } ], "returned": 3, "relatedResults": [ { "price": 3.5, "title": "Example", "itemId": "abc123", "currency": "…", "attributes": [ "…" ], "shippingCost": 3.5, "sellerFeedbackCount": 3, "sellerFeedbackPercent": 3.5 } ], "resultCountText": "…" }

FAQ

Search eBay for items by keyword: item id, title, price, currency, shipping cost, location, and seller feedback. No login required.
Ask an AI agent connected to Reduck to run reduck/ebay.com/search_listings, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/ebay.com/search_listings
You do not need one. "Search eBay listings" drives the real ebay.com pages in a browser, so it works whether or not ebay.com offers an API for this.
Required: query.
It returns query, results, returned, relatedResults, resultCountText.
No. It only uses pages of ebay.com that are reachable without signing in.
It only reads. It looks things up on ebay.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/ebay.com/search_listings, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/ebay.com/search_listings
It is part of Reduck's official curated catalogue.
No. It reads eBay's regular search page, which only shows items still for sale, so a price is either a Buy It Now ask or an auction's current bid, not a final sale price. eBay cut off access to its old findCompletedItems call in October 2020 and shut down the rest of the Finding API in February 2025. Its own sold-data API, Marketplace Insights, is restricted and needs eBay business approval.
One results page per run, which at eBay's default page size is about 60 listings in Best Match order (more if the browser running it has eBay set to show 120 or 240 per page). There is no page or offset input, so if eBay's heading says "130,000+ results" and you got 60, narrow the keywords until the listings you care about land on page one.
On listings with variations eBay prints a range such as "$12.99 to $24.99", and price keeps the first figure, the cheapest option. On an auction it is the current bid at the moment of the search, and shipping is not added in either case: it sits separately in shippingCost.
No, every search runs on www.ebay.com. The currency is guessed from the $, € or £ sign alone, so a Canadian "C $" price gets tagged USD, and a price in any other currency comes back with price and currency set to null.

Related scripts

ebay.com

Get eBay seller storefront details

Fetch an eBay seller's storefront: name, positive feedback percentage, items sold, and follower count. No login required.

ebay.com

Get eBay listing details

Fetch an eBay item listing: title, price, currency, images, condition, brand, seller name, feedback score, and positive-feedback percentage. No login required.

Start building not clicking

Get started for free