{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Scraper - Listings, Prices, Sellers & Reviews",
    "description": "Scrape Vinted across 27 country marketplaces by keyword, filters, item or seller URL. Extract prices, currencies, brands, sizes, conditions, views, favourites, seller ratings and profiles. Supports brand, price and condition filters, plus full seller feedback history.",
    "version": "0.1",
    "x-build-id": "io6JOQdsLJIcBaALK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~vinted-marketplace-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-vinted-marketplace-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/abotapi~vinted-marketplace-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-vinted-marketplace-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/abotapi~vinted-marketplace-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-vinted-marketplace-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "url",
              "reviews"
            ],
            "type": "string",
            "description": "'search' finds listings by keyword with the marketplace's own filters. 'url' scrapes any item page or seller/member page you paste. 'reviews' pulls a seller's full feedback history (rating + every comment).",
            "default": "search"
          },
          "country": {
            "title": "Country marketplace",
            "enum": [
              "de",
              "fr",
              "nl",
              "pl",
              "es",
              "it",
              "pt",
              "gb",
              "ie",
              "be",
              "at",
              "cz",
              "sk",
              "hu",
              "ro",
              "hr",
              "si",
              "gr",
              "se",
              "dk",
              "fi",
              "lt",
              "lv",
              "ee",
              "lu",
              "us",
              "au"
            ],
            "type": "string",
            "description": "Which country's catalogue to search, and which market session to use when a pasted URL does not name one. Each country has its own catalogue, language and currency; item and seller ids work across all of them. Pasted URLs always pin their own market from the URL itself.",
            "default": "de"
          },
          "queries": {
            "title": "Search keywords",
            "type": "array",
            "description": "One or more free-text keywords, e.g. 'nike air force' or 'robe vintage'. The item budget (Max items below) is split evenly across keywords.",
            "items": {
              "type": "string"
            }
          },
          "categoryId": {
            "title": "Category ID (optional)",
            "type": "string",
            "description": "A category id (e.g. '1242') or a category NAME as shown on the site (e.g. 'Sneaker'); a name is looked up in the site's own category list and the run stops with a clear error when nothing matches. Narrows a keyword search, or browses the whole category when Search keywords is left empty. Search mode only."
          },
          "brandId": {
            "title": "Brand ID (optional)",
            "type": "string",
            "description": "A brand id (e.g. '53') or a brand NAME (e.g. 'Nike'); a name is looked up with the site's own brand search and the run stops with a clear error when nothing matches. Search mode only."
          },
          "conditions": {
            "title": "Condition (optional)",
            "type": "array",
            "description": "Only return items in these conditions. Leave empty for any condition. Search mode only.",
            "items": {
              "type": "string",
              "enum": [
                "6",
                "1",
                "2",
                "3",
                "4"
              ],
              "enumTitles": [
                "New with tags",
                "New without tags",
                "Very good",
                "Good",
                "Satisfactory"
              ]
            }
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Only return items priced at or above this amount, in the selected market's currency. Search mode only."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Only return items priced at or below this amount, in the selected market's currency. Search mode only."
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "relevance",
              "newest_first",
              "price_low_to_high",
              "price_high_to_low"
            ],
            "type": "string",
            "description": "Order of the returned results: the marketplace's default relevance ranking, newest first, price low to high or price high to low. Search mode only.",
            "default": "relevance"
          },
          "urls": {
            "title": "URLs to scrape",
            "uniqueItems": true,
            "type": "array",
            "description": "Paste item pages (/items/<id> or /items/<id>-<slug>), seller/member pages (/member/<id>, optional slug or ?page=), catalogue/search pages (/catalog?search_text=..., with filters, order and page), category pages (/catalog/<id>-<name>, the category id is read from the path) or brand pages (/brand/<id>-<name>). A member URL enumerates every item that seller has listed; a catalogue, category or brand URL walks that listing from the page parameter it carries. Each URL's own hostname picks its market (vinted.de, .co.uk, .com and the others), with or without www. Unsupported links (the m. mobile host, /member/<id>/items, /member/<id>/feedback) are skipped with a warning. Left untouched, this field works through one example of each supported URL form; the three item-page forms point to the same listing, which is returned once. Filter fields above are ignored in this mode.",
            "default": [
              "https://www.vinted.de/catalog?search_text=nike",
              "https://www.vinted.de/catalog?search_text=nike&page=2",
              "https://www.vinted.de/catalog?search_text=nike&order=newest_first",
              "https://www.vinted.de/catalog?search_text=nike&catalog[]=1242&brand_ids[]=53&price_to=50&status_ids[]=6",
              "https://www.vinted.de/catalog?brand_ids[]=53",
              "https://www.vinted.de/catalog/1242-sneakers",
              "https://www.vinted.de/catalog/1242-sneakers?page=2&order=newest_first",
              "https://www.vinted.de/catalog/1242-sneakers?brand_ids[]=53",
              "https://www.vinted.de/brand/53-nike",
              "https://www.vinted.de/items/10566802080-nike-sneaker",
              "https://www.vinted.de/items/10566802080",
              "https://www.vinted.co.uk/items/10566802080-nike-sneaker",
              "https://www.vinted.de/member/3162455054",
              "https://www.vinted.de/member/3162455054-vrna21",
              "https://www.vinted.de/member/3162455054?page=2",
              "https://www.vinted.co.uk/catalog?search_text=nike",
              "https://www.vinted.com/catalog?search_text=nike",
              "https://vinted.de/catalog?search_text=nike"
            ],
            "items": {
              "type": "string"
            }
          },
          "sellers": {
            "title": "Sellers",
            "type": "array",
            "description": "Seller numeric member ids or full /member/<id> URLs (any country) to fetch feedback for. A pasted URL's own hostname picks the market; a bare numeric id uses the Country marketplace above.",
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Fetch item detail",
            "type": "boolean",
            "description": "Adds the full description, colour, upload date and schema condition to each listing. Identity, price, brand, size, condition label, view/favourite counts and photos are already included without this toggle. Billed as the per-listing detail-enrichment surcharge when a row is returned.",
            "default": false
          },
          "fetchSellerProfiles": {
            "title": "Fetch seller profiles",
            "type": "boolean",
            "description": "Adds seller depth to each listing: city, country, feedback reputation with positive/neutral/negative counts, item and follower counts, bundle discount, response time and online status. Also billed as the detail-enrichment surcharge (once per listing, together with Fetch item detail).",
            "default": false
          },
          "maxReviews": {
            "title": "Max reviews per seller",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Reviews mode only: the most feedback entries fetched for each seller. Max items below still caps the whole run.",
            "default": 20
          },
          "maxPages": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many result pages per keyword/category/URL entry. Leave empty for as many pages as needed (bounded by Max items below)."
          },
          "maxItems": {
            "title": "Max items total",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on total records (listings or reviews) returned across the whole run. 0 = unlimited: the run keeps going until the source runs out of results.",
            "default": 20
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Runs use the platform's residential proxy pool by default, pinned to the market's country. The standard datacenter pool also served the marketplace in our checks, so you can select it here for a cheaper run, but residential remains the default because it is the more reliable choice. If the selected pool is unavailable on your plan, the run continues on a backup connection. You can also paste your own proxy URLs, which are used as given.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          },
          "resumeFromRunId": {
            "title": "Resume from a previous run",
            "type": "string",
            "description": "Paste a previous run ID or dataset ID to continue an interrupted crawl without returning or charging for records already collected there. For recurring daily monitoring of the same search/URLs/sellers, use Incremental mode below instead."
          },
          "incrementalMode": {
            "title": "Incremental changes for scheduled runs",
            "type": "boolean",
            "description": "Turn this on for daily or recurring monitoring. The first run returns everything as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED records; a sold/removed listing on this marketplace comes back as EXPIRED. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those records returned (and billed). State is kept separately per mode, country and search/URL/seller/detail setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.",
            "default": false
          },
          "stateKey": {
            "title": "State key (optional, incremental mode only)",
            "type": "string",
            "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the mode, country, search/URL/seller and detail settings - different setups then never mix state with each other."
          },
          "emitUnchanged": {
            "title": "Emit unchanged records (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns - and bills - extra rows you already have, so leave it off unless you specifically want the full snapshot every run.",
            "default": false
          },
          "emitExpired": {
            "title": "Emit expired records (incremental mode only)",
            "type": "boolean",
            "description": "Off by default. Turn on to also return records that were present in a previous run but are no longer found (sold or removed), marked EXPIRED. Only produced once a run has fully scanned the tracked scope - not when Max items capped it, when Resume was used, or when a run scanned nothing. This returns - and bills - extra synthetic rows, so leave it off unless you need expiry tracking.",
            "default": false
          },
          "ignoreFieldsForChanges": {
            "title": "Ignore fields when detecting changes (incremental mode only)",
            "type": "array",
            "description": "Optional. Field names to exclude from UPDATED change detection, in addition to the built-in handling (view and favourite counters, the relative upload label, signed photo and avatar links, and live seller counters such as last seen online, followers and item count already never trigger a false UPDATED). Use this if another field in your setup turns out to be noisy. A dotted name such as seller.city or photos.width ignores that key inside the nested object or inside every photo. The ignored fields still appear in the output; they are only left out of the comparison.",
            "items": {
              "type": "string"
            }
          },
          "mcpConnectors": {
            "title": "Pipe results into your apps (optional)",
            "type": "array",
            "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify -> Settings -> Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)."
          },
          "notionParentPageUrl": {
            "title": "Notion parent page (Notion connector only)",
            "type": "string",
            "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors."
          },
          "maxNotifyListings": {
            "title": "Max items to export per connector",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on items written to each connector per run. Does not affect the dataset.",
            "default": 50
          },
          "query": {
            "title": "Search keyword (alias)",
            "type": "string",
            "description": "Alias of Search keywords for a single keyword. Used only when Search keywords is empty."
          },
          "priceMin": {
            "title": "Minimum price (alias)",
            "minimum": 0,
            "type": "number",
            "description": "Alias of Minimum price. Used only when Minimum price is empty."
          },
          "priceMax": {
            "title": "Maximum price (alias)",
            "minimum": 0,
            "type": "number",
            "description": "Alias of Maximum price. Used only when Maximum price is empty."
          },
          "catalogId": {
            "title": "Category ID (alias)",
            "type": "integer",
            "description": "Numeric alias of Category ID. Used only when Category ID is empty."
          },
          "condition": {
            "title": "Condition (alias)",
            "type": "array",
            "description": "Alias of Condition (status ids 6, 1, 2, 3, 4). Used only when Condition is empty.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs (alias)",
            "type": "array",
            "description": "Alias of URLs to scrape, accepting request-list objects. Used when URLs to scrape is empty or still holds its prefilled example list; any other URLs to scrape value wins."
          },
          "includeItemDetails": {
            "title": "Include item details (alias)",
            "type": "boolean",
            "description": "Alias of the item-detail toggle. Set to true it turns on Fetch item detail, which is billed as the detail-enrichment surcharge per returned listing. If Fetch item detail is already on, it stays on."
          },
          "includeSellerDetails": {
            "title": "Include seller details (alias)",
            "type": "boolean",
            "description": "Alias of the seller-profile toggle. Set to true it turns on Fetch seller profiles, which is billed as the detail-enrichment surcharge per returned listing. If Fetch seller profiles is already on, it stays on."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}