{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Scraper: Every Listing, Past the 960 Cap",
    "description": "Scrape every Vinted listing past the 960-per-search cap: 11,150 relevant listings on a search the site stops at 960. Keywords or URLs on 7 sites (FR, DE, ES, IT, PL, UK, US), total price with fees, only listings that contain your words, photos, seller, full description, new-listings monitoring.",
    "version": "0.1",
    "x-build-id": "lsRdhDa1CmiY13f06"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~vinted-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-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/alexmorain~vinted-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-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/alexmorain~vinted-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-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": {
          "searchUrls": {
            "title": "Vinted catalog URLs",
            "type": "array",
            "description": "Catalog pages copied from your browser, one per line, such as <code>https://www.vinted.fr/catalog?search_text=nike&amp;catalog[]=5</code> or <code>https://www.vinted.de/catalog/1231-sneakers?search_text=jordan</code>. Any of the 7 sites. Keyword, price range, category, brand, condition and colour filters are read from the URL; size and material filters are not supported and are ignored. Can be combined with the keywords below.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "One search per keyword and country, such as <code>nike</code> or <code>levi's 501</code>. The filters below apply to these searches.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Vinted sites to search with the keywords, the category ids and the filters below. Empty = France. Pasted catalog URLs carry their own site.",
            "items": {
              "type": "string",
              "enum": [
                "fr",
                "de",
                "es",
                "it",
                "pl",
                "co.uk",
                "com"
              ],
              "enumTitles": [
                "France (vinted.fr)",
                "Germany (vinted.de)",
                "Spain (vinted.es)",
                "Italy (vinted.it)",
                "Poland (vinted.pl)",
                "United Kingdom (vinted.co.uk)",
                "United States (vinted.com)"
              ]
            }
          },
          "priceMin": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "number",
            "description": "Only items priced at or above this amount, in the currency of each site (the seller's price, fees not included). Applies to the keyword searches, not to pasted URLs."
          },
          "priceMax": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "number",
            "description": "Only items priced at or below this amount. Applies to the keyword searches, not to pasted URLs."
          },
          "catalogIds": {
            "title": "Category ids",
            "type": "array",
            "description": "Vinted category ids, such as <code>5</code> (men) or <code>1231</code> (men's shoes). The id is in the catalog URL after <code>catalog[]=</code> or <code>/catalog/</code>. Several = any of them. Applies to the keyword searches, not to pasted URLs. With no keyword, a category id alone makes a search.",
            "items": {
              "type": "string"
            }
          },
          "brandIds": {
            "title": "Brand ids",
            "type": "array",
            "description": "Vinted brand ids, such as <code>53</code> (Nike). The id is in the catalog URL after <code>brand_ids[]=</code>. Applies to the keyword searches, not to pasted URLs. With no keyword, a brand id alone makes a search.",
            "items": {
              "type": "string"
            }
          },
          "conditions": {
            "title": "Conditions",
            "type": "array",
            "description": "Only items in these conditions. Empty = all. Applies to the keyword searches, not to pasted URLs.",
            "items": {
              "type": "string",
              "enum": [
                "New with tags",
                "New without tags",
                "Very good",
                "Good",
                "Satisfactory"
              ]
            }
          },
          "maxItems": {
            "title": "Max items per search",
            "minimum": 0,
            "type": "integer",
            "description": "Stops each search after this many items. Each item is one charged result, so this is also your cost cap: with several keywords or countries, the total is this number times the number of searches. <b>0 = no limit</b>. Leave it at 0 for monitoring, a capped run does not record a complete read. At the default 512 MB of memory a single run holds about 100,000 delivered items; above 80,000, raise the memory in the run options.",
            "default": 1000
          },
          "strictMatch": {
            "title": "Only listings that contain every search word",
            "type": "boolean",
            "description": "Vinted's search is fuzzy: when a search is rare or narrowed by a price range, it pads the results with unrelated listings (a search for <code>polly pocket</code> at 300 to 310 EUR returns a games console). With this on, a listing is delivered only if its title or brand contains every word of your keywords (case, accents and simple plurals ignored; a number such as <code>530</code> also matches inside <code>MR530SG</code>). Dropped listings are never charged and are counted as <code>filteredOut</code> in the run report. Parts of a search that are almost all unrelated are not read further. Turn it off to get exactly what Vinted returns. Applies to keyword searches, and to the keyword of a pasted URL.",
            "default": true
          },
          "splitBeyondLimit": {
            "title": "Go beyond 960 items",
            "type": "boolean",
            "description": "Vinted shows 960 items at most per search. When a search reaches it, the actor splits it by category, price, condition and colour until every part is under 960. Turn it off to read the first 960 only (fewer requests).",
            "default": true
          },
          "includeDetails": {
            "title": "Add the item page (details)",
            "type": "boolean",
            "description": "Opens every item to add the full description, brand id, category, colour, material, posting time, the seller's login, review count and reputation, and whether it can be bought. One extra request per item, charged at the higher <i>item with details</i> price. Items whose page is gone are delivered without details and charged the plain price.",
            "default": false
          },
          "newOnly": {
            "title": "New items only (monitoring)",
            "type": "boolean",
            "description": "Remembers which items it already delivered for these exact searches and returns only the new ones on the next run, reading the newest pages until it meets known items. Items already delivered are not charged again. Schedule it hourly or daily.",
            "default": false
          },
          "registryKey": {
            "title": "Monitoring key (optional)",
            "type": "string",
            "description": "Name your monitoring memory to keep several independent watches on the same search, or to change the search without losing history. Empty = one memory per distinct set of searches."
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "Receives a JSON summary (status, articles delivered, searches, failed searches, run id, dataset id) when the run ends. Slack, Discord, Zapier and Make URLs work. Never logged."
          },
          "maxConcurrency": {
            "title": "Parallel connections",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Number of parallel connections, each on its own IP, used with a proxy. Without a proxy the run has one IP and reads one request at a time. Vinted answers about 30 requests a minute per IP, so each connection is paced.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Default: Apify datacenter proxy, a new IP whenever Vinted refuses one (about 5 % of requests get an HTTP 403 and are replayed). It reads about 3,500 items a minute on 16 connections for roughly $0.006 per 1,000 items all included. Residential works too but costs about $0.14 per 1,000 items in proxy traffic. Without any proxy the run has one IP and reads about 30 requests a minute.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}