Search Items

Search Vinted catalog items with filters.

GET /v1/vinted/search

Search Items

cURL

curl --request GET \
  --url https://scrapebadger.com/v1/vinted/search \
  --header 'x-api-key: <api-key>'

200

{
  "items": [
    {
      "id": 123,
      "title": "<string>",
      "price": "<string>",
      "currency": "<string>",
      "brand_title": "<string>",
      "size_title": "<string>",
      "photo": {
        "url": "<string>",
        "width": 123,
        "height": 123
      },
      "url": "<string>",
      "user": {
        "id": 123,
        "login": "<string>",
        "photo": {
          "url": "<string>"
        },
        "feedback_reputation": 123
      },
      "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.

Value	Description
relevance	Best match (default)
price_low_to_high	Cheapest first
price_high_to_low	Most expensive first
newest_first	Most recently listed

Response

items · array

Array of matching items.

Show Item object

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

Brand name.

size_title · string

Size label.

photo · object

Primary photo with url, width, height.

url · string

Full URL to the Vinted listing.

user · object

Seller summary with id, login, photo.

favourite_count · integer

Number of users who favourited this item.

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.

Authorizations

x-api-key · string · header · required

Query Parameters

query · string · required

Search query string. Matches against item titles and descriptions.

market · string · default: fr

Vinted market to search (e.g. fr, de, uk, it, es, pl, us).

page · integer · default: 1

Page number for paginated results.

Required range: x >= 1

per_page · integer · default: 24

Number of items per page.

Required range: 1 <= x <= 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.

color_ids · string

Comma-separated list of color IDs to filter by.

status_ids · string

Comma-separated list of condition status IDs to filter by.

order · enum<string> · default: relevance

Sort order for results.

Available options: relevance, price_low_to_high, price_high_to_low, newest_first

Response

200 - application/json

Successful search

items · object[]

Show child attributes

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.