eBay Search API
Scrape eBay and get listing results as JSON. Titles, prices, condition, seller feedback, and shipping details from a single REST request.
curl -X GET "https://api.serply.io/v1/ebay/search/?q=vinyl%20records" \
-H "Content-Type: application/json" \
-H "X-Api-Key: YOUR_API_KEY"{
"results": [
{
"title": "Prince - Welcome 2 America 12” Vinyl Album 2x Records With One Etched Side",
"link": "https://www.ebay.com/itm/267755938013?epid=...",
"position": 1,
"result_type": "organic",
"metadata": {
"price": "$27.06",
"was_price": "$27.00",
"condition": "Pre-Owned",
"image": "https://i.ebayimg.com/images/g/.../s-l500.webp",
"seller": "dshvinyl",
"seller_feedback": "100% positive (1.2K)",
"attributes": [
"or Best Offer",
"+$4.94 delivery in 2-3 days",
"Located in United Kingdom"
]
}
},
{
"title": "Fleetwood Mac - Rumours Vinyl LP 180 Gram Remastered",
"link": "https://www.ebay.com/itm/155123456789?epid=...",
"position": 2,
"result_type": "organic",
"metadata": {
"price": "$19.99",
"condition": "New",
"image": "https://i.ebayimg.com/images/g/.../s-l500.webp",
"seller": "recordbarn_official",
"seller_feedback": "99.2% positive (8.4K)",
"attributes": [
"Free shipping",
"Located in United States"
]
}
}
],
"total": 0,
"query": "vinyl records",
"ts": 2.53,
"device_region": "",
"device_type": null
}Search eBay by Query
Send the same phrase you would type into eBay's search box, such as "vinyl records" or "iphone 15 case", and get back the ranked list of organic listings. Each result keeps its position, so the response tells you exactly what a real eBay search surfaces.
Pricing and Condition
Every listing carries the current price, a was-price when the listing shows a markdown, and the item condition such as New or Pre-Owned. That's the core data a price tracker or arbitrage tool needs, parsed and ready to compare without touching HTML.
Seller and Shipping Details
Get the seller's username and feedback score alongside shipping cost, delivery estimate, item location, and whether the listing accepts Best Offer. Everything you need to compare listings beyond price alone, returned without a second lookup per item.
No Headless Browser Required
eBay's search pages sit behind bot-detection that blocks plain scraper requests. Serply handles the request warm-up and retries so you never run a headless browser or maintain a proxy pool -- authenticate with one header and pay a flat prepaid credit per successful uncached request.
Frequently Asked Questions
What is an eBay Search API?
An eBay Search API provides programmatic access to eBay's listing search results, returning organic listings as structured JSON instead of HTML you have to parse yourself. Serply's eBay Search API takes a search such as 'vinyl records' and returns each listing with its title, link, price, condition, seller, and shipping attributes.
How do I scrape eBay search results without getting blocked?
Send the search to Serply's REST endpoint and read the JSON. eBay's search pages sit behind bot-detection that blocks plain scraper requests; Serply handles the request warm-up, retries, and cookie handling so you never run a headless browser or maintain a proxy pool. One GET request to /v1/ebay/search/{query} with your API key returns parsed listing results.
What listing data does the API return?
Each result includes title, link, position, result type, and a metadata object with price, a was-price when the listing shows a markdown, condition, image, seller username, seller feedback score, and an attributes array covering shipping cost, delivery estimate, item location, and best-offer availability.
Does the response include the total number of matching listings?
The API returns a total field, but it is not yet reliable and currently reports 0 regardless of the actual match count. Use the length of the results array for an accurate count of listings returned in that request.
Can I filter by price, condition, or location?
The query parameter accepts the same keyword search you'd type into eBay's search box. Filtering by price, condition, or location is not yet supported as separate parameters -- narrow your query with descriptive keywords, and use the condition and attributes fields in each result to filter client-side.
What can I build with an eBay scraper API?
Price trackers, resale and arbitrage tools, competitor listing monitors, market research on sell-through and pricing trends, and inventory sourcing tools. Because every result carries a stable link and seller, results join cleanly against your own product catalog in Python, JavaScript, Ruby, PHP, Go, or Java.
How much does the eBay Search API cost?
New accounts include 2,500 free credits. After that you buy prepaid credits that never expire, and one credit is deducted per successful uncached request. Responses are cached for 10 minutes, and a cached response costs nothing.
Start Building with the eBay Search API Today
Join thousands of developers using Serply to build price trackers, arbitrage tools, and listing monitors.