# eBay (Italy) — 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 browse listings on eBay Italy (ebay.it). Retrieve item details, completed/sold listings for price research, and public seller profiles.

**Category:** Marketplaces | **Website:** [ebay.it/](https://ebay.it/) | **Docs:** [parse.bot/marketplace/51a139a2-298f-427b-ad9f-d95c47d19605/ebay-it-api](https://parse.bot/marketplace/51a139a2-298f-427b-ad9f-d95c47d19605/ebay-it-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-italy/`
**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 item details

Retrieve full details for a specific eBay Italy listing by item ID. Returns title, price, images, condition, seller info, item specifics, and rating. Returns stale_input for expired or non-existent item IDs.

**Estimated cost:** Metered

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

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ebay-italy/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 profile

Retrieve the public feedback profile of an eBay Italy seller by username. Returns feedback score, positive feedback percentage, member-since date, and country. Some fields may be null if the seller has not received enough recent ratings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Seller username (as shown on eBay). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ebay-italy/get-seller-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### Search completed items

Search for completed and sold listings on eBay Italy. Useful for price research and market analysis. Returns items that have already been sold, with the same structure as search_items.

**Estimated cost:** Metered

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

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ebay-italy/search-completed-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Search items

Full-text search over eBay Italy listings. Supports filtering by price range, condition, listing format, category, and sort order. Returns paginated results with title, price, URL, image, and rating. Pagination via the page parameter; each page returns up to 60 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | eBay category ID to narrow results. |
| `condition` | string | No | Item condition filter (eBay LH_ItemCondition code, e.g. '1000' for new, '3000' for used). |
| `listing_format` | string | No | Listing format: 'buy_it_now' or 'auction'. |
| `max_price` | string | No | Maximum price filter in EUR. |
| `min_price` | string | No | Minimum price filter in EUR. |
| `page` | integer | No | Page number (1-based). |
| `query` | string | Yes | Search keywords. |
| `sort_order` | string | No | Sort order code (eBay _sop parameter, e.g. '12' for price+shipping lowest first, '16' for price+shipping highest first, '10' for newly listed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ebay-italy/search-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","condition":"<string>","listing_format":"<string>","max_price":"<string>","min_price":"<string>","page":"<integer>","query":"<string>","sort_order":"<string>"}'
```

## 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.