# eBay (Australia) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/ebay-australia/`
**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

### 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.beta.paywithlocus.com/api/wrapped/credits/ebay-australia/compute-market-metrics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ebay-australia/get-listing-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ebay-australia/search-active-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ebay-australia/search-sold-completed-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","page":"<integer>"}'
```

## Next steps

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