ebay.com APIebay.com ↗
Access eBay listings, item details, sold price history, seller profiles, feedback, and category data via a structured JSON API with 8 endpoints.
curl -X GET 'https://api.parse.bot/scraper/caa8e1ad-f5a8-41c1-9bd2-54a8e19b6c35/search_listings?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for eBay listings with filters for category, seller, sold/completed status, and sorting.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number |
| sold | boolean | Filter to sold items only |
| sort | string | Sort order (12=Best Match, 10=Lowest Price, 15=Ending Soonest, 16=Newly Listed) |
| query | string | Search keyword |
| seller | string | Seller username to filter by |
| complete | boolean | Filter to completed listings only |
| category_id | string | eBay category ID to filter by |
{
"type": "object",
"fields": {
"total": "integer",
"listings": "array"
},
"sample": {
"data": "{\"listings\": [{\"title\": \"Dell Latitude Laptop PC Core i5 13.3\\\" FHD 8GB RAM 128GB SSD Windows 11 HDMI WiFi\", \"price\": \"$199.57\", \"url\": \"https://www.ebay.com/itm/286068793851\", \"image\": \"https://i.ebayimg.com/images/g/0BEAAeSwML9plnBp/s-l500.webp\", \"condition\": \"Good - Refurbished \\u00b7Dell\", \"shipping\": \"$199.57\", \"item_id\": \"286068793851\"}, {\"title\": \"Dell Latitude 14\\\" Laptop Computer Intel i5 Up To 32GB RAM 1TB SSD Windows 11 Pro\", \"price\": \"$224.17\", \"url\": \"https://www.ebay.com/itm/286601719329\", \"image\": \"https://i.ebayimg.com/images/g/9MoAAeSwmHdpckMj/s-l500.webp\", \"condition\": \"Genuine Windows 11 OS! Great Condition! Fast Shipping!\", \"shipping\": \"$224.17to$545.25$324.98\", \"item_id\": \"286601719329\"}, {\"title\": \"Dell Latitude 7390 13.3\\\" HD Laptop Core i5 16GB RAM 256GB SSD Windows 11 WiFi\", \"price\": \"$209.50\", \"url\": \"https://www.ebay.com/itm/256687932761\", \"image\": \"https://i.ebayimg.com/images/g/I9QAAeSwUnlpfADR/s-l140.webp\", \"condition\": \"Good - Refurbished \\u00b7Dell\", \"shipping\": \"$209.50\", \"item_id\": \"256687932761\"}, {\"title\": \"Dell Latitude 15.6\\u201d FHD Core i5 Laptop PC Up To 32GB RAM 1TB SSD Windows 11\", \"price\": \"$250.73\", \"url\": \"https://www.ebay.com/itm/256879744174\", \"image\": \"https://i.ebayimg.com/images/g/kSsAAeSw0r5pZ8WR/s-l140.webp\", \"condition\": \"Genuine Windows 11 OS! Great Condition! Fast Shipping!\", \"shipping\": \"$250.73to$495.10\", \"item_id\": \"256879744174\"}, {\"title\": \"Acer Swift Go 14\\\" Laptop Intel Core Ultra 7 155H 16GB RAM 1TB SSD Refurbished\", \"price\": \"$371.99\", \"url\": \"https://www.ebay.com/itm/276709583737\", \"image\": \"https://i.ebayimg.com/images/g/m3YAAeSwJJZpOyMs/s-l140.webp\", \"condition\": \"Certified - Refurbished \\u00b7Acer \\u00b71 TB\", \"shipping\": \"$371.99$799.99\", \"item_id\": \"276709583737\"}, {\"title\": \"Acer Aspire AI 14\\\" Touch Laptop Intel Core Ultra 5 16GB RAM 1TB SSD Refurbished\", \"price\": \"$371.99\", \"url\": \"https://www.ebay.com/itm/256960845305\", \"image\": \"https://i.ebayimg.com/images/g/eOgAAeSw1aZpJNQ2/s-l140.webp\", \"condition\": \"Certified - Refurbished \\u00b7Acer\", \"shipping\": \"$371.99$579.99\", \"item_id\": \"256960845305\"}, {\"title\": \"Asus Touch Chromebook Flip 14\\\" i3 1.80GHz/8GB/128GB SSD CX5400FM - w/Warranty\", \"price\": \"$126.23\", \"url\": \"https://www.ebay.com/itm/357885387535\", \"image\": \"https://i.ebayimg.com/images/g/k~cAAeSwbTRpE1vC/s-l140.webp\", \"condition\": \"Good - Refurbished \\u00b7ASUS\", \"shipping\": \"$126.23$1,050.00\", \"item_id\": \"357885387535\"}, {\"title\": \"Asus Vivobook 15.6\\\" FHD Touchscreen Laptop Core 5-120U 12GB/512GB 90NB13Y2-M0095\", \"price\": \"$286.00\", \"url\": \"https://www.ebay.com/itm/236060579425\", \"image\": \"https://i.ebayimg.com/images/g/zu4AAeSwPwFplenQ/s-l140.webp\", \"condition\": \"Fingerprint sensor on touchpad, 720p HD camera with shu\", \"shipping\": \"$286.00$599.99\", \"item_id\": \"236060579425\"}, {\"title\": \"DELL LATITUDE 5300 2-IN-1 CHROME 13\\\" i5-8365U 8GB 256GB SSD Chrome OS -Excellent\", \"price\": \"$199.99\", \"url\": \"https://www.ebay.com/itm/389286934131\", \"image\": \"https://i.ebayimg.com/images/g/~W4AAeSwsI5pJget/s-l140.webp\", \"condition\": null, \"shipping\": \"$199.99\", \"item_id\": \"389286934131\"}, {\"title\": \"HP Notebook 250 G7 Laptop Core i5 8th Gen 1.6GHz 8GB RAM 256GB SSD W11P\", \"price\": \"$99.99\", \"url\": \"https://www.ebay.com/itm/327018163483\", \"image\": \"https://i.ebayimg.com/images/g/dJgAAeSw6~hpnGb1/s-l140.webp\", \"condition\": null, \"shipping\": \"$99.99\", \"item_id\": \"327018163483\"}, {\"title\": \"HP EliteBook Laptop Computer PC 14 AMD Ryzen 5 PRO 32GB RAM 1TB Windows 11 Pro\", \"price\": \"$289.99\", \"url\": \"https://www.ebay.com/itm/227165086313\", \"image\": \"https://i.ebayimg.com/images/g/MikAAeSw4iNpXyXQ/s-l140.webp\", \"condition\": null, \"shipping\": \"$289.99\", \"item_id\": \"227165086313\"}, {\"title\": \"~REWRITABLE CD/DVD~ 14\\\" HP ProBook Laptop PC: Intel i5, 16GB RAM - 1TB Storage!\", \"price\": \"$177.56\", \"url\": \"https://www.ebay.com/itm/115833852644\", \"image\": \"https://i.ebayimg.com/images/g/oDEAAOSwrZhoJ11R/s-l140.webp\", \"condition\": null, \"shipping\": \"$177.56\", \"item_id\": \"115833852644\"}, {\"title\": \"HP EliteBook Laptop Computer PC 15.6 Core I7 32GB 1TB Windows 11 PRO OFFICE PRO\", \"price\": \"$289.99\", \"url\": \"https://www.ebay.com/itm/227221092200\", \"image\": \"https://i.ebayimg.com/images/g/NwUAAeSwsAFplJqy/s-l140.webp\", \"condition\": null, \"shipping\": \"$289.99\", \"item_id\": \"227221092200\"}, {\"title\": \"14\\\" HP ProBook Laptop: Intel i5 8th gen! 8GB RAM! 256GB NVME SSD! Windows 11 Pro\", \"price\": \"$219.79\", \"url\": \"https://www.ebay.com/itm/115975817889\", \"image\": \"https://i.ebayimg.com/images/g/gz8AAeSw32NpLaoO/s-l140.webp\", \"condition\": null, \"shipping\": \"$219.79\", \"item_id\": \"115975817889\"}, {\"title\": \"Dell Latitude 5420 14\\u201d Laptop Core i7-11th Gen 16GB RAM 512GB NVMe Win 11 Pro\", \"price\": \"$314.89\", \"url\": \"https://www.ebay.com/itm/388878201453\", \"image\": \"https://i.ebayimg.com/images/g/6G8AAeSwCG5oq1bs/s-l140.webp\", \"condition\": null, \"shipping\": \"$314.89\", \"item_id\": \"388878201453\"}, {\"title\": \"Dell Latitude 7420 14\\\" FHD Touchscreen i5-1145G7 2.60GHz 16GB RAM 512GB SSD\", \"price\": \"$214.99\", \"url\": \"https://www.ebay.com/itm/167461872089\", \"image\": \"https://i.ebayimg.com/images/g/oFQAAOSwLLdoAYdT/s-l140.webp\", \"condition\": null, \"shipping\": \"$214.99\", \"item_id\": \"167461872089\"}, {\"title\": \"Dell Latitude Laptop PC 11.6\\\" HD Intel Celeron 4GB RAM 64GB SSD Windows 11\", \"price\": \"$99.26\", \"url\": \"https://www.ebay.com/itm/254170214367\", \"image\": \"https://i.ebayimg.com/images/g/p2gAAeSwIcBo3h2G/s-l140.webp\", \"condition\": \"Good - Refurbished \\u00b7Dell\", \"shipping\": \"$99.26\", \"item_id\": \"254170214367\"}, {\"title\": \"2026 Lenovo IdeaPad Laptop Notebook 15.6\\\" Intel Processor Up to 20GB RAM 1TB SSD\", \"price\": \"$289.00\", \"url\": \"https://www.ebay.com/itm/116992612970\", \"image\": \"https://i.ebayimg.com/images/g/iNsAAeSwi0ZpRGqo/s-l140.webp\", \"condition\": \"\\u2705Free Office 365 \\u27058GB|12GB|20GB RAM \\u2705512GB|1TB SSD\", \"shipping\": \"$289.00to$539.00\", \"item_id\": \"116992612970\"}, {\"title\": \"15.6\\\" FHD Laptop 16GB RAM 512GB SSD Intel Celeron N5095 Win 11 Pro Backlit KB\", \"price\": \"$142.49\", \"url\": \"https://www.ebay.com/itm/376908126772\", \"image\": \"https://i.ebayimg.com/images/g/36EAAeSwO8ZpebNI/s-l140.webp\", \"condition\": \"Pre-Owned \\u00b7Unbranded \\u00b7512 GB\", \"shipping\": \"$142.49$149.99\", \"item_id\": \"376908126772\"}, {\"title\": \"[90% NEW] AOC 15.6\\\" Laptop Intel N97 16GB DDR4 RAM 512GB SSD WIFI BT win11 Pro\", \"price\": \"$209.99\", \"url\": \"https://www.ebay.com/itm/357829646941\", \"image\": \"https://i.ebayimg.com/images/g/As4AAeSwAYBpVPNl/s-l140.webp\", \"condition\": \"Certified - Refurbished \\u00b7Acemagic\", \"shipping\": \"$209.99$309.99\", \"item_id\": \"357829646941\"}, {\"title\": \"HP - 14\\\" Laptop - Intel Celeron N4500 2021 - 4GB Memory - 64GB eMMC - Pale Ro...\", \"price\": \"See price\", \"url\": \"https://www.ebay.com/itm/326898902304\", \"image\": \"https://i.ebayimg.com/images/g/QMEAAeSw9KZpnxVN/s-l140.webp\", \"condition\": \"Brand New \\u00b7HP\", \"shipping\": \"See price$199.99\", \"item_id\": \"326898902304\"}, {\"title\": \"Lenovo Yoga 11e Touchscreen 2-in-1 Laptop Pentium 4GB RAM 256GB SSD Windows 11\", \"price\": \"$138.97\", \"url\": \"https://www.ebay.com/itm/256245941032\", \"image\": \"https://i.ebayimg.com/images/g/4lMAAeSw5llpmSgv/s-l140.webp\", \"condition\": \"Good - Refurbished \\u00b7Lenovo\", \"shipping\": \"$138.97\", \"item_id\": \"256245941032\"}, {\"title\": \"Dell Latitude 14\\\" FHD Laptop Quad-Core i5 4.4GHz 16GB RAM 256GB SSD Windows 11\", \"price\": \"$258.99\", \"url\": \"https://www.ebay.com/itm/256687932768\", \"image\": \"https://i.ebayimg.com/images/g/UA4AAOSwVWBnidO9/s-l140.webp\", \"condition\": \"Good - Refurbished \\u00b7Dell\", \"shipping\": \"$258.99\", \"item_id\": \"256687932768\"}, {\"title\": \"Dell Latitude Laptop Computer PC Intel i5 Up To 32GB RAM 1TB SSD Windows 11\", \"price\": \"$237.36\", \"url\": \"https://www.ebay.com/itm/286393092388\", \"image\": \"https://i.ebayimg.com/images/g/PcAAAeSwFd1plzsw/s-l140.webp\", \"condition\": \"Genuine Windows 11 OS! Great Condition! Fast Shipping!\", \"shipping\": \"$237.36to$547.02$303.73\", \"item_id\": \"286393092388\"}, {\"title\": \"Microsof...",
"status": "success",
"_truncated": "Use get_full_output(test_index=17) for complete data."
}
}About the ebay.com API
This API exposes 8 endpoints covering eBay listings, item details, seller data, and category taxonomy. Use get_item_details to retrieve a single listing's title, price, condition, images, seller info, and item-specific attributes. Other endpoints cover active and completed/sold listing search, seller profiles with detailed ratings, paginated seller feedback, and autocomplete search suggestions — all returned as structured JSON.
Listing Search and Price Research
The search_listings endpoint accepts a query string, optional category_id, seller username, sort order, and boolean flags for sold and complete status. Sorting codes map to specific eBay sort modes: 12 for Best Match, 10 for Lowest Price, 15 for Ending Soonest, and 16 for Newly Listed. Results include a total count and a listings array. For historical price research specifically, get_completed_sold_listings filters to finished auctions and fixed-price sales, accepting a required query and optional page and sort parameters — useful for benchmarking current asking prices against actual transaction data.
Item Details and Seller Data
get_item_details takes a numeric item_id and returns the item's title, formatted price, condition, images array, specifics key-value object (e.g. brand, model, size, color), and a seller object containing the seller's name and feedback fields. Seller data goes deeper with get_seller_profile, which returns structured modules including PROFILE_HEADER, RATING_SUMMARY, DETAILED_SELLER_RATING_SUMMARY, FEEDBACK_SUMMARY_V2, and USER_DETAIL. Individual feedback records are available through get_seller_feedback, which supports pagination via page and limit (25, 50, or 100 results per page) and returns feedbackCards with ratings, comments, and associated item details.
Categories and Search Suggestions
get_categories requires no parameters and returns the full eBay category hierarchy as an array of objects, each containing name, url, and category_id. These IDs feed directly into the category_id filter on search_listings. get_search_suggestions accepts a query prefix and returns an array of suggestion objects with keyword, type, and direct_type fields — matching the autocomplete behavior on eBay's search bar and useful for building search tooling or normalizing user input.
- Track sold prices for a specific product query using
get_completed_sold_listingsto build a price history dataset. - Monitor a competitor seller's active inventory with
get_seller_active_listingsfiltered by their username. - Extract item specifics (brand, model, color) from
get_item_detailsto normalize product catalog data. - Audit a seller's reputation by combining
get_seller_profileratings with paginatedget_seller_feedbackcomments. - Map eBay's category hierarchy using
get_categoriesto build category-filtered search pipelines. - Power a product search autocomplete feature using
get_search_suggestionskeyword and type fields. - Compare active listing prices against completed sale prices for arbitrage or resale margin analysis.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does eBay have an official developer API?+
What does `get_item_details` return and what does it not include?+
get_item_details returns title, price, condition, images, seller (name and feedback), item_id, and specifics key-value pairs such as brand, model, and size. It does not currently expose shipping options, returns policy, quantity available, or bid history for auction items. You can fork this API on Parse and revise it to add an endpoint covering those fields.Can I filter search results by price range or item condition?+
search_listings currently supports filtering by query, category_id, seller, sold/complete status, and sort order. Price range and condition filters are not exposed as parameters at this time. You can fork the API on Parse and revise it to add those filter parameters.How does pagination work across the listing endpoints?+
search_listings, get_completed_sold_listings, and get_seller_active_listings endpoints all accept an integer page parameter. get_seller_feedback additionally accepts a limit parameter of 25, 50, or 100 to control how many feedback records are returned per page. Total result counts are returned in the total field so you can calculate how many pages to request.Does the API cover eBay Motors or international eBay sites?+
category_id to narrow scope — eBay Motors categories are accessible by passing the appropriate category ID. International site coverage (eBay.de, eBay.co.uk, etc.) is not currently supported as a parameter. You can fork this API on Parse and revise it to target a specific regional eBay domain.