{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Scraper: Listings, Sold Checks & Seller Data",
    "description": "Vinted listings, seller closets and reviews, sold-item checks, cross-country price gaps and a new-listing monitor in one actor: filters, 28 country sites, past the 960-result limit. From $1 per 1,000.",
    "version": "0.0",
    "x-build-id": "smtu0MXdO0CcWeLZ0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapebench~vinted-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapebench-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/scrapebench~vinted-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapebench-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/scrapebench~vinted-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapebench-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": {
          "mode": {
            "title": "What to do",
            "enum": [
              "listings",
              "seller",
              "sold",
              "compare",
              "monitor"
            ],
            "type": "string",
            "description": "listings: search results. seller: a member's profile, closet and reviews. sold: check items, or watch a search and report what sold. compare: the same search in several countries with price gaps. monitor: only listings that are new since your last run.",
            "default": "listings"
          },
          "searches": {
            "title": "Search terms",
            "type": "array",
            "description": "What to look for, one per line (nike air max, levi's 501, ralph lauren jumper). Each search runs in every country below; an item found twice is returned and charged once.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "search": {
            "title": "Search term (single)",
            "type": "string",
            "description": "One search term, for saved tasks and API calls that send a single value. Use Search terms above for several."
          },
          "startUrls": {
            "title": "Vinted search URLs",
            "type": "array",
            "description": "Paste catalog or search pages from any Vinted country site (https://www.vinted.fr/catalog?search_text=...). The country and every filter in the URL are kept.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Vinted country sites to search, as two-letter codes, one per line: fr, de, it, es, nl, be, pl, pt, at, cz, lt, lu, sk, uk, us, se, dk, fi, hu, ro, hr, gr, si, ee, lv, bg, ie, au. Empty means fr. Compare mode needs two or more.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Maximum items per search and country",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Cap for EACH search in EACH country (closet items in seller mode). Vinted shows 960 results a search; above that the actor splits the search into price bands to reach more.",
            "default": 100
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "relevance",
              "newest",
              "price_asc",
              "price_desc"
            ],
            "type": "string",
            "description": "Order Vinted returns results in.",
            "default": "relevance"
          },
          "priceMin": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price, in the country's currency."
          },
          "priceMax": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price, in the country's currency."
          },
          "brandIds": {
            "title": "Brand ids",
            "type": "array",
            "description": "Vinted brand ids, one per line (Nike is 53, Adidas 14). The id is the number in a brand page URL.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "catalogIds": {
            "title": "Category ids",
            "type": "array",
            "description": "Vinted category ids, one per line. The id is the number in a category page URL (https://www.vinted.fr/catalog/1231-sneakers).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sizeIds": {
            "title": "Size ids",
            "type": "array",
            "description": "Vinted size ids, one per line, as in a search URL's size_ids[].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "colorIds": {
            "title": "Colour ids",
            "type": "array",
            "description": "Vinted colour ids, one per line, as in a search URL's color_ids[].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Only these conditions: new_with_tags, new_without_tags, very_good, good, satisfactory. Empty means any.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "splitBeyondCap": {
            "title": "Go past Vinted's 960-result limit",
            "type": "boolean",
            "description": "When a search holds more than 960 results and you ask for more, cut it into price bands to reach the rest. A free notice says if some slices still hit the limit.",
            "default": true
          },
          "includeDetails": {
            "title": "Item details",
            "type": "boolean",
            "description": "Open each item page for the full description, every photo, colour, category, how long ago it was listed and the seller's login and rating. Charged per item as Item details.",
            "default": false
          },
          "sellerIds": {
            "title": "Seller ids",
            "type": "array",
            "description": "Seller mode: member ids, one per line (the number in a profile URL).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sellerUrls": {
            "title": "Seller profile URLs",
            "type": "array",
            "description": "Seller mode: member page URLs (https://www.vinted.fr/member/123456-name); the country site is read from the URL.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeCloset": {
            "title": "Include the closet",
            "type": "boolean",
            "description": "Seller mode: also return the member's items, sold ones included.",
            "default": true
          },
          "includeFeedback": {
            "title": "Include reviews",
            "type": "boolean",
            "description": "Seller mode: also return the member's reviews, newest first.",
            "default": false
          },
          "maxFeedback": {
            "title": "Maximum reviews per seller",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Cap on reviews per seller.",
            "default": 50
          },
          "itemUrls": {
            "title": "Item URLs",
            "type": "array",
            "description": "Sold mode: item page URLs to check. Each comes back as sold, still active, or removed.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "itemIds": {
            "title": "Item ids",
            "type": "array",
            "description": "Sold mode: item ids to check (the number in an item URL), one per line. The first country is used.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "watchName": {
            "title": "Watch name",
            "type": "string",
            "description": "Sold and monitor modes: a name for what you are watching. The actor remembers the items it saw under this name and compares them on the next run. Use a different name per search."
          },
          "maxRechecks": {
            "title": "Maximum items re-checked per run",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Sold mode with a watch: how many disappeared items to open per run.",
            "default": 200
          },
          "onlyPriceDrops": {
            "title": "Only price drops",
            "type": "boolean",
            "description": "Monitor mode: return only items already seen whose price fell, not new items.",
            "default": false
          },
          "minDropPct": {
            "title": "Minimum price drop %",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Monitor mode: how far a price must fall to be reported.",
            "default": 5
          },
          "includeListings": {
            "title": "Return the listings in compare mode",
            "type": "boolean",
            "description": "Compare mode: return the listings too (with a euro price), not only the summaries.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: Vinted answers Apify's own addresses. Turn on a proxy only if a country site refuses your run.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}