# Vinted (United Kingdom) — 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 Vinted UK listings to compare prices, view detailed product information, and track pricing trends across categories. Get instant access to live marketplace data including search results, item details, and price intelligence for competitive shopping analysis.

**Category:** Marketplaces | **Website:** [vinted.co.uk/](https://vinted.co.uk/) | **Docs:** [parse.bot/marketplace/d88a0e62-cfc9-4898-9630-3133767acfc7/vinted-co-uk-api](https://parse.bot/marketplace/d88a0e62-cfc9-4898-9630-3133767acfc7/vinted-co-uk-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-vinted-co-uk-api-d88a0e62/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Get the main category IDs and names available for filtering search results. Returns a static list of top-level categories that can be passed as category_id to search_listings.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vinted-co-uk-api-d88a0e62/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_listing_detail

Get full details of a single product listing by its ID, including title, description, brand, price, condition, availability, category, and image URL. The item_id is obtainable from search_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The listing/item ID (numeric string). Obtainable from search_listings results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vinted-co-uk-api-d88a0e62/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_search_prices

Quickly get the prices of the first 10 items for a specific search query. Returns an array of price strings with currency suffix. Useful for quick price comparisons without fetching full listing details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `search_text` | string | Yes | Search keyword (e.g. 'nike shoes'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vinted-co-uk-api-d88a0e62/get_search_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search_text":"<string>"}'
```

### search_by_keyword_list

Batch search across multiple keywords (up to 20), returning up to 10 newest-first items per keyword. Each item includes size, image, condition, brand, and price. Useful for comparing availability across product types in a single call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keywords` | string | Yes | JSON array of search terms, max 20 items (e.g. '["nike", "adidas"]'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vinted-co-uk-api-d88a0e62/search_by_keyword_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":"<string>"}'
```

### search_listings

Full-text search over Vinted UK product listings. Returns paginated results with item summaries including price, brand, condition, and image. Each page returns up to ~96 items. Filtering by category_id narrows results to a specific product category (use get_categories for valid IDs).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID to filter results. Accepted values include 1904 (Women), 5 (Men), 1194 (Electronics), 3054 (Cameras). Use get_categories to retrieve valid IDs. |
| `page` | integer | No | Page number for pagination. |
| `search_text` | string | Yes | Search keyword (e.g. 'nike shoes', 'levi jeans'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vinted-co-uk-api-d88a0e62/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","page":"<integer>","search_text":"<string>"}'
```