{
  "description": "Search Vinted second-hand fashion across 27 country domains, pull item details, seller closets, profiles, shop data, feedback, brands and categories.",
  "properties": {
    "brandId": {
      "description": "Numeric brand ID or brand URL. Discover IDs with Search brand registry.",
      "editor": "textfield",
      "sectionCaption": "Per-Mode Targets",
      "title": "Brand ID or URL (mode=byBrand)",
      "type": "string"
    },
    "brandIds": {
      "default": [],
      "description": "Numeric brand IDs, e.g. [53] for Nike.",
      "editor": "stringList",
      "prefill": [],
      "sectionCaption": "Search Filters",
      "title": "Brand IDs filter (mode=search)",
      "type": "array"
    },
    "brandKeyword": {
      "description": "Keyword to search the Vinted brand registry.",
      "editor": "textfield",
      "sectionCaption": "Per-Mode Targets",
      "title": "Brand keyword (mode=byBrandSearch)",
      "type": "string"
    },
    "catalogId": {
      "description": "Numeric category ID or /catalog/<id>-slug URL.",
      "editor": "textfield",
      "sectionCaption": "Per-Mode Targets",
      "title": "Catalog ID or URL (mode=byCatalog)",
      "type": "string"
    },
    "catalogIds": {
      "default": [],
      "description": "Numeric category IDs, e.g. [1904] for Women.",
      "editor": "stringList",
      "prefill": [],
      "sectionCaption": "Search Filters",
      "title": "Catalog IDs filter (mode=search)",
      "type": "array"
    },
    "color": {
      "default": "any",
      "description": "Single colour filter. Choose any to leave it unfiltered.",
      "editor": "select",
      "enum": [
        "any",
        "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": [
        "Any color",
        "Black",
        "Gray",
        "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"
      ],
      "prefill": "any",
      "sectionCaption": "Search Filters",
      "title": "Color filter (mode=search)",
      "type": "string"
    },
    "condition": {
      "default": "any",
      "description": "Vinted condition. Choose any to leave it unfiltered.",
      "editor": "select",
      "enum": [
        "any",
        "new_with_tags",
        "new_without_tags",
        "very_good",
        "good",
        "satisfactory"
      ],
      "enumTitles": [
        "Any condition",
        "New with tags",
        "New without tags",
        "Very good",
        "Good",
        "Satisfactory"
      ],
      "prefill": "any",
      "sectionCaption": "Search Filters",
      "title": "Condition filter (mode=search)",
      "type": "string"
    },
    "containsKeyword": {
      "description": "Drop items whose title or description does not contain this keyword (case-insensitive). Without item details only the title is searched.",
      "editor": "textfield",
      "sectionCaption": "Enrichment & Limits",
      "title": "Title or description contains keyword",
      "type": "string"
    },
    "country": {
      "default": "com",
      "description": "Vinted market to query. The market controls currency, language and local inventory.",
      "editor": "select",
      "enum": [
        "com",
        "co.uk",
        "fr",
        "de",
        "it",
        "es",
        "pl",
        "cz",
        "nl",
        "lt",
        "lu",
        "at",
        "be",
        "pt",
        "ro",
        "sk",
        "fi",
        "se",
        "gr",
        "dk",
        "ee",
        "hr",
        "hu",
        "ie",
        "lv",
        "si",
        "com.au"
      ],
      "enumTitles": [
        "United States (vinted.com, USD)",
        "United Kingdom (vinted.co.uk, GBP)",
        "France (vinted.fr, EUR)",
        "Germany (vinted.de, EUR)",
        "Italy (vinted.it, EUR)",
        "Spain (vinted.es, EUR)",
        "Poland (vinted.pl, PLN)",
        "Czechia (vinted.cz, CZK)",
        "Netherlands (vinted.nl, EUR)",
        "Lithuania (vinted.lt, EUR)",
        "Luxembourg (vinted.lu, EUR)",
        "Austria (vinted.at, EUR)",
        "Belgium (vinted.be, EUR)",
        "Portugal (vinted.pt, EUR)",
        "Romania (vinted.ro, RON)",
        "Slovakia (vinted.sk, EUR)",
        "Finland (vinted.fi, EUR)",
        "Sweden (vinted.se, SEK)",
        "Greece (vinted.gr, EUR)",
        "Denmark (vinted.dk, DKK)",
        "Estonia (vinted.ee, EUR)",
        "Croatia (vinted.hr, EUR)",
        "Hungary (vinted.hu, HUF)",
        "Ireland (vinted.ie, EUR)",
        "Latvia (vinted.lv, EUR)",
        "Slovenia (vinted.si, EUR)",
        "Australia (vinted.com.au, AUD)"
      ],
      "prefill": "com",
      "sectionCaption": "Mode & Market",
      "title": "Country / market",
      "type": "string"
    },
    "deepSearch": {
      "default": false,
      "description": "Vinted returns at most 960 results per query. Deep search splits the query into price bands so it can collect more (more requests, slower).",
      "editor": "checkbox",
      "prefill": false,
      "sectionCaption": "Enrichment & Limits",
      "title": "Deep search past 960 results",
      "type": "boolean"
    },
    "feedbackType": {
      "default": "all",
      "description": "All reviews, member-written reviews, or Vinted's automatic sale-completion entries.",
      "editor": "select",
      "enum": [
        "all",
        "member",
        "automatic"
      ],
      "enumTitles": [
        "All feedback",
        "Member reviews",
        "Automatic system feedback"
      ],
      "prefill": "all",
      "sectionCaption": "Enrichment & Limits",
      "title": "Feedback type (mode=byUserFeedbacks)",
      "type": "string"
    },
    "includeItemDetails": {
      "default": false,
      "description": "Open each item page for description, colour, material, category, condition ID, upload age, all photos and seller rating. One extra request per item.",
      "editor": "checkbox",
      "prefill": false,
      "sectionCaption": "Enrichment & Limits",
      "title": "Include item details",
      "type": "boolean"
    },
    "includeSellerStats": {
      "default": false,
      "description": "Add seller rating, feedback count, item/sold counts, followers and shop identity (one profile request per distinct seller).",
      "editor": "checkbox",
      "prefill": false,
      "sectionCaption": "Enrichment & Limits",
      "title": "Include seller stats / shop",
      "type": "boolean"
    },
    "materialIds": {
      "default": [],
      "description": "Numeric material IDs from Vinted's Material facet (e.g. 44 = Cotton).",
      "editor": "stringList",
      "prefill": [],
      "sectionCaption": "Search Filters",
      "title": "Material IDs filter (mode=search)",
      "type": "array"
    },
    "maxItems": {
      "default": 50,
      "description": "Hard cap on emitted records. Values above 960 need deep search.",
      "editor": "number",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 1,
      "sectionCaption": "Enrichment & Limits",
      "title": "Max items",
      "type": "integer"
    },
    "minRating": {
      "description": "Drop items whose seller rating is below this value (0–5). Items without a rating pass through. Automatically enables seller stats.",
      "editor": "number",
      "maximum": 5,
      "minimum": 0,
      "sectionCaption": "Enrichment & Limits",
      "title": "Minimum seller rating",
      "type": "number"
    },
    "mode": {
      "default": "search",
      "description": "search: keyword/filters → items. byUrl: explicit Vinted item, member, brand, catalog or search URLs. byUser: profile + closet. byBrand / byCatalog: listings for a brand or category. byBrandSearch: brand registry. byUserFeedbacks: seller reviews.",
      "editor": "select",
      "enum": [
        "search",
        "byUrl",
        "byUser",
        "byBrand",
        "byCatalog",
        "byBrandSearch",
        "byUserFeedbacks"
      ],
      "enumTitles": [
        "Search items (keyword + filters)",
        "By URL (item / member / brand / catalog / search)",
        "By user (profile + closet)",
        "By brand (items)",
        "By catalog (category items)",
        "Search brand registry",
        "By user feedbacks (seller reviews)"
      ],
      "prefill": "search",
      "sectionCaption": "Mode & Market",
      "title": "Scrape mode",
      "type": "string"
    },
    "order": {
      "default": "relevance",
      "description": "Result ordering for item searches.",
      "editor": "select",
      "enum": [
        "relevance",
        "newest_first",
        "price_low_to_high",
        "price_high_to_low"
      ],
      "enumTitles": [
        "Relevance",
        "Newest first",
        "Price: low to high",
        "Price: high to low"
      ],
      "prefill": "relevance",
      "sectionCaption": "Search Inputs",
      "title": "Sort order (mode=search / byBrand / byCatalog)",
      "type": "string"
    },
    "priceFrom": {
      "description": "Minimum price in the market's local currency.",
      "editor": "number",
      "maximum": 1000000,
      "minimum": 0,
      "sectionCaption": "Search Filters",
      "title": "Min price (mode=search)",
      "type": "integer"
    },
    "priceTo": {
      "description": "Maximum price in the market's local currency.",
      "editor": "number",
      "maximum": 1000000,
      "minimum": 0,
      "sectionCaption": "Search Filters",
      "title": "Max price (mode=search)",
      "type": "integer"
    },
    "searchText": {
      "default": "",
      "description": "Free-text keyword. Leave empty with a brand/category filter to browse. A bare run defaults to adidas.",
      "editor": "textfield",
      "prefill": "adidas",
      "sectionCaption": "Search Inputs",
      "title": "Search query (mode=search)",
      "type": "string"
    },
    "sizeIds": {
      "default": [],
      "description": "Numeric Vinted size IDs. Use the size facet shown on a Vinted search URL.",
      "editor": "stringList",
      "prefill": [],
      "sectionCaption": "Search Filters",
      "title": "Size IDs filter (mode=search)",
      "type": "array"
    },
    "urls": {
      "default": [],
      "description": "Item, member, brand, catalog or filtered search URLs. Mixed country domains are supported.",
      "editor": "stringList",
      "prefill": [],
      "sectionCaption": "Per-Mode Targets",
      "title": "Vinted URLs (mode=byUrl)",
      "type": "array"
    },
    "userId": {
      "description": "Numeric Vinted user ID, username, or member URL.",
      "editor": "textfield",
      "sectionCaption": "Per-Mode Targets",
      "title": "User ID, username or URL (mode=byUser / byUserFeedbacks)",
      "type": "string"
    }
  },
  "required": [
    "mode",
    "country"
  ],
  "schemaVersion": 1,
  "title": "Vinted Scraper Input",
  "type": "object"
}