# Vinted API guide



## Start with Vinted



Search public second-hand listings in Great Britain or France, follow item and seller identifiers, and compare asking prices. Sold-comparable prices are not verified final transaction amounts.



These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.



### 1. Find items



Preserve market, filters and page size when following the returned cursor. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/vinted/search)



**vinted/search**

```
curl "https://www.monocrawl.com/v1/vinted/search?query=Levis%20501&market=gb&limit=10" \
  -H "x-api-key: mn_your_key_here"
```



### 2. Inspect an item



Use an id from search. The result includes available photos, description, category, brand, condition and seller_id. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/vinted/item)



**vinted/item**

```
curl "https://www.monocrawl.com/v1/vinted/item?id=10062088255" \
  -H "x-api-key: mn_your_key_here"
```



### 3. Inspect the seller



Use seller_id from the item. Read seller-items and seller-feedback separately. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/vinted/seller)



**vinted/seller**

```
curl "https://www.monocrawl.com/v1/vinted/seller?id=3154597880" \
  -H "x-api-key: mn_your_key_here"
```



## Choose filters with the source behavior in mind



| Control | Behavior and limits |
| --- | --- |
| Markets and currency | Choose gb or fr and retain the market across child lookups. Compare price and currency together; amounts are asking prices. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/vinted/search) |
| Continuation | Keep query, filters and limit unchanged. Use the returned cursor, which expires after one hour. Results already delivered are removed from continuation pages. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/vinted/search) |
| Price guidance | Currently France only. Use category_id, brand_id and condition_id from an item. A suggestion or sold comparable is not a guaranteed transaction value. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/vinted/price-suggestions) |



Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See [runnable workflows](https://www.monocrawl.com/docs/workflows), [computed fields](https://www.monocrawl.com/docs/computed-fields) and [pagination and caching](https://www.monocrawl.com/docs/pagination-caching).



## Match the operation to your task



| Your task | Endpoint | When to use it |
| --- | --- | --- |
| Visual matches | [`search-by-image`](https://www.monocrawl.com/docs/endpoints/vinted/search-by-image) | Use an HTTPS Vinted image URL returned by an item. Similarity scores are not supplied. |
| Sold comparables | [`sold-comparables`](https://www.monocrawl.com/docs/endpoints/vinted/sold-comparables) | Use category_id, brand_id and condition_id from an item. |
| Price guidance | [`price-suggestions`](https://www.monocrawl.com/docs/endpoints/vinted/price-suggestions) | Currently France only. Suggested asking prices are not guaranteed sale values. |



Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.



### Other operations



- [`item`](https://www.monocrawl.com/docs/endpoints/vinted/item)

- [`sold-comparables`](https://www.monocrawl.com/docs/endpoints/vinted/sold-comparables)



### Search and discovery



- [`price-suggestions`](https://www.monocrawl.com/docs/endpoints/vinted/price-suggestions)

- [`search`](https://www.monocrawl.com/docs/endpoints/vinted/search)

- [`search-by-image`](https://www.monocrawl.com/docs/endpoints/vinted/search-by-image)



### Reviews and offers



- [`seller`](https://www.monocrawl.com/docs/endpoints/vinted/seller)

- [`seller-feedback`](https://www.monocrawl.com/docs/endpoints/vinted/seller-feedback)

- [`seller-items`](https://www.monocrawl.com/docs/endpoints/vinted/seller-items)



## Endpoint reference

## vinted/item

`GET /v1/vinted/item`

One item with its description, photos, asking price, fees where supplied, brand, size, condition and seller identifier. Missing optional values remain unknown.

*Vinted item*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Numeric identifier from a parent result. — e.g. `10062088255` |
| `market` | no | Market: gb or fr. Default gb. — e.g. `gb` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/vinted/item?id=10062088255" \
  -H "x-api-key: mn_your_key_here"
```


## vinted/price-suggestions

`GET /v1/vinted/price-suggestions`

Suggested asking-price range for a category, brand and condition in France. Guidance, not a guaranteed selling price.

*Vinted price suggestions*

| Parameter | Required | Description |
| --- | --- | --- |
| `category_id` | yes | Category identifier from an item. — e.g. `1824` |
| `brand_id` | yes | Brand identifier from an item. — e.g. `10` |
| `condition_id` | yes | Condition identifier from an item. — e.g. `1` |
| `market` | no | Currently fr only; default fr. — e.g. `fr` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/vinted/price-suggestions?category_id=1824&brand_id=10&condition_id=1" \
  -H "x-api-key: mn_your_key_here"
```


## vinted/search

`GET /v1/vinted/search`

Search second-hand items with prices, currencies, photos, brand, size, condition and seller identifiers. Uses cursor pagination; prices are asking prices.

*Vinted item search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search text. — e.g. `Levis 501` |
| `market` | no | Market: gb or fr. Default gb. — e.g. `gb` |
| `min_price` | no | Minimum item asking price. — e.g. `10` |
| `max_price` | no | Maximum item asking price. — e.g. `50` |
| `limit` | no | Results per page, 1 to 50. Keep unchanged between pages. — e.g. `10` |
| `cursor` | no | Opaque continuation from this operation; preserve all original parameters. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/vinted/search?query=Levis%20501" \
  -H "x-api-key: mn_your_key_here"
```


## vinted/search-by-image

`GET /v1/vinted/search-by-image`

Find visually related items from a Vinted item image. Similarity confidence scores are not supplied.

*Vinted image matches*

| Parameter | Required | Description |
| --- | --- | --- |
| `image_url` | yes | HTTPS images*.vinted.net image URL from an item result. |
| `market` | no | Market: gb or fr. Default gb. — e.g. `gb` |
| `limit` | no | Results per page, 1 to 50. Keep unchanged between pages. — e.g. `10` |
| `cursor` | no | Opaque continuation from this operation; preserve all original parameters. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
# Replace REPLACE_WITH_IMAGE_URL with the required input described in the parameter table.
curl "https://www.monocrawl.com/v1/vinted/search-by-image?image_url=REPLACE_WITH_IMAGE_URL" \
  -H "x-api-key: mn_your_key_here"
```


## vinted/seller

`GET /v1/vinted/seller`

Public seller profile, location, feedback counts and reputation, listing counts and follower counts where available.

*Vinted seller*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Numeric identifier from a parent result. — e.g. `3154597880` |
| `market` | no | Market: gb or fr. Default gb. — e.g. `gb` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/vinted/seller?id=3154597880" \
  -H "x-api-key: mn_your_key_here"
```


## vinted/seller-feedback

`GET /v1/vinted/seller-feedback`

Public seller feedback with text, ratings, dates and item identifiers.

*Vinted seller feedback*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Numeric identifier from a parent result. — e.g. `3154597880` |
| `market` | no | Market: gb or fr. Default gb. — e.g. `gb` |
| `limit` | no | Results per page, 1 to 50. Keep unchanged between pages. — e.g. `10` |
| `cursor` | no | Opaque continuation from this operation; preserve all original parameters. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/vinted/seller-feedback?id=3154597880" \
  -H "x-api-key: mn_your_key_here"
```


## vinted/seller-items

`GET /v1/vinted/seller-items`

Items listed by a public seller, with prices, images and continuation.

*Vinted seller items*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Numeric identifier from a parent result. — e.g. `3154597880` |
| `market` | no | Market: gb or fr. Default gb. — e.g. `gb` |
| `limit` | no | Results per page, 1 to 50. Keep unchanged between pages. — e.g. `10` |
| `cursor` | no | Opaque continuation from this operation; preserve all original parameters. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/vinted/seller-items?id=3154597880" \
  -H "x-api-key: mn_your_key_here"
```


## vinted/sold-comparables

`GET /v1/vinted/sold-comparables`

Comparable items reported as sold, with displayed prices and images. These amounts are not verified final negotiated transaction values.

*Vinted sold comparables*

| Parameter | Required | Description |
| --- | --- | --- |
| `category_id` | yes | Category identifier from an item. — e.g. `1824` |
| `brand_id` | yes | Brand identifier from an item. — e.g. `10` |
| `condition_id` | yes | Condition identifier from an item. — e.g. `1` |
| `market` | no | Market: gb or fr. Default gb. — e.g. `gb` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/vinted/sold-comparables?category_id=1824&brand_id=10&condition_id=1" \
  -H "x-api-key: mn_your_key_here"
```