{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Scraper: Listings, Prices, Sellers",
    "description": "Scrape Vinted listings from all 27 country sites by keyword, filters or link: price, buyer fee, brand, size, condition, favourites and seller. Optional details with description, photos, shipping and sold status, plus seller profiles. No login; JSON, CSV or Excel; pay per listing.",
    "version": "0.1",
    "x-build-id": "2wxbfQtYjBQOJbt1A"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/automation_craft~vinted-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~vinted-scraper/runs": {
      "post": {
        "operationId": "runs-sync-automation_craft-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/automation_craft~vinted-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-automation_craft-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": {
          "searches": {
            "title": "Search words",
            "type": "array",
            "description": "Words to search on Vinted, one search per entry (for example: nike air max, levis 501, playstation 5). Each search is read on every market of Markets. A Vinted link given here is read as a link.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Vinted links",
            "type": "array",
            "description": "Links copied from any Vinted country site: a search or category page with its filters (vinted.fr/catalog?search_text=...), a brand page (vinted.de/brand/53-nike), an item page (vinted.co.uk/items/123...) or a member page (vinted.com/member/123...). Each link is read on its own site, with its own filters and order.",
            "items": {
              "type": "string"
            }
          },
          "itemIds": {
            "title": "Item numbers",
            "type": "array",
            "description": "Vinted item numbers (the digits in an item link /items/<number>-...), read on the first market of Markets.",
            "items": {
              "type": "string"
            }
          },
          "sellerIds": {
            "title": "Seller numbers",
            "type": "array",
            "description": "Vinted member numbers (the digits in a member link /member/<number>-...): the seller's listings, newest first, read on the seller's own country site.",
            "items": {
              "type": "string"
            }
          },
          "markets": {
            "title": "Markets",
            "type": "array",
            "description": "The Vinted country sites every search is read on (default: France). Several markets compare prices across countries: a market comparison row gives each market's median price in its own currency and in euros. Rows carry the market's own currency.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "fr",
                "de",
                "uk",
                "us",
                "au",
                "it",
                "es",
                "nl",
                "be",
                "at",
                "pl",
                "cz",
                "sk",
                "lt",
                "lv",
                "ee",
                "lu",
                "pt",
                "se",
                "fi",
                "dk",
                "gr",
                "hr",
                "hu",
                "ro",
                "si",
                "ie"
              ],
              "enumTitles": [
                "France (vinted.fr, EUR)",
                "Germany (vinted.de, EUR)",
                "United Kingdom (vinted.co.uk, GBP)",
                "United States (vinted.com, USD)",
                "Australia (vinted.com.au, AUD)",
                "Italy (vinted.it, EUR)",
                "Spain (vinted.es, EUR)",
                "Netherlands (vinted.nl, EUR)",
                "Belgium (vinted.be, EUR)",
                "Austria (vinted.at, EUR)",
                "Poland (vinted.pl, PLN)",
                "Czechia (vinted.cz, CZK)",
                "Slovakia (vinted.sk, EUR)",
                "Lithuania (vinted.lt, EUR)",
                "Latvia (vinted.lv, EUR)",
                "Estonia (vinted.ee, EUR)",
                "Luxembourg (vinted.lu, EUR)",
                "Portugal (vinted.pt, EUR)",
                "Sweden (vinted.se, SEK)",
                "Finland (vinted.fi, EUR)",
                "Denmark (vinted.dk, DKK)",
                "Greece (vinted.gr, EUR)",
                "Croatia (vinted.hr, EUR)",
                "Hungary (vinted.hu, HUF)",
                "Romania (vinted.ro, RON)",
                "Slovenia (vinted.si, EUR)",
                "Ireland (vinted.ie, EUR)"
              ]
            }
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Brand names (Nike, Carhartt WIP) or Vinted brand numbers. A name must match exactly one brand in Vinted's brand list; a name with no match or several is left out and named in the coverage row.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Category numbers",
            "type": "array",
            "description": "Vinted category numbers, as in a category link /catalog/<number>-... (for example 1206 for men's outerwear on vinted.fr).",
            "items": {
              "type": "string"
            }
          },
          "conditions": {
            "title": "Conditions",
            "type": "array",
            "description": "Item conditions to keep.",
            "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"
              ]
            }
          },
          "sizes": {
            "title": "Size numbers",
            "type": "array",
            "description": "Vinted size numbers, as in a search link's size_ids[] (sizes differ by category, so they are given as Vinted's numbers).",
            "items": {
              "type": "string"
            }
          },
          "colors": {
            "title": "Colours",
            "type": "array",
            "description": "Colours to keep (Vinted's 29 colours), or Vinted colour numbers.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "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"
              ],
              "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"
              ]
            }
          },
          "materials": {
            "title": "Materials",
            "type": "array",
            "description": "Materials to keep, or Vinted material numbers.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "acrylic",
                "alpaca",
                "bamboo",
                "borosilicate_glass",
                "canvas",
                "cardboard",
                "cashmere",
                "ceramic",
                "chiffon",
                "corduroy",
                "cotton",
                "denim",
                "down",
                "elastane",
                "faux_fur",
                "faux_leather",
                "felt",
                "flannel",
                "fleece",
                "foam",
                "glass",
                "gold",
                "jute",
                "lace",
                "latex",
                "leather",
                "linen",
                "merino",
                "mesh",
                "metal",
                "mohair",
                "neoprene",
                "nylon",
                "paper",
                "patent_leather",
                "plastic",
                "polyester",
                "porcelain",
                "rattan",
                "rubber",
                "satin",
                "sequin",
                "silicone",
                "silk",
                "silver",
                "steel",
                "stone",
                "straw",
                "suede",
                "tulle",
                "tweed",
                "velour",
                "velvet",
                "viscose",
                "wood",
                "wool"
              ],
              "enumTitles": [
                "Acrylic",
                "Alpaca",
                "Bamboo",
                "Borosilicate glass",
                "Canvas",
                "Cardboard",
                "Cashmere",
                "Ceramic",
                "Chiffon",
                "Corduroy",
                "Cotton",
                "Denim",
                "Down",
                "Elastane",
                "Faux fur",
                "Faux leather",
                "Felt",
                "Flannel",
                "Fleece",
                "Foam",
                "Glass",
                "Gold",
                "Jute",
                "Lace",
                "Latex",
                "Leather",
                "Linen",
                "Merino",
                "Mesh",
                "Metal",
                "Mohair",
                "Neoprene",
                "Nylon",
                "Paper",
                "Patent leather",
                "Plastic",
                "Polyester",
                "Porcelain",
                "Rattan",
                "Rubber",
                "Satin",
                "Sequin",
                "Silicone",
                "Silk",
                "Silver",
                "Steel",
                "Stone",
                "Straw",
                "Suede",
                "Tulle",
                "Tweed",
                "Velour",
                "Velvet",
                "Viscose",
                "Wood",
                "Wool"
              ]
            }
          },
          "patterns": {
            "title": "Patterns",
            "type": "array",
            "description": "Patterns to keep (clothing), or Vinted pattern numbers.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "animal_print",
                "camouflage",
                "checks_plaid",
                "chevron",
                "ombre",
                "floral",
                "houndstooth",
                "graphic_logos",
                "paisley",
                "polka_dot",
                "solid",
                "stripes",
                "tie_dye"
              ],
              "enumTitles": [
                "Animal print",
                "Camouflage",
                "Checks plaid",
                "Chevron",
                "Ombre",
                "Floral",
                "Houndstooth",
                "Graphic logos",
                "Paisley",
                "Polka dot",
                "Solid",
                "Stripes",
                "Tie dye"
              ]
            }
          },
          "otherFilters": {
            "title": "Other Vinted filters",
            "type": "array",
            "description": "Vinted's category filters as <code>=<number>: video_game_platform=<number> (video games) or language_book=<number> (books), as in a search link's video_game_platform_ids[].",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Lowest price",
            "minimum": 0,
            "type": "number",
            "description": "Lowest price in the market's own currency (euros on vinted.fr, pounds on vinted.co.uk). Every row's price is also checked in code."
          },
          "maxPrice": {
            "title": "Highest price",
            "minimum": 0,
            "type": "number",
            "description": "Highest price in the market's own currency."
          },
          "sort": {
            "title": "Order",
            "enum": [
              "newest_first",
              "relevance",
              "price_low_to_high",
              "price_high_to_low"
            ],
            "type": "string",
            "description": "Order of the listings (left out: newest first for searches, the link's own order for links). Past Vinted's 960 rows of one search, the walk goes on in price order."
          },
          "startPage": {
            "title": "Start page",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Vinted's own page of 96 listings a search starts at (1 to 10). Left out: 1."
          },
          "maxItemsPerSearch": {
            "title": "Listings per search",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Most listings delivered per search, link or seller (default 100). Above 960 a search is read on past Vinted's own limit in price bands."
          },
          "maxItems": {
            "title": "Listings in all",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Most listings delivered by the whole run (left out: no run cap)."
          },
          "includeDetails": {
            "title": "Listing details (add-on)",
            "type": "boolean",
            "description": "Reads each listing's own page: description, every photo, colours, material, category path, item attributes (model, storage, ISBN ...), listed time, sold, reserved and hidden status, shipping price. Charged as one Listing details event per listing whose page was read."
          },
          "includeSellers": {
            "title": "Seller profiles (add-on)",
            "type": "boolean",
            "description": "Adds each seller's public profile to its listings: country, feedback score and counts, items sold and bought, active listings, followers, verifications, holiday mode, bundle discounts, and a Vinted Pro seller's business record. Read once per seller per run (at most about 20 sellers a minute) and charged as one Seller event."
          },
          "includeSoldItems": {
            "title": "Include sold items of sellers",
            "type": "boolean",
            "description": "For seller links and numbers: also deliver the seller's sold items, read from the feedback Vinted shows for the seller (each charged as a listing). Purchases and deleted items are skipped free."
          },
          "includePriceSummary": {
            "title": "Price summary rows (free)",
            "type": "boolean",
            "description": "Adds one free price summary row per search (count, lowest, quartiles, median, highest, mean, median per condition) and, when a search runs on several markets, one free market comparison row. Default on.",
            "default": true
          },
          "includeFilterOptions": {
            "title": "Filter values (free)",
            "type": "boolean",
            "description": "Adds one free row per search with every filter value Vinted lists for it (brands, sizes, colours, materials, conditions, categories with counts), to find the numbers for the filters above."
          },
          "includePersonalData": {
            "title": "Include personal data",
            "type": "boolean",
            "description": "Off by default. On, rows also carry a private seller's member number, login, profile link and photo, and seller profiles their city (when the seller shows it) and last login time. Vinted Pro sellers' fields are business data and always delivered. You are responsible for a lawful use of personal data, the GDPR included."
          },
          "maxConcurrency": {
            "title": "Parallel reads",
            "minimum": 1,
            "maximum": 4,
            "type": "integer",
            "description": "Listing pages and seller profiles read at once (1 to 4, default 2)."
          },
          "maxRequestRetries": {
            "title": "Retries per request",
            "minimum": 1,
            "maximum": 6,
            "type": "integer",
            "description": "Attempts per request (1 to 6, default 3)."
          },
          "requestTimeoutSecs": {
            "title": "Request timeout (seconds)",
            "minimum": 10,
            "maximum": 90,
            "type": "integer",
            "description": "Seconds one request may take (10 to 90, default 30)."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify datacenter proxy by default. Residential exits in each market's country, or your own proxy links, can be chosen here."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}