ebay.ca APIebay.ca ↗
Access eBay Canada listings, sold item history, deals, seller profiles, and category data via a structured JSON API. 8 endpoints covering search, details, and feedback.
curl -X GET 'https://api.parse.bot/scraper/183a9583-089a-442c-a42d-77cadb3924b4/search_items?query=headphones&max_price=200&min_price=50&buy_it_now=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for items on eBay Canada with optional filters for price, category, and listing type. Returns paginated results sorted by the specified order.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | integer | Sort order. Accepted values: 12 (best match), 15 (price low to high), 16 (price high to low). |
| queryrequired | string | Search keyword. |
| max_price | string | Maximum price filter in CAD. |
| min_price | string | Minimum price filter in CAD. |
| buy_it_now | boolean | Filter to Buy It Now listings only. |
| category_id | string | Category ID to filter results. |
{
"type": "object",
"fields": {
"page": "string indicating current page number",
"items": "array of item objects with item_id, title, price, shipping, condition, seller, url, thumbnail"
},
"sample": {
"data": {
"page": "1",
"items": [
{
"url": "https://www.ebay.ca/itm/196245029674?...",
"price": "C $399.00",
"title": "Dell Latitude 7410 14\" Laptop, Intel Core i5-10th Gen, 16GB RAM, 512GB SSD, Win1",
"seller": "refurbit_ca 98.8% positive (1.1K)eBay Refurbished",
"item_id": "196245029674",
"shipping": "Free Shipping",
"condition": "Excellent - Refurbished",
"thumbnail": "https://i.ebayimg.com/images/g/NyIAAOSwtKply9tE/s-l500.webp"
}
]
},
"status": "success"
}
}About the ebay.ca API
The eBay Canada API covers 8 endpoints that return structured listing data from ebay.ca, including active search results, completed sold items for price research, and full seller profiles. The search_items endpoint supports keyword queries with price range filters in CAD, category filtering, Buy It Now toggle, and three sort orders. Responses include item IDs, titles, prices, shipping details, seller usernames, condition labels, and thumbnail URLs.
Search and Listing Data
The search_items endpoint accepts a required query string plus optional filters: min_price and max_price in CAD, category_id, buy_it_now boolean, page for pagination, and a sort integer (12 = best match, 15 = price low to high, 16 = price high to low). Each item in the response includes item_id, title, price, shipping, condition, seller, url, and thumbnail. For deeper data on a single listing, get_item_details accepts an item_id and returns the canonical url, ld_json (schema.org Product structured data, or null), and item_specifics — a key-value object of attributes like brand, colour, or size depending on the category.
Historical Pricing and Deals
search_completed_sold_items takes the same query parameter and returns items that have already sold, giving you historical transaction-level price data useful for valuation work. The response shape mirrors search_items. The get_deals endpoint requires no inputs and returns eBay Canada's featured deals as an array of objects with title, price, original_price, discount, url, and thumbnail — enough to track discount depth over time.
Seller Intelligence
Two endpoints cover seller data. get_seller_profile takes a username and returns store_name, followers, items_sold (formatted strings like '4.9K'), and positive_feedback_percent. get_seller_feedback returns a feedback array per seller where each object includes comment, item, rating, from, price, and date — useful for auditing seller reputation at the transaction level.
Discovery Utilities
get_category_tree returns eBay Canada's full category hierarchy as an array of objects with name and url, which can be fed back into search_items via category_id. get_autocomplete accepts a query string and returns an array of suggested search term strings, supporting typeahead interfaces or query-expansion pipelines.
- Track price history for a product by querying
search_completed_sold_itemsover time and charting average sold prices in CAD. - Build a deal-monitoring dashboard using
get_dealsto surface discount percentage and original price for featured eBay Canada listings. - Validate seller trustworthiness before a bulk purchase by combining
get_seller_profileandget_seller_feedbackfor feedback comment analysis. - Populate a product comparison tool with structured
item_specificsandld_jsondata fromget_item_detailsfor multiple competing listings. - Build a category-aware search interface by first calling
get_category_treeto populate a filter menu, then passingcategory_idtosearch_items. - Expand search coverage in an autocomplete box using
get_autocompletesuggestions to surface related eBay Canada query terms. - Filter active listings to Buy It Now only and sort by price using
buy_it_nowandsortparameters to aggregate fixed-price market data.
| 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 | 250 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 `get_item_details` return beyond the basic listing fields?+
get_item_details returns ld_json, which is schema.org Product structured data and may include fields like brand, image URLs, offers, and description depending on how the seller has populated the listing. It also returns item_specifics — a flat key-value object of attributes such as size, colour, material, or compatibility, which vary by category. The field is null if the structured data is absent from the listing.Does `search_items` support pagination, and how deep can you go?+
search_items accepts a page integer parameter. The response includes a page field confirming the current page. The API does not document a hard maximum page depth, so behaviour at very high page numbers depends on what eBay Canada surfaces for a given query.