# Vinted (United Kingdom) — 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 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/vinted-united-kingdom/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/vinted-united-kingdom/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vinted-united-kingdom/get-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vinted-united-kingdom/get-search-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vinted-united-kingdom/search-by-keyword-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vinted-united-kingdom/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","page":"<integer>","search_text":"<string>"}'
```

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