eBay APIebay.fr ↗
Search completed and sold listings on eBay France. Retrieve final sale prices, sold dates, item condition, and shipping costs via a single API endpoint.
What is the eBay API?
The eBay France API exposes 1 endpoint — search_sold_items — that queries completed listings on ebay.fr and returns up to 60 sold items per page, including final sale price, sold date, item condition, and shipping cost. It covers the French eBay marketplace specifically, making it useful for price research, valuation, and market trend analysis scoped to French consumer transactions.
curl -X GET 'https://api.parse.bot/scraper/79711d52-bddd-439a-bff4-1f68b7626fdb/search_sold_items?page=1&query=iphone+13' \ -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-fr-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_fr_api SDK — search sold items on eBay France."""
from parse_apis.ebay_fr_api import EbayFr, InvalidInput
client = EbayFr()
# Search for recently sold iPhones, capped to 3 results.
for item in client.sold_items.search(query="iphone 13", limit=3):
print(item.title, item.price, item.currency, item.sold_date)
# Drill down: take one result with .first()
item = client.sold_items.search(query="nintendo switch", limit=1).first()
if item:
print(item.item_id, item.title, item.price, item.condition)
# Filter by category (cell phones = 9355)
for item in client.sold_items.search(query="samsung galaxy", category="9355", limit=3):
print(item.title, item.price, item.listing_type)
# Handle invalid input error
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 France. Returns items that have already been sold, including their final sale price, sold date, condition, and shipping cost. Results are ordered by most recently sold. Each page returns up to 60 items; results are auto-iterated by the SDK.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keywords for sold items (e.g. 'iphone 13', 'nintendo switch'). |
| category | string | eBay category ID to filter results (e.g. '9355' for cell phones). |
{
"type": "object",
"fields": {
"page": "current page number",
"items": "array of sold item objects",
"total_pages": "total number of pages available",
"total_results": "estimated total number of matching sold items",
"items_per_page": "number of items per page (60)"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://www.ebay.fr/itm/137068075493",
"price": 249,
"title": "Apple iPhone 13 - 128 256 512 Go - Noir Blanc Rose Rouge Bleu Vert - BON",
"item_id": "137068075493",
"currency": "EUR",
"shipping": "+14,49 EUR pour la livraison",
"condition": "Occasion",
"sold_date": "21 juil. 2026",
"listing_type": "buy_it_now"
}
],
"total_pages": 6,
"total_results": 320,
"items_per_page": 60
},
"status": "success"
}
}About the eBay API
What the API Returns
The search_sold_items endpoint queries completed transactions on ebay.fr and returns an array of sold item objects under the items field. Each object includes the final sale price the buyer paid, the date the item sold, the item's listed condition, and shipping cost. The response also surfaces total_results (an estimated count of all matching sold listings), total_pages, and items_per_page (fixed at 60), giving you the data you need to paginate through large result sets.
Filtering and Pagination
Searches require a query string — for example 'iphone 14' or 'vélo électrique'. You can narrow results using the optional category parameter, which accepts an eBay category ID (e.g. '9355' for cell phones). Results are ordered by most recently sold, so the first page reflects the freshest completed transactions. The optional page integer parameter lets you step through additional pages; the SDK auto-iterates pages when you need bulk results.
Coverage Scope
This API is scoped exclusively to the French eBay marketplace (ebay.fr). Sold item data reflects actual completed transactions rather than active or unsold listings, which makes it suitable for deriving real market prices rather than asking prices. The total results count is an estimate provided by the source and may not be exact for very large queries.
The eBay API is a managed, monitored endpoint for ebay.fr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ebay.fr 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.fr 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?+
- Estimating resale value of a specific product by reviewing recent final sale prices on ebay.fr
- Tracking price trends for a category (e.g. vintage electronics) over time using sold dates
- Building a price database for second-hand goods sold in the French market
- Validating insurance or appraisal values against actual completed transactions
- Comparing shipping cost patterns across sold listings for a product category
- Filtering sold listings by eBay category ID to research a specific product vertical
| 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?+
What exactly does the `search_sold_items` endpoint return for each item?+
total_results, total_pages, page, and items_per_page (always 60) so you can paginate through the full result set.Does the API cover active (unsold) listings or only completed sales?+
Is data from other eBay regional sites (ebay.com, ebay.de, ebay.co.uk) available?+
How accurate is the `total_results` count?+
total_results field is an estimate sourced directly from the marketplace and can be imprecise for queries that match a very large number of listings. It is reliable enough for pagination planning but should not be treated as an exact transaction count.