ebay.it APIebay.it ↗
Search eBay Italy listings, retrieve item details, sold prices, and seller profiles via a structured JSON API. Covers ebay.it with 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/35502f5e-bed6-4539-a304-d26164234cd7/search_items?page=1&query=laptop&max_price=500&min_price=100' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for items on eBay Italy with keywords and optional filters. Returns paginated results with title, price, URL, image, and rating.
| Param | Type | Description |
|---|---|---|
| page | string | Page number. |
| queryrequired | string | Search keywords. |
| condition | string | Item condition filter (eBay condition code). |
| max_price | string | Maximum price filter in EUR. |
| min_price | string | Minimum price filter in EUR. |
| sort_order | string | Sort order code (eBay _sop parameter). |
| category_id | string | eBay category ID to filter results. |
| listing_format | string | Listing format: 'buy_it_now' or 'auction'. |
{
"type": "object",
"fields": {
"data": "array of item objects with title, url, price, image_url, and rating"
},
"sample": {
"data": [
{
"url": "https://www.ebay.it/itm/406727928044?...",
"price": {
"amount": 455,
"currency": "EUR"
},
"title": "NINTENDO Switch 2 + Mario Kart World",
"rating": null,
"image_url": "https://i.ebayimg.com/images/g/EfkAAeSwrQppKyRE/s-l500.webp"
}
],
"status": "success"
}
}About the ebay.it API
The eBay Italy API gives developers structured access to ebay.it data across 4 endpoints — covering live listings, individual item details, completed sales, and seller profiles. The search_items endpoint accepts keyword queries with price range, condition, category, and listing format filters, returning title, price in EUR, image URL, and rating for each result. It is suited for price monitoring, inventory research, and market analysis against the Italian eBay market.
Searching Live Listings
The search_items endpoint accepts a required query string and a range of optional filters: min_price and max_price (EUR), condition (eBay condition code), category_id, listing_format (buy_it_now or auction), and sort_order (eBay _sop parameter). Results are paginated via the page parameter and each item object in the data array includes title, url, price, image_url, and rating.
Item Details and Seller Profiles
get_item_details takes a numeric item_id (from the listing URL) and returns a richer payload: title, price, currency, condition, images (array of URLs), specifics (a key-value object of item attributes like brand, size, or material), ratings_count, and a seller object with username, feedback_score, and feedback_percent. If the item ID is expired or invalid, the endpoint returns a stale_input signal rather than an error. get_seller_profile accepts a seller username and returns their feedback_score, feedback_percentage, member_since date (formatted in Italian locale, e.g. 17-dic-13), and location.
Completed and Sold Listings
search_completed_items queries the ebay.it sold/completed listings archive using the same keyword-based approach. Each result in the data array carries title, url, price, image_url, and rating. This endpoint is particularly useful for establishing historical sale prices and gauging how quickly specific items move in the Italian market.
Coverage Notes
All price values are denominated in EUR as reported on ebay.it. The specifics object on item detail responses varies by category — electronics listings may include model numbers and technical specs, while clothing listings typically include size and material fields. The member_since field on seller profiles uses the Italian locale date format.
- Monitor EUR price trends for a product category by polling
search_itemswithcategory_idandsort_orderfilters - Research historical sale prices for used goods using
search_completed_itemsbefore setting a listing price - Verify seller reputation before a purchase by fetching
feedback_scoreandfeedback_percentageviaget_seller_profile - Build a cross-border price comparison tool by diffing ebay.it prices (EUR) against other regional eBay markets
- Extract item
specificsfromget_item_detailsto build structured product catalogs from auction listings - Identify auction vs. buy-it-now availability by filtering
search_itemswith thelisting_formatparameter - Track whether a target item ID is still active or has expired using the
stale_inputresponse signal fromget_item_details
| 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 that covers ebay.it?+
What does `get_item_details` return beyond what `search_items` provides?+
images (an array of all listing image URLs), condition, currency, ratings_count, a specifics object (key-value pairs like brand, model, size, or material that vary by category), and a seller sub-object with username, feedback_score, and feedback_percent.Does `search_completed_items` support the same filters as `search_items`?+
search_completed_items only accepts a query string, while search_items supports min_price, max_price, condition, category_id, listing_format, sort_order, and page. You can fork this API on Parse and revise it to add filter support to the completed items endpoint.Are seller ratings and review text accessible through this API?+
feedback_score and feedback_percentage on seller profiles, and rating and ratings_count on item detail responses. Individual buyer review text is not currently returned. You can fork this API on Parse and revise it to add an endpoint targeting the detailed feedback page for a seller.What happens when you request an item ID that no longer exists?+
get_item_details returns a stale_input signal rather than a standard error. This lets you distinguish between a network or API failure and a listing that has genuinely ended or been removed from ebay.it, which is useful for cache invalidation workflows.