# eBay (Canada) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and compare eBay Canada listings with detailed item information, pricing history from completed sales, and seller profiles to make informed buying decisions. Discover current deals, browse product categories, and view seller feedback and ratings all in one place.

**Category:** Marketplaces | **Website:** [ebay.ca/](https://ebay.ca/) | **Docs:** [parse.bot/marketplace/bc9aaba9-ebff-4ddc-8ff9-bb24eebf1e3a/ebay-ca-api](https://parse.bot/marketplace/bc9aaba9-ebff-4ddc-8ff9-bb24eebf1e3a/ebay-ca-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_autocomplete

Get search suggestions (autocomplete) for a given keyword from eBay Canada. Returns up to 10 suggested search terms based on popular searches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to get suggestions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/get_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_category_tree

Retrieve the full category tree from eBay Canada including top-level categories and subcategories. Each category has a name and URL to browse items in that category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/get_category_tree \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_deals

Fetch current featured deals from eBay Canada's deals page. Returns trending deals with prices and thumbnails. Deal availability changes frequently.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/get_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_item_details

Get full details of a single eBay listing by item ID, including structured LD+JSON product data and item specifics. The ld_json field contains schema.org Product data when available. Item specifics are key-value pairs describing the product attributes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | eBay item ID (numeric string, e.g. '196245029674'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/get_item_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_seller_feedback

Get detailed feedback comments left for a seller, including rating type, item details, buyer info, price, and date. Returns the most recent feedback entries from the seller's feedback page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Seller username. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/get_seller_feedback \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_seller_profile

Retrieve a seller's profile information by username, including feedback percentage, items sold, and follower count. Returns null for fields that are not available on the seller's profile page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Seller username. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### search_completed_sold_items

Search for completed and sold items on eBay Canada to get historical price data. Returns items that have already been sold, useful for market research and price comparison.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/search_completed_sold_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_items

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `buy_it_now` | boolean | No | Filter to Buy It Now listings only. |
| `category_id` | string | No | Category ID to filter results. |
| `max_price` | string | No | Maximum price filter in CAD. |
| `min_price` | string | No | Minimum price filter in CAD. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |
| `sort` | integer | No | Sort order. Accepted values: 12 (best match), 15 (price low to high), 16 (price high to low). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-ca-api-bc9aaba9/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"buy_it_now":"<boolean>","category_id":"<string>","max_price":"<string>","min_price":"<string>","page":"<integer>","query":"<string>","sort":"<integer>"}'
```