# Vinted Product Scraper data API: fields, sample output and cost per 1,000 rows

Collect public Vinted listings by search word or catalog link: title, brand, size, condition, price with currency, total with the buyer fee, favourites, photo and link.

This is the reference for the Actor `v0iddo/vinted-scraper`: what is in every output row, what the input takes, and what a run costs. Values below come from a real run of the Actor.

## At a glance

| | |
| --- | --- |
| Actor | `v0iddo/vinted-scraper` |
| Store page | [Vinted Product Scraper](https://apify.com/v0iddo/vinted-scraper) |
| Output | one row per result, as JSON, CSV, Excel or HTML |
| Fields per row | 16 (8 text, 5 number, 1 URL, 1 image URL, 1 true/false) |
| Cap on results | `maxItems` in the input |
| Price | $0.85 per 1,000 results |

## Output fields

Each result is one row with these fields (fields that name people are left out):

| Field | Type | Meaning | Sample value |
| --- | --- | --- | --- |
| `title` | text | Item | Nike jumper |
| `brand` | text | Brand | Nike |
| `size` | text | Size | L / UK 16-18 |
| `condition` | text | Condition | Very good |
| `price` | number | Price | 5 |
| `currency` | text | Currency | GBP |
| `totalPrice` | number | Total with buyer fee | 5.95 |
| `favourites` | number | Favourites | 34 |
| `photo` | image URL | Photo | https://images1.vinted.net/t/0500934pxGCuCADsZBpL9gjC4T32AkG/f800... |
| `url` | URL | Link | https://www.vinted.co.uk/items/10533071387-nike-jumper |
| `itemId` | text |  | 10533071387 |
| `buyerFee` | number |  | 0.95 |
| `promoted` | true/false |  | false |
| `domain` | text |  | vinted.co.uk |
| `query` | text |  | nike |
| `sourcePage` | number |  | 1 |

## One record

```json
{
  "itemId": "10533071387",
  "title": "Nike jumper",
  "brand": "Nike",
  "size": "L / UK 16-18",
  "condition": "Very good",
  "price": 5,
  "currency": "GBP",
  "buyerFee": 0.95,
  "totalPrice": 5.95,
  "favourites": 34,
  "promoted": false,
  "photo": "https://images1.vinted.net/t/05_00934_pxGCuCADsZBpL9gjC4T32AkG/f800/33c75d64.webp?s=123fa96aeb634fc48b79b408820a6036caa37a49",
  "url": "https://www.vinted.co.uk/items/10533071387-nike-jumper",
  "domain": "vinted.co.uk",
  "query": "nike",
  "sourcePage": 1
}
```

## Input parameters

| Parameter | Type | Required | Default | What it does |
| --- | --- | --- | --- | --- |
| `searchTerms` | array | no | ["nike"] | Words to search for, for example nike air max or vintage jacket. |
| `catalogUrls` | array | no |  | Optional Vinted catalog or search links such as https://www.vinted.co.uk/catalog/10-dresses or https://www.vinted.co.uk/catalog?search_text=nike. |
| `domain` | string | no | vinted.co.uk | Which Vinted site the search terms are run on. |
| `sortBy` | string | no | relevance | Order of the results for the search terms. |
| `priceFrom` | string | no |  | Optional lowest item price as a number such as 5 or 12.50, in the currency of the country site. |
| `priceTo` | string | no |  | Optional highest item price as a number such as 40 or 99.99, in the currency of the country site. |
| `maxPages` | integer | no | 2 | How many result pages to read for each search or link, 96 items per page. |
| `maxItems` | integer | no | 100 | The run stops after this many result rows. |

## Ready-made examples

Saved inputs on Apify: run one as it is, or copy it and change the values.

- [Vinted UK listings for Carhartt jackets, newest first](https://apify.com/v0iddo/vinted-scraper/examples/vinted-uk-carhartt-jacket-newest)
- [Vinted France prices for Adidas Samba, 20 to 60 EUR](https://apify.com/v0iddo/vinted-scraper/examples/vinted-france-adidas-samba-prices)

## Cost per 1,000 rows

$0.85 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $0.59 per 1,000.

| Results | Cost at the listed price | Cost at the lowest plan price |
| --- | --- | --- |
| 100 | $0.09 | $0.06 |
| 1,000 | $0.85 | $0.59 |
| 10,000 | $8.50 | $5.95 |
| 100,000 | $85.00 | $59.50 |

The figures are the listed price times the number of results. The `maxItems` limit and the maximum cost setting in the run options both stop a run before it spends more than you planned.

## Get the rows as CSV over HTTP

One request starts a run, waits for it and returns the dataset. The `format` parameter picks the file type and `fields` picks the columns. Replace the token with the one from Apify Console, Settings, Integrations.

```bash
curl -X POST "https://api.apify.com/v2/acts/v0iddo~vinted-scraper/run-sync-get-dataset-items?format=csv&fields=title,brand,size" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["nike"], "maxItems": 20}'
```

## Good to know

- A page holds 96 items and Vinted shows about 10 pages (960 items) for one search. Use price ranges, other sort orders or more search terms to reach further.
- Total with buyer fee is the price plus Vinted's buyer protection fee, as shown on the listing card. Shipping is not included.
- Sellers are never collected: no names, ids, profiles or ratings. Only the listing itself is read.
- Size is empty for items without a size (bags, books, home goods). vinted.co.uk is the best-tested site; the other country sites use the same page layout.

## Links

- Actor on the Apify Store: [Vinted Product Scraper](https://apify.com/v0iddo/vinted-scraper)
- Guide with the Python and JavaScript code: [https://voidd0.github.io/vinted-scraper/](https://voidd0.github.io/vinted-scraper/)