{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Smart Scraper: Listings, Sellers & Prices",
    "description": "Scrape Vinted listings by keyword in 26 countries, compare prices between euro-zone markets, watch sellers and track item prices. Export to JSON, CSV or Excel, or use the API, schedules and webhooks.",
    "version": "1.6",
    "x-build-id": "dtk3svkjJ2f0KywVR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/kazkn~vinted-smart-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-kazkn-vinted-smart-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/kazkn~vinted-smart-scraper/runs": {
      "post": {
        "operationId": "runs-sync-kazkn-vinted-smart-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/kazkn~vinted-smart-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-kazkn-vinted-smart-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": {
          "workflowPreset": {
            "title": "🎯 Choose Your Workflow",
            "enum": [
              "QUICK_SEARCH",
              "ARBITRAGE_SCANNER",
              "DEAL_ALERTS",
              "SELLER_WATCHLIST"
            ],
            "type": "string",
            "description": "Quick search returns listings only (start fee + one fee per result row). Arbitrage Scanner compares average prices in 2-5 euro markets. Deal Alerts adds a monitor check for scheduled alerts. Seller Watchlist adds a seller-details fee. API calls without workflowPreset or mode still run Arbitrage Scanner.",
            "default": "ARBITRAGE_SCANNER"
          },
          "query": {
            "title": "🔍 Search Query",
            "type": "string",
            "description": "Enter the product, brand, model, or niche to search. Used by Quick search, Arbitrage Scanner, Deal Alerts and Trending."
          },
          "countries": {
            "title": "🌍 Countries",
            "maxItems": 5,
            "type": "array",
            "description": "Select Vinted markets to search or compare. Arbitrage Scanner needs 2-5 countries. Prices are compared in local currency without conversion: compare euro markets only (UK, PL, CZ, HU, RO, DK, SE and US use other currencies).",
            "items": {
              "type": "string",
              "enum": [
                "fr",
                "de",
                "uk",
                "it",
                "es",
                "nl",
                "pl",
                "pt",
                "be",
                "at",
                "lt",
                "cz",
                "sk",
                "hu",
                "ro",
                "hr",
                "fi",
                "dk",
                "se",
                "ee",
                "gr",
                "ie",
                "lu",
                "lv",
                "si",
                "us"
              ],
              "enumTitles": [
                "🇫🇷 France",
                "🇩🇪 Germany",
                "🇬🇧 United Kingdom",
                "🇮🇹 Italy",
                "🇪🇸 Spain",
                "🇳🇱 Netherlands",
                "🇵🇱 Poland",
                "🇵🇹 Portugal",
                "🇧🇪 Belgium",
                "🇦🇹 Austria",
                "🇱🇹 Lithuania",
                "🇨🇿 Czech Republic",
                "🇸🇰 Slovakia",
                "🇭🇺 Hungary",
                "🇷🇴 Romania",
                "🇭🇷 Croatia",
                "🇫🇮 Finland",
                "🇩🇰 Denmark",
                "🇸🇪 Sweden",
                "🇪🇪 Estonia",
                "🇬🇷 Greece",
                "🇮🇪 Ireland",
                "🇱🇺 Luxembourg",
                "🇱🇻 Latvia",
                "🇸🇮 Slovenia",
                "🇺🇸 United States"
              ]
            },
            "default": [
              "fr",
              "de",
              "nl",
              "it",
              "es"
            ]
          },
          "maxItems": {
            "title": "📊 Max Results / Daily Budget Cap",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "Set how many items to return and cap billable dataset rows. Free Apify accounts are best for proof runs and are capped to 30 results for broad search/arbitrage/monitor workflows; use a paid Apify plan for scheduled 100/300-result monitors. Hard cap: 300 per run.",
            "default": 100
          },
          "mode": {
            "title": "🧩 Advanced Mode Override",
            "enum": [
              "",
              "CROSS_COUNTRY",
              "SEARCH",
              "SELLER_PROFILE",
              "PRICE_TRACK",
              "SELL_THROUGH_TRACKER",
              "ITEM_DETAIL",
              "TRENDING"
            ],
            "type": "string",
            "description": "Optional advanced override. Leave this empty to use the workflow chosen above. Existing API users can still send mode directly. SOLD_ITEMS (Sold Signals) was removed in November 2026: Vinted no longer shows sold listings publicly.",
            "default": ""
          },
          "itemUrls": {
            "title": "📦 Item URLs",
            "type": "array",
            "description": "Paste one or more Vinted item URLs. Required for Item Detail and Price Track modes. In Sell-Through Tracker, URL watchlists are capped by maxItems for billing control. Accepts any Vinted domain. If you leave mode on Search and only provide item URLs, the actor will auto-switch to Item Detail:",
            "items": {
              "type": "string"
            }
          },
          "sellerUrls": {
            "title": "👤 Seller URLs",
            "type": "array",
            "description": "Paste one or more Vinted seller profile URLs. Required for Seller Profile mode. Works with any Vinted domain (vinted.fr, vinted.de, vinted.co.uk, etc.). If you leave mode on Search and only provide seller URLs, the actor will auto-switch to Seller Profile mode.",
            "items": {
              "type": "string"
            }
          },
          "condition": {
            "title": "✨ Condition",
            "type": "array",
            "description": "Filter results by item condition. Leave empty to include all 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": "💶 Min Price",
            "type": "number",
            "description": "Set a minimum price in local currency (€ for most countries, £ for UK). Leave empty for no minimum."
          },
          "priceMax": {
            "title": "💶 Max Price",
            "type": "number",
            "description": "Set a maximum price in local currency. Leave empty for no maximum."
          },
          "sortBy": {
            "title": "📈 Sort By",
            "enum": [
              "relevance",
              "price_low_to_high",
              "price_high_to_low",
              "newest_first"
            ],
            "type": "string",
            "description": "Choose how to sort your results.",
            "default": "relevance"
          },
          "categoryId": {
            "title": "📁 Category ID",
            "type": "integer",
            "description": "Enter a Vinted category number to filter by type. Find it in the URL when browsing a category on vinted.fr (e.g. catalog[]=5 → enter 5). Leave empty for all categories."
          },
          "brandIds": {
            "title": "🏷️ Brand IDs",
            "type": "array",
            "description": "Enter brand numbers to filter by brand. Find them in the Vinted URL after selecting a brand filter (e.g. brand_ids[]=53 → 53 = Nike). Leave empty for all brands.",
            "items": {
              "type": "integer"
            }
          },
          "sizeIds": {
            "title": "📏 Size IDs",
            "type": "array",
            "description": "Enter size numbers to filter by size. Find them in the Vinted URL after selecting a size filter. Leave empty for all sizes.",
            "items": {
              "type": "integer"
            }
          },
          "includeSellerDetails": {
            "title": "👤 Seller details ($)",
            "type": "boolean",
            "description": "Enable paid seller enrichment to get seller verification status, rating, review count, and response time when supported by the selected mode. Makes the run slower but gives richer reseller risk data.",
            "default": false
          },
          "includePhotos": {
            "title": "📸 Include Photo URLs",
            "type": "boolean",
            "description": "Enable to include all item photo URLs in the output. Disable for smaller, faster exports.",
            "default": false
          },
          "trackingStoreName": {
            "title": "🧠 Tracking Store Name",
            "type": "string",
            "description": "Named key-value store used by Price Track and Sell-Through Tracker to persist history across scheduled runs. Keep the same value for the same tracker.",
            "default": "vinted-sell-through-tracker"
          },
          "trackerId": {
            "title": "🏷️ Tracker ID",
            "type": "string",
            "description": "Optional stable ID for this tracker. Leave empty to auto-generate from query, countries, filters, maxItems, and item URLs. Use a custom value when creating scheduled trackers for clients."
          },
          "missingRunsThreshold": {
            "title": "📉 Missing Runs Before Likely Sold",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many consecutive scheduled runs an item must disappear before it is marked likely_sold. Use 2 to reduce false positives from ranking changes.",
            "default": 2
          },
          "emitActiveItems": {
            "title": "📤 Output Active Items Too",
            "type": "boolean",
            "description": "When enabled, Sell-Through Tracker outputs active baseline items too. Disable after the first run if you only want missing/likely_sold/sold changes and lower daily result charges.",
            "default": true
          },
          "emitRunSummary": {
            "title": "📋 Output Daily Summary Row",
            "type": "boolean",
            "description": "Adds one SELL_THROUGH_DAILY_SUMMARY row at the end of each Sell-Through Tracker run. Keep enabled for daily schedules, webhooks, Telegram alerts, and CSV reports. Disable only if you need item rows only.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy",
            "type": "object",
            "description": "Leave empty for small scheduled runs. Only change proxy settings if your run fails, slows down, or needs a larger multi-task setup."
          },
          "maxConcurrency": {
            "title": "⚡ Parallel Requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Only used by Item Detail, Price Track, Seller Profile and Sell-Through URL checks. Search, Arbitrage and Trending load one page at a time.",
            "default": 5
          },
          "maxRequestRetries": {
            "title": "🔄 Max Retries",
            "type": "integer",
            "description": "Only used by Item Detail, Price Track, Seller Profile and Sell-Through URL checks: how many times to retry a failed request.",
            "default": 3
          },
          "requestDelayMs": {
            "title": "⏱️ Delay Between Requests (ms)",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Only used by Item Detail, Price Track, Seller Profile and Sell-Through URL checks: wait time between requests in milliseconds.",
            "default": 500
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}