# 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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/parse-ebay-it-api-51a139a2/get_item_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-ebay-it-api-51a139a2/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-ebay-it-api-51a139a2/search_completed_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-ebay-it-api-51a139a2/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```