Search the Vinted catalog

Try in Playground

Search listings by keyword, category, brand, condition, colour, size, material and price range, with display labels and pagination.

GET/v1/vinted/searchx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

querystringquery

Search text (1–200 characters). At least one of query, catalog_ids or brand_ids is required.

min 1 chars · max 200 chars

Examplenike zoom

catalog_idsstringquery

Comma-separated category IDs; discover IDs with /v1/vinted/categories.

brand_idsstringquery

Comma-separated brand ids (up to 20); look them up with /v1/vinted/brands.

status_idsstringquery

Comma-separated condition ids.

color_idsstringquery

Comma-separated colour ids.

size_idsstringquery

Comma-separated size ids.

material_idsstringquery

Comma-separated material ids.

price_fromstringquery

Minimum price in major units (up to two decimals).

price_tostringquery

Maximum price in major units.

currencystringquery

ISO 4217 code for price_from/price_to (EUR, GBP, PLN, …).

orderenumquery

relevance (default), newest_first, price_low_to_high or price_high_to_low.

one of: relevance, newest_first, price_low_to_high, price_high_to_low

pagestringquery

Page number, 1–1000; default 1.

per_pagestringquery

Records per page, 1–96; default 24.

domainenumquery

Marketplace domain suffix the data was read from (com, fr, de, co.uk, …).

one of: com, at, be, com.au, cz, de, dk, ee, es, fi, fr, gr, hr, hu, ie, it, lt, lu, lv, nl, pl, pt, ro, se, si, sk, co.uk

Examplefr

Response fields

requestIdstring

Random operational correlation ID.

Upstream requests (the anonymous token HEAD counts as one), response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data was retrieved.

statusenum

success, partial, failed or challenged. Inspect coverage even for HTTP 200.

one of: success, partial

sourceUrlstring

Public www.vinted.<domain> URL the data belongs to.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete means this bounded read had no known omissions; warnings name each omission.

coverage.sourceenum

public_page for the catalog page and the item page, public_api for the JSON web API (profile, wardrobe, feedback, brands).

one of: public_api, public_page

coverage.completeboolean

False when any warning is present.

coverage.warningsstring[]

Machine-readable coverage information for this response.

domainenum

Marketplace domain suffix the data was read from (com, fr, de, co.uk, …).

one of: com, at, be, com.au, cz, de, dk, ee, es, fi, fr, gr, hr, hu, ie, it, lt, lu, lv, nl, pl, pt, ro, se, si, sk, co.uk

querystringnullable

Search text (1–200 characters). At least one of query, catalog_ids or brand_ids is required.

Listing records in source order.

up to 96 items

items.idstring

Item id (string).

items.urlstring

Public item URL on the requested marketplace.

absolute HTTPS URL

items.titlestringnullable

Listing title.

Asking price in major units with ISO currency, as the source states it.

items.price.amountnumbernullable

Always included.

items.price.currencystringnullable

Always included.

Buyer-protection fee the source quotes for this item.

items.serviceFee.amountnumbernullable

Always included.

items.serviceFee.currencystringnullable

Always included.

Asking price plus buyer protection.

items.totalPrice.amountnumbernullable

Always included.

items.totalPrice.currencystringnullable

Always included.

items.brandstringnullable

Brand label.

items.sizestringnullable

Size label.

items.statusstringnullable

Condition label in the marketplace language.

items.favouriteCountintegernullable

Favourites.

items.viewCountintegernullable

Listing view count.

items.promotedbooleannullable

Whether the seller paid to promote the listing.

items.isVisiblebooleannullable

Source visibility flag.

items.isReservedbooleannullable

Reservation flag.

items.isClosedbooleannullable

Closed-listing flag.

items.isHiddenbooleannullable

Hidden-listing flag.

items.isDraftbooleannullable

Draft flag.

items.transactionPermittedbooleannullable

Source transaction-permission flag.

items.isProcessingbooleannullable

Source processing flag.

items.isHeavyBulkybooleannullable

Heavy or bulky item flag.

Original listing-card display labels.

items.displayLines.firststringnullable

First display line.

items.displayLines.secondstringnullable

Second display line.

Main listing photo and thumbnails.

items.photo.idstringnullable

Always included.

items.photo.urlstringnullable

Always included.

items.photo.fullSizeUrlstringnullable

Always included.

items.photo.widthintegernullable

Always included.

items.photo.heightintegernullable

Always included.

items.photo.dominantColorstringnullable

Always included.

items.photo.isMainbooleannullable

Always included.

up to 20 items

items.photo.thumbnails.typestringnullable

Always included.

items.photo.thumbnails.urlstringnullable

Always included.

items.photo.thumbnails.widthintegernullable

Always included.

items.photo.thumbnails.heightintegernullable

Always included.

Listing photos and thumbnails.

up to 20 items

items.photos.idstringnullable

Always included.

items.photos.urlstringnullable

Always included.

items.photos.fullSizeUrlstringnullable

Always included.

items.photos.widthintegernullable

Always included.

items.photos.heightintegernullable

Always included.

items.photos.dominantColorstringnullable

Always included.

items.photos.isMainbooleannullable

Always included.

up to 20 items

items.photos.thumbnails.typestringnullable

Always included.

items.photos.thumbnails.urlstringnullable

Always included.

items.photos.thumbnails.widthintegernullable

Always included.

items.photos.thumbnails.heightintegernullable

Always included.

Seller ID, profile URL, login, avatar and business flag.

items.user.idstring

Always included.

items.user.loginstringnullable

Always included.

items.user.urlstringnullable

Always included.

items.user.businessbooleannullable

Always included.

items.user.photo.idstringnullable

Always included.

items.user.photo.urlstringnullable

Always included.

Source page state.

pagination.pageintegernullable

Current page.

pagination.perPageintegernullable

Records per page.

pagination.totalPagesintegernullable

Total pages the source reports.

pagination.totalEntriesintegernullable

Total records the source reports.

pagination.hasMoreboolean

Whether page + 1 exists.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Missing, duplicate, unsupported or invalid parameters, more than one selector, a domain that does not match the URL host, or a page beyond what the source accepts.
401	`unauthorized`	Missing or invalid service key.
404	`not_found`	Unknown item or member.
429	`upstream_rate_limited`	Vinted rate limited the request; no automatic retry.
502	`upstream_challenged`	DataDome/Cloudflare challenge, HTTP 401/403/503, or no anonymous token issued.
502	`unsupported_page` `unsafe_redirect` `response_too_large` `request_limit` `upstream_error`	Bounded retrieval failed, the page belongs to another item, or the response no longer matches the expected structure.
503	`busy`	All worker slots occupied.
504	`timeout`	Deadline exceeded.
200	`partial`	Coverage warnings such as pricing_missing, photos_missing or pagination_missing.

Code example

curl "https://api.scrapeatlas.com/v1/vinted/search?query=nike+zoom&domain=fr" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vinted/search?query=nike+zoom&domain=fr",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vinted/search?query=nike+zoom&domain=fr",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Vinted request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/vinted/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "query": "nike zoom",
        "domain": "fr"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/vinted/search?query=nike+zoom&domain=fr", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/vinted/search?query=nike+zoom&domain=fr"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "partial",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "domain": "fr",
  "query": "nike zoom",
  "items": [
    {
      "id": "9964011846",
      "url": "https://www.vinted.fr/items/9964011846-nike-zoom-vomero",
      "title": "Nike Zoom Vomero",
      "price": {
        "amount": 100,
        "currency": "EUR"
      },
      "serviceFee": {
        "amount": 5.7,
        "currency": "EUR"
      },
      "totalPrice": {
        "amount": 105.7,
        "currency": "EUR"
      },
      "brand": "Nike",
      "size": "39",
      "status": "New with tags",
      "favouriteCount": 0,
      "viewCount": null,
      "promoted": false,
      "isVisible": null,
      "isReserved": null,
      "isClosed": null,
      "isHidden": null,
      "isDraft": null,
      "photo": {
        "id": null,
        "url": "https://images1.vinted.net/t/02_example/f800/1789135019.jpeg?s=e22813139f",
        "fullSizeUrl": null,
        "width": null,
        "height": null,
        "dominantColor": "#444141",
        "isMain": true,
        "thumbnails": [
          {
            "type": "thumb150x210",
            "url": "https://images1.vinted.net/t/02_example/150x210/1789135019.jpeg?s=a26d73f0",
            "width": 150,
            "height": 210
          }
        ]
      },
      "photos": [
        {
          "id": null,
          "url": "https://images1.vinted.net/t/02_example/f800/1789135019.jpeg?s=e22813139f",
          "fullSizeUrl": null,
          "width": null,
          "height": null,
          "dominantColor": "#444141",
          "isMain": true,
          "thumbnails": [
            {
              "type": "thumb150x210",
              "url": "https://images1.vinted.net/t/02_example/150x210/1789135019.jpeg?s=a26d73f0",
              "width": 150,
              "height": 210
            }
          ]
        }
      ],
      "user": {
        "id": "316651900",
        "login": null,
        "url": "https://www.vinted.fr/member/316651900",
        "business": false,
        "photo": null
      },
      "transactionPermitted": null,
      "isProcessing": null,
      "isHeavyBulky": null,
      "displayLines": {
        "first": "Nike",
        "second": "39 · New with tags"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 24,
    "totalPages": 40,
    "totalEntries": 960,
    "hasMore": true
  },
  "sourceUrl": "https://www.vinted.fr/catalog?search_text=nike+zoom",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": false,
    "warnings": [
      "search_results_capped"
    ]
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 7241012,
    "durationMs": 1671
  }
}

Missing, duplicate, unsupported or invalid parameters, more than one selector, a domain that does not match the URL host, or a page beyond what the source accepts.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}