{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Scraper — Listings, Prices, Sellers & Item Details",
    "description": "Vinted scraper for 27 country sites (vinted.fr, .de, .co.uk, .pl, .it, .es, .com …): export listings with brand, size, condition, price, buyer-protection fee, favourites, views, photos and seller, plus item details and seller ratings. Splits big searches past Vinted's 960 limit. No login.",
    "version": "1.0",
    "x-build-id": "EYgSFHU3LzsZ9gepf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/logiover~vinted-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-logiover-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/logiover~vinted-scraper/runs": {
      "post": {
        "operationId": "runs-sync-logiover-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/logiover~vinted-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-logiover-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": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "search",
              "urls",
              "items",
              "sellers"
            ],
            "type": "string",
            "description": "Search: listings matching your search terms and filters on the chosen country sites. Vinted URLs: paste catalogue / search / brand pages from any Vinted site (item and member URLs are recognised too). Item details: full data for a list of item URLs or IDs (description, every photo, colour, material, category, shipping, seller profile). Sellers: every listing of the members you give, with their profile.",
            "default": "search"
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "What you would type in Vinted's search box, e.g. \"nike air max\", \"levi's 501\", \"robe zara\", \"pokemon cards\". Each term is one search on every selected country site. Leave empty to list everything that matches the filters below (e.g. a brand or a category).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Vinted URLs",
            "type": "array",
            "description": "Catalogue or search pages copied from your browser, e.g. https://www.vinted.fr/catalog?search_text=nike&brand_ids[]=53&order=newest_first, https://www.vinted.de/catalog/1242-trainers or https://www.vinted.co.uk/brand/53-nike. All filters in the URL are kept and the country comes from the domain. Item URLs (/items/…) and member URLs (/member/…) are handled as item details and seller listings. Used when \"What to scrape\" is Vinted URLs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "itemUrls": {
            "title": "Item URLs or IDs",
            "type": "array",
            "description": "Vinted item URLs (https://www.vinted.fr/items/1234567890-…) or bare item IDs (taken on the first selected country site). Each one becomes one row with full details and the seller's profile. Used when \"What to scrape\" is Item details.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sellerUrls": {
            "title": "Member URLs or IDs",
            "type": "array",
            "description": "Vinted member (seller) URLs (https://www.vinted.fr/member/12345678-name) or member IDs. Every listing in their wardrobe is exported with the exact upload time and all photos, plus the seller's profile (rating, reviews, country, followers, last login). Used when \"What to scrape\" is Sellers.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Country sites",
            "type": "array",
            "description": "Vinted country sites to search. Prices come in each site's currency. Sites in the same region share many listings (e.g. France, Germany, Italy, Spain, the Netherlands and Belgium show cross-border listings from each other's sellers); with \"Save each listing once\" on, a listing found on two sites is saved once.",
            "items": {
              "type": "string",
              "enum": [
                "fr",
                "de",
                "uk",
                "it",
                "es",
                "nl",
                "be",
                "pl",
                "us",
                "at",
                "pt",
                "ie",
                "lu",
                "cz",
                "sk",
                "lt",
                "lv",
                "ee",
                "se",
                "dk",
                "fi",
                "hu",
                "ro",
                "hr",
                "si",
                "gr",
                "au"
              ],
              "enumTitles": [
                "France — vinted.fr (EUR)",
                "Germany — vinted.de (EUR)",
                "United Kingdom — vinted.co.uk (GBP)",
                "Italy — vinted.it (EUR)",
                "Spain — vinted.es (EUR)",
                "Netherlands — vinted.nl (EUR)",
                "Belgium — vinted.be (EUR)",
                "Poland — vinted.pl (PLN)",
                "United States — vinted.com (USD)",
                "Austria — vinted.at (EUR)",
                "Portugal — vinted.pt (EUR)",
                "Ireland — vinted.ie (EUR)",
                "Luxembourg — vinted.lu (EUR)",
                "Czechia — vinted.cz (CZK)",
                "Slovakia — vinted.sk (EUR)",
                "Lithuania — vinted.lt (EUR)",
                "Latvia — vinted.lv (EUR)",
                "Estonia — vinted.ee (EUR)",
                "Sweden — vinted.se (SEK)",
                "Denmark — vinted.dk (DKK)",
                "Finland — vinted.fi (EUR)",
                "Hungary — vinted.hu (HUF)",
                "Romania — vinted.ro (RON)",
                "Croatia — vinted.hr (EUR)",
                "Slovenia — vinted.si (EUR)",
                "Greece — vinted.gr (EUR)",
                "Australia — vinted.com.au (AUD)"
              ]
            },
            "default": [
              "fr"
            ]
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Stop after this many unique listings for the whole run (all searches and countries together). 0 = no limit. Vinted shows at most 960 listings per search; above that the search is split automatically (see \"Split large searches\").",
            "default": 1000
          },
          "maxItemsPerQuery": {
            "title": "Max results per search",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Optional cap per search term (or URL) and country site, so that one popular term does not use up the whole run. 0 = no per-search cap (several searches then share \"Max results\" equally first, and any room left over goes to the searches that have more).",
            "default": 0
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "newest_first",
              "relevance",
              "price_low_to_high",
              "price_high_to_low"
            ],
            "type": "string",
            "description": "Order in which Vinted returns listings. Newest first is what resellers and price watchers usually want. When a search is split into parts, each part is read in this order.",
            "default": "newest_first"
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Brand names as Vinted writes them (e.g. \"Nike\", \"Zara\", \"Levi's\", \"Ralph Lauren\") or Vinted brand IDs (53 = Nike). Names are looked up on each country site; several brands = listings of any of them.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "categoryIds": {
            "title": "Category IDs",
            "type": "array",
            "description": "Vinted category IDs — the number in a catalogue URL (vinted.fr/catalog/1242-… → 1242). Examples: 1904 Women, 5 Men, 1193 Kids, 1918 Home, 2994 Electronics, 2309 Entertainment, 4824 Hobbies & collectables, 4332 Sport, 1242 Men's trainers, 10 Women's dresses. A category includes all its sub-categories.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Only listings in these conditions. Empty = any condition.",
            "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"
              ]
            },
            "default": []
          },
          "colors": {
            "title": "Colours",
            "type": "array",
            "description": "Only listings in these colours (the colour the seller chose). Empty = any colour.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "3",
                "12",
                "20",
                "4",
                "21",
                "11",
                "22",
                "7",
                "23",
                "5",
                "24",
                "6",
                "25",
                "26",
                "9",
                "27",
                "17",
                "30",
                "10",
                "28",
                "16",
                "2",
                "29",
                "8",
                "13",
                "14",
                "15",
                "32"
              ],
              "enumTitles": [
                "Black",
                "Grey",
                "White",
                "Cream",
                "Beige",
                "Apricot",
                "Orange",
                "Coral",
                "Red",
                "Burgundy",
                "Pink",
                "Rose",
                "Purple",
                "Lilac",
                "Light blue",
                "Blue",
                "Navy",
                "Turquoise",
                "Mint",
                "Green",
                "Dark green",
                "Khaki",
                "Brown",
                "Mustard",
                "Yellow",
                "Silver",
                "Gold",
                "Multi",
                "Clear"
              ]
            },
            "default": []
          },
          "sizeIds": {
            "title": "Size IDs",
            "type": "array",
            "description": "Vinted size IDs, the size_ids[] values in a filtered Vinted URL (e.g. 206 = XS, 208 = M, 776 = EU 38 shoes). The same label can have different IDs in different size systems, so the easiest way is to filter on Vinted and paste the URL in Vinted URLs mode.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "materialIds": {
            "title": "Material IDs",
            "type": "array",
            "description": "Vinted material IDs (material_ids[] in a Vinted URL), e.g. 44 Cotton, 43 Leather, 146 Linen, 123 Cashmere, 303 Denim, 45 Polyester.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "priceMin": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "In the country site's own currency (EUR, GBP, PLN, SEK …). Applies to the listing price before the buyer-protection fee."
          },
          "priceMax": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "In the country site's own currency. Applies to the listing price before the buyer-protection fee."
          },
          "includeItemDetails": {
            "title": "Include item details (item page)",
            "type": "boolean",
            "description": "Adds what only the item page shows: full description, every photo, colour(s), material, category path, upload age (\"3 hours ago\"), reserved / available flags and the shipping price for buyers on that site. Vinted allows about 25 item pages per minute per connection, so this is slower: with the default proxy setting expect roughly 100-300 detailed listings per minute.",
            "default": false
          },
          "includeSellerProfiles": {
            "title": "Include seller profiles",
            "type": "boolean",
            "description": "Adds the seller's star rating, review count (positive / neutral / negative), country, city, number of listings, followers, last login and holiday mode. One account-API call per seller (cached), about 25 per minute per connection.",
            "default": false
          },
          "splitLargeQueries": {
            "title": "Split large searches (beyond 960)",
            "type": "boolean",
            "description": "Vinted returns at most 960 listings per search. When on, a bigger search is split into sub-categories, price bands, conditions and — only if still needed — colours, and each listing is saved once. Listings found through the category split also get their category path. Off = take only the first 960 of each search.",
            "default": true
          },
          "dedupeAcrossCountries": {
            "title": "Save each listing once across country sites",
            "type": "boolean",
            "description": "Vinted shows many listings on several country sites of the same region. On = a listing is saved once (from the first site that returned it). Off = one row per site, with that site's currency and price — useful for cross-border price comparison.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Searches run over a direct connection. The proxy adds connections for item details and seller profiles (each connection gets about 25 per minute) and is the fallback when Vinted refuses the direct connection. The default Apify Proxy setting is enough; residential proxies are not needed.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}