eBay APIebay.ca ↗
Access eBay Canada listings, completed sales history, seller profiles, deals, and categories via 8 structured endpoints. Filter by price, category, and listing type.
What is the eBay API?
The eBay Canada API exposes 8 endpoints covering live listings, completed sales, seller profiles, featured deals, and category navigation on ebay.ca. Use search_items to query active listings with filters for price range in CAD, category ID, and Buy It Now availability, then call get_item_details to retrieve structured schema.org Product data and key-value item specifics for any individual listing.
curl -X GET 'https://api.parse.bot/scraper/183a9583-089a-442c-a42d-77cadb3924b4/search_items?page=1&sort=12&query=laptop&max_price=500&min_price=10&buy_it_now=True&category_id=177' \ -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-ca-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 Canada SDK — search items, drill into details, explore seller feedback."""
from parse_apis.ebay_canada_api import EbayCanada, Sort, ItemNotFound
client = EbayCanada()
# Search for laptops sorted by price, with a budget cap
for item in client.items.search(query="laptop", sort=Sort.PRICE_LOW_TO_HIGH, max_price="500", limit=5):
print(item.title, item.price, item.condition)
# Drill into the first result's full details
item = client.items.search(query="mechanical keyboard", limit=1).first()
if item:
detail = client.items.get(item_id=item.item_id)
print(detail.title, detail.item_specifics)
# Look up a seller profile and read their recent feedback
seller = client.sellers.get(username="refurbit_ca")
print(seller.store_name, seller.positive_feedback_percent, seller.items_sold)
for fb in seller.feedback.list(limit=3):
print(fb.comment, fb.rating, fb.date)
# Browse current deals
for deal in client.deals.list(limit=3):
print(deal.title, deal.price, deal.discount)
# Get autocomplete suggestions for a search term
for suggestion in client.items.autocomplete(query="iphone", limit=5):
print(suggestion)
# Handle a missing item gracefully
try:
client.items.get(item_id="9999999999999")
except ItemNotFound as exc:
print(f"Item not found: {exc.item_id}")
print("exercised: items.search / items.get / items.autocomplete / sellers.get / feedback.list / deals.list")
Search for items on eBay Canada with optional filters for price, category, and listing type. Returns paginated results sorted by the specified order. Each item includes basic listing info; use get_item_details for full specifications.
| 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.6% 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 API
Search and Listing Data
The search_items endpoint accepts a query string plus optional filters: min_price and max_price in CAD, category_id, buy_it_now boolean, and a sort parameter that accepts values 12 (best match), 15 (price low to high), or 16 (price high to low). Results are paginated via the page parameter. Each item in the response carries item_id, title, price, shipping, condition, seller, url, and thumbnail. For full listing detail, pass the item_id to get_item_details, which returns ld_json (schema.org Product structured data when the listing provides it) and item_specifics as a flat key-value object covering attributes like brand, size, color, or MPN depending on the category.
Completed Sales and Price History
search_completed_sold_items returns items that have already sold on eBay Canada, giving the same field set as live search results but drawn from closed listings. This is useful for establishing market value before listing or bidding. Note that page and price-range filters are not available on this endpoint — it returns a flat array of recent results for the given query.
Deals, Categories, and Autocomplete
get_deals returns the current featured deals from eBay Canada's deals page, each with title, price, original_price, discount, url, and thumbnail. Availability changes frequently so responses should be treated as near-real-time snapshots. get_category_tree returns the full two-level category structure with name and url for each node, which feeds category IDs into search_items. get_autocomplete accepts a query and returns up to 10 suggested search strings drawn from popular searches on the site.
Seller Information
get_seller_profile accepts a username and returns store_name, positive_feedback_percent, items_sold, and followers. Fields that are not publicly listed on the seller's profile page come back as null rather than erroring. get_seller_feedback returns an array of recent feedback entries, each containing comment, item, rating, from, price, and date, allowing you to review the actual transaction-level feedback history for any seller.
The eBay API is a managed, monitored endpoint for ebay.ca — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ebay.ca 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.ca 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 price trends for a product category by querying completed sales with search_completed_sold_items.
- Build a deal aggregator that polls get_deals and surfaces eBay Canada discounts alongside discount percentages.
- Validate seller trustworthiness by combining positive_feedback_percent from get_seller_profile with recent comments from get_seller_feedback.
- Populate a product catalog with structured attributes using item_specifics from get_item_details.
- Implement search autocomplete in a shopping tool using suggestions from get_autocomplete.
- Map category IDs from get_category_tree to pre-filtered search URLs passed into search_items.
- Compare active listing prices to historical sold prices to estimate fair market value for any item.
| 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.