Skip to main content
GET
/
v1
/
vinted
/
search
Search Items
curl --request GET \
  --url https://api.example.com/v1/vinted/search
{
  "items": [
    {
      "id": 123,
      "title": "<string>",
      "price": "<string>",
      "currency": "<string>",
      "brand_title": "<string>",
      "size_title": "<string>",
      "photo": {},
      "url": "<string>",
      "user": {},
      "favourite_count": 123
    }
  ],
  "total_entries": 123,
  "current_page": 123,
  "per_page": 123
}

​
Query Parameters

​
query
string
required
Search query string. Matches against item titles and descriptions.
​
market
string
default:"fr"
Vinted market to search. See /v1/vinted/markets for all supported values.Examples: fr, de, uk, it, es, pl, us
​
page
integer
default:1
Page number for paginated results. Starts at 1.
​
per_page
integer
default:24
Number of items per page. Range: 1 - 96.
​
price_from
number
Minimum price filter in the market’s local currency.
​
price_to
number
Maximum price filter in the market’s local currency.
​
brand_ids
string
Comma-separated list of brand IDs to filter by. Use /v1/vinted/brands to look up IDs.Example: 53, 14,53,221
​
color_ids
string
Comma-separated list of color IDs to filter by. Use /v1/vinted/colors to look up IDs.Example: 1, 1,4,12
​
status_ids
string
Comma-separated list of condition status IDs to filter by. Use /v1/vinted/statuses to look up IDs.Example: 6 (New with tags), 1,2 (New without tags, Very good)
​
order
string
default:"relevance"
Sort order for results.
ValueDescription
relevanceBest match (default)
price_low_to_highCheapest first
price_high_to_lowMost expensive first
newest_firstMost recently listed

​
Response

​
items
array
Array of matching items.
​
total_entries
integer
Total number of matching items across all pages.
​
current_page
integer
Current page number.
​
per_page
integer
Number of items per page.

​
Example Response

{
  "items": [
    {
      "id": 4856231890,
      "title": "Nike Air Force 1 '07 White",
      "price": "45.00",
      "currency": "EUR",
      "brand_title": "Nike",
      "size_title": "42",
      "photo": {
        "url": "https://images1.vinted.net/t/...",
        "width": 800,
        "height": 600
      },
      "url": "https://www.vinted.fr/items/4856231890",
      "user": {
        "id": 12345678,
        "login": "seller_username",
        "photo": {
          "url": "https://images1.vinted.net/t/..."
        }
      },
      "favourite_count": 12
    }
  ],
  "total_entries": 2847,
  "current_page": 1,
  "per_page": 24
}
Each search request costs 1 credit. Failed requests are not charged.