eBay APIebay.de ↗
Search eBay.de listings, retrieve item details, and fetch seller feedback with 3 endpoints. Supports category filters, sold items, and VRAM filters.
What is the eBay API?
The eBay.de API exposes 3 endpoints covering listing search, item details, and seller feedback for the German eBay marketplace. Use search_listings to query active or completed sales by keyword, category, or seller, with results including item IDs, prices, conditions, and sold dates. get_listing_details returns full per-item data including seller reputation fields, and get_seller_feedback gives monthly and annual feedback breakdowns by category.
curl -X GET 'https://api.parse.bot/scraper/b5ab2678-d7c2-4e69-9693-32fefde6858a/search_listings?page=1&sold=false&query=RTX+4060&category_id=0' \ -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-de-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_de_scraper_api import Ebay, ResourceNotFound
ebay = Ebay()
# Search for GPU listings on eBay.de
for listing in ebay.listingsummaries.search(query="RTX 4060", sold=False, limit=5):
print(listing.title, listing.price, listing.condition)
# Navigate from summary to full details
detail = listing.details()
print(detail.seller.name, detail.seller.feedback_count, detail.sold_count)
# Get a specific listing by ID
gpu = ebay.listings.get(item_id="227377212199")
print(gpu.title, gpu.price, gpu.condition)
# Get seller feedback
feedback = ebay.sellerfeedbacks.get(username="medion")
print(feedback.username, feedback.member_since)
print(feedback.feedback_summary.positive.one_month, feedback.feedback_summary.negative.twelve_months)
Search for active or sold listings on eBay.de. Returns paginated results including item IDs, titles, prices, conditions, and URLs. When searching sold listings, includes sold dates. Paginates via page number parameter. The results include items matching the keyword in the specified category with optional seller and VRAM filters.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sold | boolean | Whether to search only sold/completed listings |
| vram | string | VRAM filter for GPU category searches (e.g. '12 GB'). Only effective when category_id is '27386'. |
| queryrequired | string | Search keyword (e.g. 'RTX 4060', 'iPhone 15') |
| seller | string | Seller username to filter by |
| category_id | string | Category ID to filter results (e.g. '27386' for Graphics Cards, '183454' for Trading Card Games) |
{
"type": "object",
"fields": {
"url": "string of the search URL used",
"page": "string of current page number",
"listings": "array of listing objects each containing item_id, title, price, condition, url, and sold_date"
},
"sample": {
"data": {
"url": "https://www.ebay.de/sch/i.html?_nkw=RTX+4060&_sacat=0&_pgn=1&_from=R40",
"page": "1",
"listings": [
{
"url": "https://www.ebay.de/itm/278064370041",
"price": "EUR 91,00",
"title": "Guter Zustand - GEFORCE RTX 4060 GIGABYTE WINDFORCE OC 8G im Originalkarton",
"item_id": "278064370041",
"condition": "Gebraucht |Privat",
"sold_date": null
},
{
"url": "https://www.ebay.de/itm/227377212199",
"price": "EUR 200,00",
"title": "MSI GeForce RTX 4060 Ventus 2X Black OC 8GB GDDR6 PCIe DP HDMI",
"item_id": "227377212199",
"condition": "Gebraucht |Privat",
"sold_date": null
}
]
},
"status": "success"
}
}About the eBay API
Searching Listings
The search_listings endpoint accepts a required query string and optional filters including category_id, seller, sold, vram, and page. Results return an array of listing objects, each with item_id, title, price, condition, url, and sold_date. Setting sold to true restricts results to completed transactions, which is useful for price tracking. The vram parameter is specific to GPU-category searches and accepts values like '12 GB'. Category IDs follow eBay.de's taxonomy — for example, 27386 for Graphics Cards and 183454 for Trading Card Games.
Item Details and Seller Data
get_listing_details takes a single item_id (the numeric string returned by search_listings) and returns title, price, condition, sold_count, and a seller object containing name, feedback_count, and positive_percent. The sold_count field reflects units sold on fixed-price listings and is null when unavailable. This endpoint is suited for verifying current price and seller standing before acting on a listing.
Seller Feedback
get_seller_feedback accepts a seller username and returns member_since (including country and registration date), a feedback_summary object with positive, neutral, and negative keys each broken down into 1_month, 6_months, and 12_months counts, and a detailed_ratings object with category-level scores. The detailed_ratings field may be empty depending on the seller's feedback volume. This endpoint lets you assess seller history independently of any specific listing.
The eBay API is a managed, monitored endpoint for ebay.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ebay.de 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.de 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?+
- Track sold prices for specific GPU models on eBay.de using the
soldfilter andvramparameter - Monitor a competitor seller's active listings by filtering
search_listingsbysellerusername - Build a price alert tool for Trading Card Games using
category_id183454 and pollingsearch_listings - Evaluate seller trustworthiness before purchase by comparing
positive_percentand 12-month feedback counts fromget_seller_feedback - Aggregate completed auction prices for collectibles research using
soldlistings across multiple pages - Enrich a product catalog with current eBay.de pricing by batch-calling
get_listing_detailswith known item IDs - Detect pricing anomalies by comparing
sold_countandpricefields across similar listings in the same category
| 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 does `search_listings` return for sold items, and how do the results differ from active listings?+
sold is set to true, the results include a sold_date field on each listing object indicating when the transaction completed. Active listing results return the same fields but sold_date will reflect the listing end or be absent. Both modes return item_id, title, price, condition, and url.Does the API cover eBay marketplaces outside Germany, such as eBay.com or eBay.co.uk?+
Are product images or listing descriptions returned by any endpoint?+
get_listing_details endpoint returns title, price, condition, sold_count, and seller fields, but does not include image URLs or full listing description text. You can fork the API on Parse and revise it to add those fields from the listing detail page.How does pagination work in `search_listings`?+
page parameter accepts an integer and the response includes a page field confirming the current page. There is no explicit total-page count returned, so you iterate by incrementing page until the listings array returns fewer results than a full page.