---
title: "Search Items"
method: GET
path: "/v1/vinted/search"
---

# Search Items

`GET /v1/vinted/search`

Search Vinted catalog items with filters.

## Query parameters

- `query` string, required
- `market` string
- `page` integer
- `per_page` integer
- `price_from` number
- `price_to` number
- `brand_ids` string
- `color_ids` string
- `status_ids` string
- `order` 'relevance' | 'price_low_to_high' | 'price_high_to_low' | 'newest_first'
- `seller_country` string

## Response `200`

Successful search

- object
  - `items` VintedItemSummary[]
    - `id` integer — Item ID.
    - `title` string — Item title.
    - `price` string — Price in local currency (e.g. "15.00").
    - `currency` string — ISO 4217 currency code (e.g. "EUR").
    - `brand_title` string, nullable — Brand name.
    - `size_title` string, nullable — Size label.
    - `photo` VintedPhoto
      - `url` string — Photo URL.
      - `width` integer, nullable — Width in pixels.
      - `height` integer, nullable — Height in pixels.
    - `url` string — Full URL to the Vinted listing.
    - `user` VintedUserSummary
      - `id` integer — User ID.
      - `login` string — Username.
      - `photo` object, nullable
        - `url` string
      - `feedback_reputation` number, nullable — Reputation score between 0 and 1.
    - `favourite_count` integer — Number of users who favourited this item.
    - `seller_country_code` string, nullable — ISO 3166-1 alpha-2 code of the seller's physical country (e.g. "IT"), or null if it could not be resolved.
  - `total_entries` integer — Total number of matching items across all pages. Reflects Vinted's unfiltered totals even when seller_country filtering is applied.
  - `current_page` integer — Current page number.
  - `per_page` integer — Number of items per page.
  - `seller_country` string, nullable — Echo of the normalized seller_country filter that was applied (uppercase, comma-separated ISO-2 codes, e.g. "FR,BE"), or null when no filter was requested.

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/versions/4a1ef8777baf/schema)