{
  "openapi": "3.0.1",
  "info": {
    "title": "Vinted Cross-Country Price Comparison - Find Arbitrage Deals",
    "description": "Find which Vinted country sells an item cheapest: compare public prices across 27 country sites in EUR, with free per-country price summaries and the median price gap for resale arbitrage. No login, proxies or seller/member data.",
    "version": "0.1",
    "x-build-id": "qyZpvroJ3JP7yUTGa"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lukehunter~vinted-cross-country-prices/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lukehunter-vinted-cross-country-prices",
        "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/lukehunter~vinted-cross-country-prices/runs": {
      "post": {
        "operationId": "runs-sync-lukehunter-vinted-cross-country-prices",
        "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/lukehunter~vinted-cross-country-prices/run-sync": {
      "post": {
        "operationId": "run-sync-lukehunter-vinted-cross-country-prices",
        "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": [
          "searchTerms"
        ],
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "minItems": 1,
            "maxItems": 20,
            "type": "array",
            "description": "1-20 search phrases to compare across every selected Vinted country, e.g. \"nike jacket\".",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries to compare",
            "minItems": 1,
            "maxItems": 27,
            "uniqueItems": true,
            "type": "array",
            "description": "Vinted country domains to compare. Each search term is run once on every selected country.",
            "items": {
              "type": "string",
              "enum": [
                "uk",
                "fr",
                "de",
                "es",
                "it",
                "nl",
                "be",
                "pl",
                "us",
                "au",
                "at",
                "cz",
                "dk",
                "ee",
                "fi",
                "gr",
                "hr",
                "hu",
                "ie",
                "lt",
                "lu",
                "lv",
                "pt",
                "ro",
                "se",
                "si",
                "sk"
              ],
              "enumTitles": [
                "United Kingdom (vinted.co.uk)",
                "France (vinted.fr)",
                "Germany (vinted.de)",
                "Spain (vinted.es)",
                "Italy (vinted.it)",
                "Netherlands (vinted.nl)",
                "Belgium (vinted.be)",
                "Poland (vinted.pl)",
                "United States (vinted.com)",
                "Australia (vinted.com.au)",
                "Austria (vinted.at)",
                "Czechia (vinted.cz)",
                "Denmark (vinted.dk)",
                "Estonia (vinted.ee)",
                "Finland (vinted.fi)",
                "Greece (vinted.gr)",
                "Croatia (vinted.hr)",
                "Hungary (vinted.hu)",
                "Ireland (vinted.ie)",
                "Lithuania (vinted.lt)",
                "Luxembourg (vinted.lu)",
                "Latvia (vinted.lv)",
                "Portugal (vinted.pt)",
                "Romania (vinted.ro)",
                "Sweden (vinted.se)",
                "Slovenia (vinted.si)",
                "Slovakia (vinted.sk)"
              ]
            },
            "default": [
              "uk",
              "fr",
              "de",
              "es",
              "it",
              "nl",
              "pl"
            ]
          },
          "priceFrom": {
            "title": "Minimum comparison price (optional)",
            "minimum": 0,
            "type": "number",
            "description": "Optional minimum in the selected comparison currency (EUR by default). The Actor converts it with its fixed FX table before sending the equivalent local-currency filter to each Vinted country."
          },
          "priceTo": {
            "title": "Maximum comparison price (optional)",
            "minimum": 0,
            "type": "number",
            "description": "Optional maximum in the selected comparison currency (EUR by default). The Actor converts it with its fixed FX table before sending the equivalent local-currency filter to each Vinted country."
          },
          "maxPagesPerCountry": {
            "title": "Maximum pages per country",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "1-5 catalog pages to fetch for each search-term/country combination. Default 1.",
            "default": 1
          },
          "maxItems": {
            "title": "Maximum paid listing rows",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap across all countries and search terms. Default 300, maximum 5,000. Summary rows are free and do not count against this cap.",
            "default": 300
          },
          "currency": {
            "title": "Comparison currency",
            "enum": [
              "EUR",
              "USD",
              "GBP",
              "PLN",
              "AUD",
              "CZK",
              "DKK",
              "HUF",
              "RON",
              "SEK"
            ],
            "type": "string",
            "description": "Currency used to interpret priceFrom and priceTo before converting those filters to each storefront currency. Output comparison fields remain in EUR.",
            "default": "EUR"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}