eBay 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.
What is the eBay 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.
curl -X GET 'https://api.parse.bot/scraper/35502f5e-bed6-4539-a304-d26164234cd7/search_items?page=1&query=laptop+dell&condition=1000&max_price=1000&min_price=10&sort_order=12&category_id=175672&listing_format=buy_it_now' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ebay-it-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ebay_italy_api import EbayItaly, ListingFormat, ItemNotFound
ebay = EbayItaly()
# Search for laptops with Buy It Now format
for item in ebay.items.search(query="laptop dell", listing_format=ListingFormat.BUY_IT_NOW, max_price="800", limit=5):
print(item.title, item.price.amount, item.price.currency)
# Get full details for a specific item
detail = ebay.itemdetails.get(item_id="256425498498")
print(detail.title, detail.price, detail.condition)
print(detail.seller.feedback_percent)
# Search completed/sold listings for price research
for sold in ebay.items.search_completed(query="iphone 15", limit=3):
print(sold.title, sold.price.amount)
# Look up a seller profile
seller = ebay.sellerprofiles.get(username="monclick-italia")
print(seller.username, seller.feedback_score, seller.member_since)
Full-text search over eBay Italy listings. Supports filtering by price range, condition, listing format, category, and sort order. Returns paginated results with title, price, URL, image, and rating. Pagination via the page parameter; each page returns up to 60 items.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| queryrequired | string | Search keywords. |
| condition | string | Item condition filter (eBay LH_ItemCondition code, e.g. '1000' for new, '3000' for used). |
| 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, e.g. '12' for price+shipping lowest first, '16' for price+shipping highest first, '10' for newly listed). |
| category_id | string | eBay category ID to narrow results. |
| listing_format | string | Listing format: 'buy_it_now' or 'auction'. |
{
"type": "object",
"fields": {
"items": "array of item objects each containing title, url, price (object with amount and currency), image_url, and rating"
},
"sample": {
"data": {
"items": [
{
"url": "https://www.ebay.it/itm/127908044963?_skw=laptop+dell",
"price": {
"amount": 199,
"currency": "EUR"
},
"title": "NOTEBOOK DELL LATITUDE 5300 INTEL CORE i5-8265U 8GB RAM 256GB SSD WIFI WIN11",
"rating": null,
"image_url": "https://i.ebayimg.com/images/g/oe4AAeSwy-BqJRJ-/s-l500.webp"
}
]
},
"status": "success"
}
}About the eBay API
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.
The eBay API is a managed, monitored endpoint for ebay.it — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ebay.it changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ebay.it API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.