{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Scraper ($0.59/1K): Search, Deals & Monitoring",
    "description": "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.",
    "version": "0.0",
    "x-build-id": "SvNruwgZmKlod2dM0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~vinted-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-vinted-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/tsutseisoftware~vinted-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-vinted-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/tsutseisoftware~vinted-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-vinted-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Vinted country sites to search (prices are in the currency of each site). An item listed on several sites is saved once.",
            "items": {
              "type": "string",
              "enum": [
                "fr",
                "de",
                "uk",
                "it",
                "es",
                "nl",
                "be",
                "at",
                "lu",
                "pl",
                "cz",
                "sk",
                "lt",
                "lv",
                "ee",
                "pt",
                "fi",
                "gr",
                "hr",
                "ie",
                "hu",
                "ro",
                "se",
                "dk"
              ],
              "enumTitles": [
                "France",
                "Germany",
                "United Kingdom",
                "Italy",
                "Spain",
                "Netherlands",
                "Belgium",
                "Austria",
                "Luxembourg",
                "Poland",
                "Czechia",
                "Slovakia",
                "Lithuania",
                "Latvia",
                "Estonia",
                "Portugal",
                "Finland",
                "Greece",
                "Croatia",
                "Ireland",
                "Hungary",
                "Romania",
                "Sweden",
                "Denmark"
              ]
            },
            "default": [
              "fr"
            ]
          },
          "startUrls": {
            "title": "Vinted URLs",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest_first",
              "relevance",
              "price_low_to_high",
              "price_high_to_low"
            ],
            "type": "string",
            "description": "Order of the results. Newest first is best for monitoring new items.",
            "default": "newest_first"
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "number",
            "description": "In the currency of the site (EUR on vinted.fr, GBP on vinted.co.uk, CZK on vinted.cz...)."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "number",
            "description": "In the currency of the site."
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Only items in these conditions (empty = all).",
            "items": {
              "type": "string",
              "enum": [
                "new_with_tags",
                "new_without_tags",
                "very_good",
                "good",
                "satisfactory"
              ],
              "enumTitles": [
                "New with tags",
                "New without tags",
                "Very good",
                "Good",
                "Satisfactory"
              ]
            }
          },
          "titleKeywords": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only items whose title contains any (or all, see below) of these words.",
            "items": {
              "type": "string"
            }
          },
          "keywordsMode": {
            "title": "Keywords must match",
            "enum": [
              "any",
              "all"
            ],
            "type": "string",
            "description": "For \"Title must contain\" and \"Text must contain\".",
            "default": "any"
          },
          "excludeKeywords": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Leave out items whose title contains any of these words (e.g. case, box, broken).",
            "items": {
              "type": "string"
            }
          },
          "titleMustContainQuery": {
            "title": "Title must contain the search words",
            "type": "boolean",
            "description": "Vinted also returns loosely related items; keep only those whose title, brand or model has every search word.",
            "default": false
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Keep only items of these brands, as Vinted names them (e.g. Nike, Levi's).",
            "items": {
              "type": "string"
            }
          },
          "sizes": {
            "title": "Sizes",
            "type": "array",
            "description": "Keep only items of these sizes, as the site shows them (e.g. M, 42, W32).",
            "items": {
              "type": "string"
            }
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "any",
              "private",
              "business"
            ],
            "type": "string",
            "description": "Private or business sellers.",
            "default": "any"
          },
          "excludePromoted": {
            "title": "Exclude promoted items",
            "type": "boolean",
            "description": "Leave out items the seller paid to show higher.",
            "default": false
          },
          "minFavourites": {
            "title": "Min favourites",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only items at least this many members added to their favourites."
          },
          "excludeOutlierPrices": {
            "title": "Exclude implausible prices",
            "type": "boolean",
            "description": "Leave out items priced at less than a fifth or more than five times the usual price of comparable items.",
            "default": false
          },
          "maxPriceVsMedianPercent": {
            "title": "Max price vs. usual price (%)",
            "type": "integer",
            "description": "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": {
            "title": "Min deal score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep only items with at least this deal score (50 = the usual price, higher = cheaper)."
          },
          "includeDetails": {
            "title": "Add item details",
            "type": "boolean",
            "description": "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).",
            "default": false
          },
          "descriptionKeywords": {
            "title": "Text must contain",
            "type": "array",
            "description": "With \"Add item details\": keep only items whose title or description contains any (or all) of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeDescriptionKeywords": {
            "title": "Text must not contain",
            "type": "array",
            "description": "With \"Add item details\": leave out items whose title or description contains any of these words.",
            "items": {
              "type": "string"
            }
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Only the main fields: title, price, total price, brand, size, condition, favourites, seller type, photo, country, deal score, URL.",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of items saved. You pay per saved item. 0 = no limit.",
            "default": 100
          },
          "maxItemsPerSearch": {
            "title": "Max items per search",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum per keyword and country (or per URL). Empty = no limit."
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Pages of 96 items read per search; Vinted shows at most 10 (960 items). Empty = all."
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed items",
            "type": "boolean",
            "description": "Return new items, and items whose price or title changed (with previousPrice and the change in %).",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name of the remembered state; use a different key for every saved search. Empty = \"default\"."
          },
          "monitoringEarlyStop": {
            "title": "Monitoring: stop at known items",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "onlyNew": {
            "title": "Monitoring: only new items",
            "type": "boolean",
            "description": "Return new items only, not changed ones.",
            "default": false
          },
          "onlyPriceDrops": {
            "title": "Monitoring: only price drops",
            "type": "boolean",
            "description": "Of the changed items, return only those whose price went down.",
            "default": false
          },
          "minPriceDropPercent": {
            "title": "Monitoring: min price drop (%)",
            "minimum": 0,
            "type": "integer",
            "description": "Of the changed items, return only those whose price went down by at least this many %."
          },
          "includeRemovedListings": {
            "title": "Monitoring: report sold and removed items",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "skipFirstRun": {
            "title": "Monitoring: silent first run",
            "type": "boolean",
            "description": "The first run only remembers the items and returns nothing; later runs return what is new.",
            "default": false
          },
          "resetMonitoring": {
            "title": "Monitoring: start again",
            "type": "boolean",
            "description": "Forget the remembered items of this Monitoring key.",
            "default": false
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Token of your bot from @BotFather."
          },
          "telegramChatId": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Chat to send to."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook (https://hooks.slack.com/...)."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Any HTTPS URL (Zapier, Make, n8n, your server): receives the items as JSON."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp access token",
            "type": "string",
            "description": "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": {
            "title": "WhatsApp phone number ID",
            "type": "string",
            "description": "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": {
            "title": "WhatsApp recipient number",
            "type": "string",
            "description": "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": {
            "title": "WhatsApp template name",
            "type": "string",
            "description": "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": {
            "title": "WhatsApp template language",
            "type": "string",
            "description": "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\".",
            "default": "en_US"
          },
          "notificationLimit": {
            "title": "Max items per notification",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many items the message lists.",
            "default": 10
          },
          "notifyOnlyChanges": {
            "title": "Notify only when something was found",
            "type": "boolean",
            "description": "No message after a run that saved nothing.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "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).",
            "default": {
              "useApifyProxy": false
            }
          },
          "sendErrorReports": {
            "title": "Send error reports",
            "type": "boolean",
            "description": "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.",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}