ebay.co.uk APIebay.co.uk ↗
Access eBay UK listings, sold prices, item details, seller feedback, categories, daily deals, and PSA card results via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/923c816c-9218-4c32-ae0c-2eac3d514be5/search_listings?page=1&query=laptop&category_id=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for active product listings on eBay UK by keyword and category. Returns paginated results with title, price, condition, and item ID.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination |
| queryrequired | string | Search keyword |
| category_id | string | eBay category ID to filter results. 0 searches all categories. |
{
"type": "object",
"fields": {
"page": "string, current page number",
"items": "array of listing objects with item_id, title, price, condition, url, and shipping",
"query": "string, the search query used"
},
"sample": {
"data": {
"page": "1",
"items": [
{
"url": "https://www.ebay.co.uk/itm/178111197347",
"price": "£513.92",
"title": "iPhone 15 Pro White Titanium 128GB",
"item_id": "178111197347",
"shipping": "+£11.95 delivery",
"condition": "Pre-owned"
}
],
"query": "laptop"
},
"status": "success"
}
}About the ebay.co.uk API
The eBay UK API covers 7 endpoints that return active listings, completed sales, item details, seller feedback, category trees, daily deals, and sold PSA-graded card results from eBay.co.uk. The search_listings endpoint accepts a keyword query and optional category_id to return paginated results with title, price, condition, and item ID. A dedicated search_sold_psa_cards endpoint filters completed sales to PSA-graded trading cards specifically.
Active and Sold Listings
The search_listings endpoint takes a required query string plus optional page and category_id parameters. Results include an items array where each object carries item_id, title, price, condition, url, and shipping. Setting category_id to 0 searches across all categories. The search_sold_listings endpoint works the same way but targets completed sales, making it useful for price history research — each response includes a type field set to 'sold' so you can distinguish result sets programmatically.
Item Details and Seller Feedback
get_item_details accepts a 10–14 digit item_id and returns the full listing record: price, title, images (an array of URLs), condition, seller_username, and a specifics object containing key-value pairs such as brand, model, or size depending on the category. get_seller_feedback takes a seller username and returns positive_feedback_percent alongside a recent_feedbacks array, each entry holding a comment and an item field.
Categories, Deals, and PSA Cards
get_all_categories requires no parameters and returns the full eBay UK category tree: top-level categories with name, id, and a subcategories array where each child also carries name, url, id, and a children array. get_daily_deals returns current promotions as a deals array with title, price, original_price (when the listing shows a was-price), and url. The search_sold_psa_cards endpoint filters completed sales to items containing 'PSA' in the title; pass a card_name string to target a specific card and grade.
- Build a price tracker by polling
search_sold_listingsfor a product keyword and charting medianpriceover time. - Vet a seller before a high-value purchase by calling
get_seller_feedbackto reviewpositive_feedback_percentand recent comments. - Power a product comparison tool using
get_item_detailsto pullspecificsfields like brand and model across multipleitem_idvalues. - Aggregate eBay UK daily deals into a deal-alert newsletter using
get_daily_dealsand itsoriginal_pricevspricefields. - Research PSA graded card valuations by querying
search_sold_psa_cardswith a specific card name and grade. - Populate a category-aware search UI by pre-loading the category tree from
get_all_categoriesand mappingidvalues tocategory_idfilter params insearch_listings. - Detect arbitrage opportunities by comparing active listing prices from
search_listingsagainst completed sale prices fromsearch_sold_listingsfor the same query.
| 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 that `search_listings` doesn't?+
search_listings gives you a summary per item: item_id, title, price, condition, url, and shipping. get_item_details goes deeper for a single item — it adds a full images array, a specifics object with category-specific attributes like brand or model, and the seller_username. Use it when you need the complete record for a known item ID.Does the API cover eBay marketplaces outside the UK?+
Does the API return bid history or auction time-remaining for auction listings?+
price, condition, title, url, and shipping for listings, but does not expose bid count, current bid history, or auction end times. You can fork it on Parse and revise to add an endpoint that surfaces those auction-specific fields.How does pagination work for search endpoints?+
search_listings and search_sold_listings accept an optional page string parameter. The response echoes back the page value you passed. If page is omitted, results default to the first page. Increment the page value in successive requests to walk through result sets.