# Vinted Scraper ($0.59/1K): Search, Deals & Monitoring (`tsutseisoftware/vinted-scraper`) Actor

Scrape Vinted in 24 countries (fr, de, uk, it, es, pl, cz...) by keyword or URL: price, buyer total, brand, size, condition, favourites, photos; details, deal score, monitoring of new, cheaper and sold items, alerts. No login. Unofficial.

- **URL**: https://apify.com/tsutseisoftware/vinted-scraper.md
- **Developed by:** [Tsutsei Software](https://apify.com/tsutseisoftware) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.31 / 1,000 items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Vinted Scraper: Search, Deals & Monitoring in 24 Countries

Scrape **Vinted** listings by keyword or by any search URL from **24 Vinted country sites** (France, Germany, United Kingdom, Italy, Spain, Netherlands, Belgium, Poland, Czechia, Slovakia, Lithuania and more). You get price, buyer total, brand, size, condition, favourites, seller type and photos for every item, a **deal score** against comparable items, and optionally the item details: description, category, colour and the seller's own price and currency. Built for **resellers, deal hunters, price trackers and market researchers**.

**$0.59 per 1 000 items**, $0.31 on Gold. No login, no cookies, no proxy setup.

### Why use this Vinted scraper?

- 🌍 **Every big Vinted site in one run:** search the same keywords in several countries at once; prices come in each site's currency, and an item listed on several sites is saved once.
- 🔍 **Vinted's own filters plus yours:** price range, condition and sort order of the website, any filter through a copied search URL (category, brand, size, colour, material), and filters Vinted doesn't have: title must or must not contain, title must contain all search words, brand, size, private or business seller, no promoted items, minimum favourites. Items left out are not charged.
- 💸 **Deal score on every item:** each item is compared with similar items of the same run (the same kind of item, not its accessories). `dealScore` 50 = the usual price, higher = cheaper. Filter by it, or by "at least 20 % under the usual price".
- 🏷️ **Condition in English on every site:** `conditionCode` (new_with_tags, new_without_tags, very_good, good, satisfactory) next to the site's own wording, so French, German and Polish results compare directly.
- 🔔 **Monitoring with alerts:** scheduled runs return only new items and price changes, optionally only price drops, and on request the items that were **sold or removed**. Alerts to Telegram, Slack, Discord, WhatsApp or any webhook.
- 🔒 **Privacy first:** sellers' user names, profiles and IDs are never collected; e-mails, phone numbers and chat links are removed from descriptions.
- 📊 **Free market summary** for every search: price range and quartiles, conditions, top brands and sizes, share of business sellers.

| | This actor | Typical Vinted scraper |
|---|---|---|
| Price per 1 000 items | **$0.59** (Gold $0.31) | $0.63–2.50 |
| With details | **$0.84** (Gold $0.56) | $1.40–10.00 |
| Deal score against similar items | ✅ | rare |
| Sold and removed items in monitoring | ✅ | rare |
| Condition in English on every site | ✅ | rare |
| Seller names and profiles | not collected | often collected |

### What data can you get?

| Group | Fields |
|---|---|
| Item | `id`, `url`, `title`, `brand`, `model`, `size`, `condition`, `conditionCode`, `favouriteCount`, `isPromoted`, `imageUrl`, `imageUrls` |
| Price | `price`, `currency`, `serviceFee` (buyer protection), `totalPrice` |
| Seller | `sellerType` (private or business) only |
| Search | `country`, `domain`, `searchQuery`, `searchUrl`, `position` |
| Deal | `comparableCount`, `comparableMedianPrice`, `priceVsMedianPercent`, `dealScore` |
| With details | `description`, `category`, `color`, `originalPrice` and `originalCurrency` (the seller's own price), `isSold` |
| Monitoring | `changeType` (new, updated, reappeared, removed), `firstSeenAt`, `previousPrice`, `priceChange`, `priceChangePercent`, `removedAt`, `removedReason` |

Measured on about 1 000 items of 10 sites (13 Nov 2026): price, total, brand, condition, condition code and photo on 100 % of items, size on 97–100 % of clothes and shoes (phones and gadgets have none). The deal score is filled for 85–90 % of items of a phone search and for 10–35 % of a broad fashion search read one page deep (fashion titles vary more; narrower keywords and more pages give more). With details: description, category and colour on 100 % of the items tested.

Vinted shows only how long ago an item was listed, not a date; in monitoring, `firstSeenAt` tells you when the actor first saw it.

### How to scrape Vinted

1. Type keywords in **Search keywords** (e.g. `nike air max 90`) and pick the **Countries**, or paste search URLs from your browser into **Vinted URLs**.
2. Optionally set the price range, condition and the actor's filters.
3. Set **Max items** and press **Start**.
4. Download the results as JSON, CSV or Excel, or get them through the Apify API.

### Use cases

#### Newest Nike Air Max 90 in France and Germany

```json
{
  "searchQueries": ["nike air max 90"],
  "countries": ["fr", "de"],
  "sortBy": "newest_first",
  "maxItems": 200
}
```

#### Deals: iPhone 13 at least 20 % under the usual price, to Telegram every 15 minutes

Schedule this input every 15 minutes:

```json
{
  "searchQueries": ["iphone 13 128"],
  "countries": ["fr"],
  "titleMustContainQuery": true,
  "excludeKeywords": ["coque", "case", "écran", "pièces"],
  "maxPriceVsMedianPercent": -20,
  "onlyNewOrChanged": true,
  "monitoringKey": "iphone13-fr",
  "telegramBotToken": "123456:ABC...",
  "telegramChatId": "123456789"
}
```

#### Price drops and sold items of a narrow search

```json
{
  "searchQueries": ["levis 501"],
  "countries": ["uk"],
  "sizes": ["W32"],
  "conditions": ["very_good", "new_without_tags"],
  "onlyNewOrChanged": true,
  "monitoringKey": "levis501-w32",
  "monitoringEarlyStop": false,
  "includeRemovedListings": true
}
```

Sold and removed items can be reported for searches Vinted shows in full (up to 960 items): keep the search narrow with filters.

#### A search copied from the browser, and single items

```json
{
  "startUrls": [
    { "url": "https://www.vinted.de/catalog?search_text=carhartt&order=newest_first" },
    { "url": "https://www.vinted.fr/items/1234567890-example" }
  ],
  "maxItems": 100
}
```

Item URLs are read with their details, size, condition and seller type; their price is the seller's own price in the seller's currency (`currency`), without the buyer protection fee, which Vinted adds only in search results. When Vinted refuses an item's page, the actor finds the item in the website's search by the words of its URL and saves it with its search data instead (`detailsIncluded` is `false`, `searchQuery` holds the words searched).

#### Market research: one brand in five countries, with details

```json
{
  "searchQueries": ["arc'teryx"],
  "countries": ["fr", "de", "uk", "it", "pl"],
  "includeDetails": true,
  "maxItemsPerSearch": 200
}
```

Item pages are read at a gentle pace, so 1 000 items with details take about 50 minutes (about $0.85).

#### Deal score, explained

Every item is compared with similar items of the same run: the same kind of item (same model, not its accessories) and the same currency. `comparableMedianPrice` is their median price, `priceVsMedianPercent` how much cheaper or dearer the item is, and `dealScore` 50 = the usual price, higher = cheaper, 100 = free. With too few comparable items the fields stay empty. More pages read = a better reference.

#### Monitoring mode, explained

With **Monitoring: only new or changed items**, the actor remembers the items of each run (in your own Apify account, under the **Monitoring key**) and the next run returns only new items and items whose price or title changed, with `previousPrice` and the change in %. With newest first, a check stops at the first page without anything new, so a check every few minutes costs a fraction of a cent. **Monitoring: report sold and removed items** checks the items that vanished and returns them with `removedReason` sold, removed or noLongerMatches.

### How much does it cost to scrape Vinted?

| | Price |
|---|---|
| Item | **$0.59 per 1 000** (Bronze $0.51, Silver $0.40, Gold and higher $0.31) |
| Add item details | **+$0.25 per 1 000** (= $0.84 per 1 000 with details) |
| Run start | $0.003 per run |
| Extra page | $0.30 per 1 000 pages read beyond what the saved items explain (narrow filters that leave out most items) |
| Monitoring page | $0.30 per 1 000 pages read in monitoring mode, and per sold/removed check |
| Notification | $0.001 per run that sent a notification |

Examples: 1 000 items cost about **$0.60**, 1 000 items with details about **$0.85**. A monitoring check every 15 minutes that finds a few new items costs about **$0.004**, about $0.40 a day. With the $5 of free monthly credit on the Apify free plan you get about **8 000 items**.

Items left out by your filters and unchanged items in monitoring are never charged as items. If the saved items don't cover a run's cost (e.g. a search with no results), the difference is charged as extra pages; the log says how many. A normal run pays nothing more. You can set a **maximum cost per run**; the run then stops before it is spent. Platform usage is included in the price.

### Input example

```json
{
  "searchQueries": ["nike air max 90"],
  "countries": ["fr"],
  "sortBy": "newest_first",
  "maxPrice": 80,
  "conditions": ["very_good", "new_without_tags"],
  "maxItems": 20
}
```

### Output example

```json
{
  "id": "10796391766",
  "source": "vinted",
  "url": "https://www.vinted.fr/items/10796391766-nike-air-max-90",
  "title": "Nike Air Max 90",
  "price": 45.0,
  "currency": "EUR",
  "serviceFee": 2.95,
  "totalPrice": 47.95,
  "brand": "Nike",
  "model": null,
  "size": "42",
  "condition": "Très bon état",
  "conditionCode": "very_good",
  "favouriteCount": 7,
  "isPromoted": false,
  "sellerType": "private",
  "imageUrl": "https://images1.vinted.net/t/.../f800/....webp",
  "imageUrls": ["https://images1.vinted.net/t/.../f800/....webp"],
  "country": "fr",
  "domain": "www.vinted.fr",
  "searchQuery": "nike air max 90",
  "searchUrl": "https://www.vinted.fr/catalog?search_text=nike%20air%20max%2090&order=newest_first",
  "position": 1,
  "detailsIncluded": false,
  "description": null,
  "category": null,
  "color": null,
  "originalPrice": null,
  "originalCurrency": null,
  "isSold": null,
  "comparableCount": 24,
  "comparableMedianPrice": 55,
  "priceVsMedianPercent": -18.2,
  "dealScore": 59,
  "changeType": null,
  "firstSeenAt": null,
  "previousPrice": null,
  "priceChange": null,
  "priceChangePercent": null,
  "removedAt": null,
  "removedReason": null,
  "scrapedAt": "2026-11-13T20:00:00Z"
}
```

The run's key-value store also has a free **SUMMARY** for every search: the number of items Vinted reports, items read and saved, prices by currency (min, quartiles, median, mean, max), conditions, top brands and sizes, and shares of business sellers and promoted items.

### Limitations

- **Vinted shows at most 960 items (10 pages of 96) for one search.** For more, split the search with filters (price range, condition, size, category); the status message says when a search reached the limit.
- **Prices** are in the currency of the site searched; Vinted converts the price of sellers from other countries. With details, `originalPrice` and `originalCurrency` are the seller's own.
- **No listing date:** Vinted shows only how long ago an item was listed. Use monitoring and `firstSeenAt`.
- **Seller names and profiles are not collected**, only whether the seller is a business.
- **Sold items** can be reported in monitoring only for searches read to their end (up to 960 items, "Monitoring: stop at known items" off).
- **Condition codes** in English cover the condition wordings of all 24 sites (checked 13 Nov 2026); if Vinted renames a condition, `conditionCode` stays empty until the actor is updated, the site's wording is always in `condition`.

### For AI agents and API users

Call it with the Apify API, the Apify MCP server or any Apify integration: `POST https://api.apify.com/v2/acts/tsutseisoftware~vinted-scraper/run-sync-get-dataset-items` with the input as JSON. Every item has a stable `id`; prices are numbers with a separate `currency`; empty values are `null`. Start small (`maxItems` 20) and add `includeDetails` only when you need the description.

### Troubleshooting

- **"Vinted refused the requests, nothing was saved."** Vinted turned the run away. Try again later; if it keeps happening, set **Proxy configuration** to Apify Proxy.
- **"... reached the most Vinted shows for one search (960 items)"**: split the search with filters for more.
- **"Text must contain ... look into the description"**: turn on **Add item details**, or use **Title must contain**.
- **Fewer items than Max items:** the search has fewer items, your filters left some out (the status message counts them), or monitoring returned only new and changed ones.
- **Sold items not reported:** the status message says why (the search was not read to its end, or the early stop is on).

### More classified-ad scrapers

The same deal score, monitoring and alerts for another classified-ad site:

- [Bazoš Scraper & New Ad Monitor](https://apify.com/tsutseisoftware/bazos-scraper): Bazoš.cz, .sk, .pl and .at: any section or search, deal score, car fields, new and cheaper ads with alerts
- [Facebook Marketplace Scraper](https://apify.com/tsutseisoftware/facebook-marketplace-scraper): any town, ZIP code or coordinates with a strict radius: price, place, seller, deal score, sold listings, alerts
- [AutoScout24 Scraper](https://apify.com/tsutseisoftware/autoscout24-scraper): used and new cars from all 8 AutoScout24 countries: price rating, deal score, full specs, dealer stocks, sold listings, alerts
- [Kleinanzeigen Scraper & New Ad Monitor](https://apify.com/tsutseisoftware/kleinanzeigen-scraper): Germany's biggest classifieds: searches past 1,250 ads, deal score, vehicle and electronics fields, price check, new and cheaper ads with alerts
- [Craigslist Scraper](https://apify.com/tsutseisoftware/craigslist-scraper): any Craigslist site, a whole state or country in one run: up to 10,000 ads per search, deal score, removed ads, new ad alerts

### Integrations

Connect the results to the tools you already use with the built-in integrations of Apify (the **Integrations** tab of the actor or of a saved task), with no code:

- **Google Sheets or Google Drive:** the results of every run in a spreadsheet or a file.
- **Zapier, Make and n8n:** start a workflow when a run finishes, or start the actor from one.
- **Slack or e-mail:** a message from Apify when a run finishes or fails.
- **Webhooks:** your own address gets the details of each run.
- **API and MCP:** run the actor from your code, or let an AI assistant run it through the Apify MCP server.

The results also download as Excel, CSV, JSON or XML from the **Output** tab.

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### WhatsApp notifications: setup

The actor sends the message from your own WhatsApp business number through the WhatsApp Cloud API of your Meta business account. You need a Meta business account; the actor uses only the values you enter in the **Notifications** section (the token and the numbers are stored encrypted and never written to the log).

1. **Create an app.** In Meta for Developers open **My Apps → Create app** and choose the use case **Connect with customers through WhatsApp**.
2. **Get a sending number.** In the app open **WhatsApp → API Setup**. You can start with the test number Meta gives you and add your own business number there later. Copy the **Phone number ID** (not the number itself) into **WhatsApp phone number ID**.
3. **Confirm the recipients (test number only).** A test number sends only to numbers on its list: in **API Setup**, under **To**, add each recipient's number and confirm it with the code WhatsApp sends to it.
4. **Create a permanent access token.** The token shown in API Setup expires within hours. In **Business settings → System users** add a system user, use **Assign assets** to give it your app (and your WhatsApp account), then **Generate token** for the app with the permissions `whatsapp_business_messaging` and `whatsapp_business_management` and the expiry you want. Paste it into **WhatsApp access token**.
5. **Create a message template (recommended).** In **WhatsApp Manager → Message templates → Create template** choose the category **Utility**, a name (e.g. `apify_results`) and a language, and write a body with two variables, for example: `New results of your Apify task: {{1}} Open the dataset: {{2}} (sent automatically after each run).` Meta does not accept a body that starts or ends with a variable and asks for sample values (e.g. `3 new jobs` and a dataset link); keep the text factual, a promotional text is moved to the Marketing category. Approval can take up to 24 hours. Enter the name in **WhatsApp template name** and its language code (e.g. `en_US`, `cs`, `pl`, `de`, as WhatsApp Manager shows it) in **WhatsApp template language**.
6. **Enter the recipients.** **WhatsApp recipient number** takes up to 5 numbers with the country code (e.g. `+420601234567`), separated by commas or new lines. Each number gets its own message.

**What the message contains.** With a template: `{{1}}` is the run summary with the first results on one line (title, company or price, place; never descriptions or contacts) and `{{2}}` the link to the dataset. A template with only `{{1}}` works too, it then gets the link at the end. Without a template the actor sends a text message with one link per result, like in Slack or Telegram.

**Without a template** WhatsApp delivers the message only when the recipient wrote to your business number in the last 24 hours (the customer service window), so a daily or hourly schedule needs a template. The run log says so once per run.

**What it costs.** Meta bills your business account, not this actor: per delivered message, by the message category (a template of the Utility category, or a service message for text in the 24-hour window, with a monthly free allowance per business number) and by the recipient's country. The current rates are in Meta's pricing of the WhatsApp Business Platform. The actor's own notification charge (see the **Pricing** tab) is once per run that delivered its notification, whatever the number of channels and recipients.

**Checked at the start.** When the run starts, the actor checks the token, the phone number ID and, when the token shows its WhatsApp account, the template (name, language, approval), without sending anything. Settings that can't work stop the run with a message that says what to fix, before anything is read from the website.

**When nothing arrives**, the run log names the WhatsApp error and what to do: a template that does not exist in that language or is not approved yet, a template with another number of variables, a recipient missing from the test number's list, an expired token, or the 24-hour window. A failed notification never fails the run and is not charged. Meta can accept a message and still not deliver it later (for example when the recipient's phone is not on WhatsApp); such a run counts as notified.

### FAQ

#### Is it legal to scrape Vinted?

It reads only publicly available data, without logging in, at most 30 requests per minute, slows down when the website asks, never changes IP address to get around a limit and never solves captchas or other challenges. It does not collect sellers' names, user names or profiles and removes contacts from descriptions. You are responsible for how you use the data (e.g. GDPR if you process anything personal, and the website's terms). This is an unofficial tool, not connected with Vinted.

#### How is it different from other Vinted scrapers?

It searches several Vinted countries in one run, compares every item with similar items (deal score), gives the condition in English on every site, reports sold and removed items in monitoring, sends alerts, and does not collect personal data of sellers, for a lower price per item.

#### Do I need a Vinted account, cookies or a proxy?

No.

#### Which countries work?

France, Germany, United Kingdom, Italy, Spain, Netherlands, Belgium, Austria, Luxembourg, Poland, Czechia, Slovakia, Lithuania, Latvia, Estonia, Portugal, Finland, Greece, Croatia, Ireland, Hungary, Romania, Sweden and Denmark.

#### Can I get the seller's name or profile?

No. Seller data are personal data of private people; the actor tells only whether the seller is a business.

#### How often can I run a monitor?

As often as you like; with newest first, a check without news reads one page and costs about $0.003.

This actor is also known as a Vinted API, Vinted price tracker, Vinted bot for new listings or Vinted deal finder.

# Changelog

This Actor's version history is a separate document: https://apify.com/tsutseisoftware/vinted-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

What to search for, as you would type it on Vinted (e.g. nike air max 90, iphone 13). Every keyword is searched in every country below.

## `countries` (type: `array`):

Vinted country sites to search (prices are in the currency of each site). An item listed on several sites is saved once.

## `startUrls` (type: `array`):

Search, catalog or brand pages copied from the browser with any filters (e.g. https://www.vinted.de/catalog?search_text=levis\&brand_ids\[]=10\&order=newest_first), and item URLs (https://www.vinted.fr/items/123456789-..., read with their details). Any Vinted country site. A URL keeps its own sort order; without one, "Sort by" applies. Member pages are not read.

## `sortBy` (type: `string`):

Order of the results. Newest first is best for monitoring new items.

## `minPrice` (type: `number`):

In the currency of the site (EUR on vinted.fr, GBP on vinted.co.uk, CZK on vinted.cz...).

## `maxPrice` (type: `number`):

In the currency of the site.

## `conditions` (type: `array`):

Only items in these conditions (empty = all).

## `titleKeywords` (type: `array`):

Keep only items whose title contains any (or all, see below) of these words.

## `keywordsMode` (type: `string`):

For "Title must contain" and "Text must contain".

## `excludeKeywords` (type: `array`):

Leave out items whose title contains any of these words (e.g. case, box, broken).

## `titleMustContainQuery` (type: `boolean`):

Vinted also returns loosely related items; keep only those whose title, brand or model has every search word.

## `brands` (type: `array`):

Keep only items of these brands, as Vinted names them (e.g. Nike, Levi's).

## `sizes` (type: `array`):

Keep only items of these sizes, as the site shows them (e.g. M, 42, W32).

## `sellerType` (type: `string`):

Private or business sellers.

## `excludePromoted` (type: `boolean`):

Leave out items the seller paid to show higher.

## `minFavourites` (type: `integer`):

Keep only items at least this many members added to their favourites.

## `excludeOutlierPrices` (type: `boolean`):

Leave out items priced at less than a fifth or more than five times the usual price of comparable items.

## `maxPriceVsMedianPercent` (type: `integer`):

Keep only items at most this many % above (or, negative, below) the usual price of comparable items, e.g. -20 = at least 20 % cheaper.

## `minDealScore` (type: `integer`):

Keep only items with at least this deal score (50 = the usual price, higher = cheaper).

## `includeDetails` (type: `boolean`):

Read every item's own page: description, category, colour, the seller's own price and currency, and whether it is still for sale. Charged as "Item details" ($0.25 per 1 000 items) and slower (one page per item).

## `descriptionKeywords` (type: `array`):

With "Add item details": keep only items whose title or description contains any (or all) of these words.

## `excludeDescriptionKeywords` (type: `array`):

With "Add item details": leave out items whose title or description contains any of these words.

## `compact` (type: `boolean`):

Only the main fields: title, price, total price, brand, size, condition, favourites, seller type, photo, country, deal score, URL.

## `maxItems` (type: `integer`):

Maximum number of items saved. You pay per saved item. 0 = no limit.

## `maxItemsPerSearch` (type: `integer`):

Maximum per keyword and country (or per URL). Empty = no limit.

## `maxPagesPerSearch` (type: `integer`):

Pages of 96 items read per search; Vinted shows at most 10 (960 items). Empty = all.

## `onlyNewOrChanged` (type: `boolean`):

Return new items, and items whose price or title changed (with previousPrice and the change in %).

## `monitoringKey` (type: `string`):

Name of the remembered state; use a different key for every saved search. Empty = "default".

## `monitoringEarlyStop` (type: `boolean`):

With newest first: stop a search at the first page without anything new (fast, cheap checks every few minutes). Turn it off to see price changes of older items and to report sold items.

## `onlyNew` (type: `boolean`):

Return new items only, not changed ones.

## `onlyPriceDrops` (type: `boolean`):

Of the changed items, return only those whose price went down.

## `minPriceDropPercent` (type: `integer`):

Of the changed items, return only those whose price went down by at least this many %.

## `includeRemovedListings` (type: `boolean`):

Items of the previous run that are gone: the actor checks each one and returns it with removedReason sold, removed or noLongerMatches. Works for searches Vinted shows in full (up to 960 items) with "Monitoring: stop at known items" off. Each check is charged as a monitoring page.

## `skipFirstRun` (type: `boolean`):

The first run only remembers the items and returns nothing; later runs return what is new.

## `resetMonitoring` (type: `boolean`):

Forget the remembered items of this Monitoring key.

## `telegramBotToken` (type: `string`):

Token of your bot from @BotFather.

## `telegramChatId` (type: `string`):

Chat to send to.

## `slackWebhookUrl` (type: `string`):

Incoming webhook (https://hooks.slack.com/...).

## `discordWebhookUrl` (type: `string`):

Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted.

## `webhookUrl` (type: `string`):

Any HTTPS URL (Zapier, Make, n8n, your server): receives the items as JSON.

## `whatsappAccessToken` (type: `string`):

Access token of the WhatsApp Cloud API of your Meta business account, used with "WhatsApp phone number ID" and "WhatsApp recipient number" (step by step in the README, section "WhatsApp notifications: setup"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted.

## `whatsappPhoneNumberId` (type: `string`):

ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID.

## `whatsappTo` (type: `string`):

Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted.

## `whatsappTemplateName` (type: `string`):

Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section "WhatsApp notifications: setup").

## `whatsappTemplateLanguage` (type: `string`):

Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with "WhatsApp template name".

## `notificationLimit` (type: `integer`):

How many items the message lists.

## `notifyOnlyChanges` (type: `boolean`):

No message after a run that saved nothing.

## `proxyConfiguration` (type: `object`):

No proxy needed. If Vinted keeps refusing your runs, switch to Apify Proxy; a run through a residential proxy may be charged a little more to cover its traffic (the log says how much).

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "searchQueries": [
    "nike air max 90"
  ],
  "countries": [
    "fr"
  ],
  "sortBy": "newest_first",
  "keywordsMode": "any",
  "titleMustContainQuery": false,
  "sellerType": "any",
  "excludePromoted": false,
  "excludeOutlierPrices": false,
  "includeDetails": false,
  "compact": false,
  "maxItems": 20,
  "onlyNewOrChanged": false,
  "monitoringEarlyStop": true,
  "onlyNew": false,
  "onlyPriceDrops": false,
  "includeRemovedListings": false,
  "skipFirstRun": false,
  "resetMonitoring": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "sendErrorReports": true
}
```

# Actor output Schema

## `items` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "nike air max 90"
    ],
    "countries": [
        "fr"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/vinted-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["nike air max 90"],
    "countries": ["fr"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/vinted-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "nike air max 90"
  ],
  "countries": [
    "fr"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call tsutseisoftware/vinted-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tsutseisoftware/vinted-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/khtFpmBqfosCnIsaT/builds/SvNruwgZmKlod2dM0/openapi.json
