# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/ebay-canada/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/ebay-canada/get-autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ebay-canada/get-category-tree \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ebay-canada/get-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ebay-canada/get-item-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ebay-canada/get-seller-feedback \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ebay-canada/get-seller-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ebay-canada/search-completed-sold-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/ebay-canada/search-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.