eBay APIebay.nl ↗
Search completed eBay Netherlands listings via the ebay.nl API. Retrieve final sale prices, sold dates, item conditions, and shipping costs for market research.
What is the eBay API?
The eBay Netherlands API gives developers access to completed and sold listings on ebay.nl through a single endpoint, search_sold_items, returning up to 9 fields per item including final sale price, sold date, condition, and seller type. It covers the Dutch eBay marketplace specifically, making it suitable for pricing research, inventory valuation, and competitive analysis within the Netherlands market.
curl -X GET 'https://api.parse.bot/scraper/28ca5312-4555-4911-9869-09d344bfd43f/search_sold_items?page=1&query=iphone' \ -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-nl-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.
"""Walkthrough: ebay_nl_api SDK — bounded, re-runnable; every call capped."""
from parse_apis.ebay_nl_api import EbayNl, InvalidInput
client = EbayNl()
# Search for recently sold iPhones — limit caps TOTAL items fetched.
for item in client.sold_items.search(query="iphone 14", limit=3):
print(item.title, item.price, item.sold_date)
# Drill-down: take one sold item to inspect details.
result = client.sold_items.search(query="nintendo switch", limit=1).first()
if result:
print(result.item_id, result.title, result.price, result.condition)
# Typed error handling: missing required query.
try:
client.sold_items.search(query="", limit=1).first()
except InvalidInput as e:
print("invalid input:", e)
print("exercised: sold_items.search")
Search completed/sold listings on eBay Netherlands. Returns items that have actually sold, including their final sale price, sold date, condition, and shipping cost. Results are auto-iterated across pages. Useful for market research and price comparison of previously sold goods.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number of results to retrieve. |
| queryrequired | string | Search keywords for sold items (e.g. 'iphone 14', 'nintendo switch'). |
| category | string | eBay category ID to narrow results (e.g. '9355' for cell phones). When omitted, searches all categories. |
{
"type": "object",
"fields": {
"page": "current page number",
"items": "array of sold item objects with item_id, title, price, sold_date, condition, seller_type, shipping, buy_type, url",
"total_pages": "total number of pages available (up to 10 shown by eBay)",
"total_results": "approximate total number of matching sold items as a string"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://www.ebay.nl/itm/236943732165",
"price": "EUR 703,20",
"title": "Samsung Galaxy S26 - Black - 256GB - 12Gb Ram - Brand New & Sealed",
"item_id": "236943732165",
"buy_type": null,
"shipping": "+EUR 35,02 geschatte verzendkosten",
"condition": "Gloednieuw",
"sold_date": "23 jul 2026",
"seller_type": "Zakelijk"
}
],
"total_pages": 10,
"total_results": "61000"
},
"status": "success"
}
}About the eBay API
What the API Returns
The search_sold_items endpoint queries completed listings on ebay.nl and returns an array of sold item objects. Each object includes item_id, title, price, sold_date, condition, seller_type, shipping, buy_type, and url. The price reflects the final transaction price — not an asking price — which is the core value for market research. The buy_type field distinguishes auction-style closings from fixed-price Buy It Now sales.
Filtering and Pagination
The required query parameter accepts free-text search keywords such as iphone 14 or vintage camera. An optional category parameter accepts an eBay category ID (for example, 9355 for cell phones) to restrict results to a specific product type. Results are paginated; the page parameter selects which page to retrieve, and the response includes total_pages (capped at 10 as shown by eBay) and total_results as an approximate count string. Iterating page from 1 through total_pages gives the full available result set for a query.
Coverage and Scope
This API covers the ebay.nl domain only — it returns Dutch-market sold listings and the prices are in the currency displayed on that marketplace. It does not cover active (unsold) listings, watchers, bid history, or seller profiles. Results reflect items that have actually transacted, so the data is useful for establishing realistic market values rather than aspirational asking prices.
The eBay API is a managed, monitored endpoint for ebay.nl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ebay.nl 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.nl 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?+
- Estimate resale value of electronics by querying recent sold prices on the Dutch eBay market
- Track seasonal price trends for collectibles using
sold_dateacross multiple paginated queries - Compare auction vs. fixed-price outcomes using the
buy_typefield for the same product category - Validate inventory pricing before listing by checking
condition-specific sale prices - Build a price alert tool that monitors
pricechanges for a specific search keyword over time - Identify high-demand categories by analyzing
total_resultscounts across multiple category IDs - Research shipping cost norms for a product type using the
shippingfield across sold listings
| 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 sold listings?+
What does the `buy_type` field in the response tell me?+
buy_type field indicates how the item was sold — for example, whether the listing closed as an auction or as a fixed-price Buy It Now sale. This matters for price analysis because auction final prices can differ significantly from fixed-price sales for the same item. You can filter or group results by buy_type in your own code after retrieving the array.How far back does the sold listing data go?+
sold_date values in results will generally fall within that window. Queries for niche products with low sales volume may return fewer results even within that period.Does the API return active (unsold) listings or only completed sales?+
search_sold_items endpoint returns only completed, sold listings — items that reached a transaction. Active listings, watchers, or unsold ended listings are not included in the response. You can fork this API on Parse and revise it to add an endpoint targeting active ebay.nl listings.Can I retrieve seller profile details or feedback scores from this API?+
seller_type field but does not expose full seller profiles, feedback scores, or transaction history. You can fork this API on Parse and revise it to add an endpoint that retrieves seller-level detail.