eBay APIebay.com.au ↗
Search active and sold eBay Australia listings, fetch full listing details, and compute market metrics including sell-through ratio and average sold price.
What is the eBay API?
This API exposes 4 endpoints covering eBay Australia listing data — active search, sold listings, full listing details, and computed market metrics. The compute_market_metrics endpoint calculates sell-through ratio, 30-day sold count, and average sold price for any keyword. Each endpoint targets the ebay.com.au marketplace specifically, returning AUD-denominated pricing and Australian seller data.
curl -X GET 'https://api.parse.bot/scraper/ed1da096-4b00-49a3-8179-b9e1d6d0faa5/search_active_listings?keyword=iphone+case&price_max=100&price_min=10&category_id=9355' \ -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-com-au-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_australia_market_research_api import EbayAu, ListingSummary, Listing, MarketReport
ebay = EbayAu(api_key="PARSE_API_KEY")
# Compute market metrics for a product category
report = ebay.marketreports.compute(keyword="mechanical keyboard", price_min=50, price_max=200)
print(report.keyword, report.active_count, report.sold_count_30d, report.sell_through_ratio, report.avg_sold_price)
# Search active listings
for summary in ebay.listingsummaries.search_active(keyword="mechanical keyboard", price_min=50, price_max=200):
print(summary.ebay_title, summary.item_price, summary.total_ebay_price, summary.is_sold)
# Navigate to full details
detail = summary.details()
print(detail.condition, detail.seller_username, detail.quantity_sold, detail.image_links)
break
# Search sold/completed listings
for sold in ebay.listingsummaries.search_sold(keyword="mechanical keyboard"):
print(sold.ebay_item_id, sold.ebay_title, sold.item_price, sold.shipping_price_ebay)
break
Search for active listings on eBay Australia with optional price and category filters. Returns up to 60 items per request. Results include item ID, title, price, shipping cost, and image link. Seller username is not available in search results.
| Param | Type | Description |
|---|---|---|
| keywordrequired | string | Search keyword (e.g. 'iphone case') |
| price_max | number | Maximum price in AUD to filter results |
| price_min | number | Minimum price in AUD to filter results |
| category_id | integer | eBay category ID to narrow search scope |
{
"type": "object",
"fields": {
"items": "array of listing summary objects with ebay_item_id, ebay_title, ebay_item_url, item_price, shipping_price_ebay, total_ebay_price, seller_username, location, image_link, sold_date, is_sold",
"total_results": "integer total number of matching listings"
},
"sample": {
"data": {
"items": [
{
"is_sold": false,
"location": "N/A",
"sold_date": "N/A",
"ebay_title": "Shockproof Armor Matte Case Cover Fr Apple iPhone 17 16 15 14 13 12 11 Pro Max",
"image_link": "https://i.ebayimg.com/images/g/YtYAAOSwCAZi-gto/s-l500.webp",
"item_price": 8.35,
"ebay_item_id": "374214453904",
"ebay_item_url": "https://www.ebay.com.au/itm/374214453904",
"seller_username": "N/A",
"total_ebay_price": 8.35,
"shipping_price_ebay": 0
}
],
"total_results": 640000
},
"status": "success"
}
}About the eBay API
Search and Filter Listings
The search_active_listings endpoint accepts a required keyword and optional price_min, price_max (both in AUD), and category_id parameters. It returns up to 60 items per request, each with ebay_item_id, ebay_title, item_price, shipping_price_ebay, total_ebay_price, seller_username, and a direct ebay_item_url. The search_sold_completed_listings endpoint takes only a keyword and returns recently sold items sorted by end date, using the same response shape — useful for validating actual transaction prices against active listing prices.
Listing Detail and Item Specifics
The get_listing_details endpoint takes a single item_id (the numeric eBay item ID as a string) and returns a richer response: condition, location, quantity_sold, an array of image_links, and an item_specifics object containing the key-value pairs the seller entered — things like brand, model, colour, or compatibility. This is the right endpoint for building product catalogues or enriching competitor research with structured attribute data.
Market Metrics Computation
The compute_market_metrics endpoint aggregates data for a keyword into four derived figures: active_count, sold_count_30d, avg_sold_price, and sell_through_ratio. It supports the same price_min and price_max filters as the active search. The sell-through ratio (sold listings divided by active listings) is a standard eBay research metric for gauging demand relative to supply. The response also echoes back the keyword so results are easy to batch and compare across multiple terms.
The eBay API is a managed, monitored endpoint for ebay.com.au — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ebay.com.au 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.com.au 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?+
- Calculate sell-through ratios for potential product categories before sourcing inventory
- Track competitor active listing prices on ebay.com.au using
search_active_listingswith a brand keyword - Verify realistic sale prices by comparing
avg_sold_pricefrom sold listings against current active prices - Extract
item_specificsfromget_listing_detailsto build structured product attribute datasets - Monitor how quickly a keyword's
sold_count_30dchanges over time as a demand signal - Filter active listings by
price_minandprice_maxto analyse a specific price tier on the AU market - Pull
image_linksand listing metadata for a set of item IDs to build a product comparison tool
| 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_sold_completed_listings` return that `search_active_listings` doesn't?+
search_sold_completed_listings returns items that have already transacted, sorted by end date. Both endpoints share the same core fields (ebay_item_id, item_price, shipping_price_ebay, total_ebay_price, seller_username), but the sold endpoint reflects final transaction prices rather than asking prices, and it does not accept price or category filters — only a keyword.How many listings does `compute_market_metrics` analyse?+
active_count and sold_count_30d figures represent a sample rather than the full marketplace population. For niche keywords with fewer total results the sample is likely to be complete.Does the API return seller feedback scores or detailed seller ratings?+
seller_username across all listing endpoints but does not expose feedback scores, positive feedback percentages, or seller rating breakdowns. You can fork this API on Parse and revise it to add a seller detail endpoint covering those fields.