{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Scraper: Listings, Prices & Sellers from 26 Countries",
    "description": "Scrape Vinted listings by search text or catalog link on 26 Vinted country sites: title, brand, size, condition, price, total with buyer protection, favourites, photo, link and seller username, with optional seller rating. Newest first. No login. Pay per listing.",
    "version": "0.1",
    "x-build-id": "JIgw2OfccU1L9axkc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~vinted-listings-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-vinted-listings-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/themineworks~vinted-listings-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-vinted-listings-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/themineworks~vinted-listings-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-vinted-listings-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 for",
            "type": "array",
            "description": "Search text, one search per line, exactly as you would type it in Vinted's search bar (for example \"nike air force 1\" or \"levis 501\"). Each search runs on every country chosen below. Leave empty if you only give catalog links.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Vinted catalog links",
            "type": "array",
            "description": "Optional. Links to Vinted search or catalog pages from any country site, copied from your browser after setting filters there, for example https://www.vinted.fr/catalog?search_text=nike&brand_ids[]=53&status_ids[]=6&order=newest_first, https://www.vinted.de/catalog/1231-womens-shoes or https://www.vinted.co.uk/brand/53-nike. Each link keeps its own filters and country. Seller (member) pages and single item pages are not read.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Vinted country sites to run the searches on. Prices come in each site's currency. Catalog links always use their own site.",
            "items": {
              "type": "string",
              "enum": [
                "fr",
                "de",
                "uk",
                "it",
                "es",
                "nl",
                "be",
                "pl",
                "lt",
                "cz",
                "at",
                "lu",
                "pt",
                "se",
                "dk",
                "fi",
                "sk",
                "hu",
                "ro",
                "gr",
                "hr",
                "ie",
                "si",
                "ee",
                "lv",
                "us"
              ],
              "enumTitles": [
                "France (vinted.fr)",
                "Germany (vinted.de)",
                "United Kingdom (vinted.co.uk)",
                "Italy (vinted.it)",
                "Spain (vinted.es)",
                "Netherlands (vinted.nl)",
                "Belgium (vinted.be)",
                "Poland (vinted.pl)",
                "Lithuania (vinted.lt)",
                "Czechia (vinted.cz)",
                "Austria (vinted.at)",
                "Luxembourg (vinted.lu)",
                "Portugal (vinted.pt)",
                "Sweden (vinted.se)",
                "Denmark (vinted.dk)",
                "Finland (vinted.fi)",
                "Slovakia (vinted.sk)",
                "Hungary (vinted.hu)",
                "Romania (vinted.ro)",
                "Greece (vinted.gr)",
                "Croatia (vinted.hr)",
                "Ireland (vinted.ie)",
                "Slovenia (vinted.si)",
                "Estonia (vinted.ee)",
                "Latvia (vinted.lv)",
                "United States (vinted.com)"
              ]
            },
            "default": [
              "fr"
            ]
          },
          "maxItemsPerSearch": {
            "title": "Listings per search",
            "minimum": 1,
            "maximum": 960,
            "type": "integer",
            "description": "Most listings to return for each search on each country (and for each link). Vinted shows at most 960 listings for one search (10 pages of 96); split a bigger search by price range or category to get more.",
            "default": 100
          },
          "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 returns the most recently listed items first.",
            "default": "newest_first"
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Optional. Brand names as Vinted spells them (Nike, Levi's, Ralph Lauren) or Vinted brand ids (53). Several brands return listings of any of them. A name with no exact match on Vinted is reported in the run summary with Vinted's suggestions.",
            "items": {
              "type": "string"
            }
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Optional. Only listings in these conditions.",
            "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"
              ]
            }
          },
          "priceMin": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Optional. In the currency of each country site (EUR on most, GBP on vinted.co.uk, PLN, CZK, SEK, DKK, HUF, RON, USD elsewhere)."
          },
          "priceMax": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Optional. In the currency of each country site."
          },
          "sizeIds": {
            "title": "Size ids",
            "type": "array",
            "description": "Optional, advanced. Vinted size ids, which depend on the category. The easiest way is to set the size on Vinted and paste the link into Vinted catalog links; the id is the number after size_ids[]= in that link.",
            "items": {
              "type": "string"
            }
          },
          "includeSellerRating": {
            "title": "Add seller rating",
            "type": "boolean",
            "description": "Adds the seller's public star rating (0 to 5) and number of reviews to each listing. Needs one extra lookup per seller, and Vinted allows about 40 a minute, so a run with this on takes about one extra minute per 70 sellers. Same price per listing.",
            "default": false
          },
          "onlyNewItems": {
            "title": "Only listings not returned before",
            "type": "boolean",
            "description": "For scheduled runs. Returns only listings this same input has not returned in an earlier run, and stops reading a search at the first page with nothing new. The first run returns everything. The memory is kept in a key-value store in your account named after this input.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}