# eBay (Australia) — 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 active and sold eBay Australia listings to research products, analyze competitors, and view detailed listing information like pricing and performance metrics. Get market insights including demand trends and pricing data to inform your selling strategy.

**Category:** Marketplaces | **Website:** [ebay.com.au/](https://ebay.com.au/) | **Docs:** [parse.bot/marketplace/3ccfd053-02ab-4533-b719-6008e9ec0534/ebay-com-au-api](https://parse.bot/marketplace/3ccfd053-02ab-4533-b719-6008e9ec0534/ebay-com-au-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-com-au-api-3ccfd053/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### compute_market_metrics

Compute market metrics for a keyword including active listing count, 30-day sold count, average sold price, and sell-through ratio. Fetches up to 2 pages of active listings and 1 page of sold listings to compute metrics. The sell-through ratio is sold_count_30d divided by active_count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Keyword to analyze (e.g. 'iphone case') |
| `price_max` | number | No | Maximum price in AUD for filtering |
| `price_min` | number | No | Minimum price in AUD for filtering |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-com-au-api-3ccfd053/compute_market_metrics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","price_max":"<number>","price_min":"<number>"}'
```

### get_listing_details

Fetch full details for a single eBay Australia listing including title, price, condition, seller info, high-resolution images, and item specifics. Requires a valid item ID obtainable from search results. Returns 404 for expired or removed listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | eBay item ID (numeric string, e.g. '374214453904'). Obtainable from search_active_listings or search_sold_completed_listings results. |

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

### search_active_listings

Search for active listings on eBay Australia with optional price and category filters. Returns up to 60 items per page. Results are auto-iterated across pages. Each result includes item ID, title, price, shipping cost, and image link. Seller username is not available in search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | eBay category ID to narrow search scope |
| `keyword` | string | Yes | Search keyword (e.g. 'iphone case') |
| `page` | integer | No | Page number (1-based) |
| `price_max` | number | No | Maximum price in AUD to filter results |
| `price_min` | number | No | Minimum price in AUD to filter results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-com-au-api-3ccfd053/search_active_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","keyword":"<string>","page":"<integer>","price_max":"<number>","price_min":"<number>"}'
```

### search_sold_completed_listings

Search for sold and completed listings on eBay Australia. Returns recently sold items sorted by end date, up to 60 per page. Results are auto-iterated across pages. Useful for validating pricing strategy and understanding recent sales velocity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword (e.g. 'nike shoes') |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ebay-com-au-api-3ccfd053/search_sold_completed_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","page":"<integer>"}'
```