Vinted

Vinted Search API

Szukaj ogłoszeń z drugiej ręki na każdej z 27 krajowych stron Vinted po słowach kluczowych, kategorii, marce, stanie, rozmiarze, kolorze, materiale i zakresie cen, z sortowaniem według trafności, od najnowszych lub po cenie. 96 przedmiotów na stronę, strony 1-10 (dalej Vinted nie sięga). Każdy przedmiot ma ID, tytuł, URL, cenę i walutę (waluta strony), price_with_discount, service_fee (opłata Vinted, którą kupujący płaci ponad cenę, dawniej Buyer Protection fee), total_price, markę, rozmiar, stan, liczbę polubień, flagę promowania, zdjęcia oraz ID sprzedawcy i flagę konta firmowego. Zwraca też listed_results, total_pages i total_is_capped oraz filtry, które Vinted faktycznie zastosował, więc widać, gdy któryś został pominięty. Koszt: 1 kredyt za zapytanie.

POST/api/v1/vinted/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

countryenum<string>default:fr

Krajowa strona Vinted. Nazwy kategorii, stanów i filtrów wracają w języku danej strony. Strony z UE mają jedną wspólną, transgraniczną pulę ogłoszeń, a każda strona może pokazywać ogłoszenia sprzedawców z innych krajów, z ceną przeliczoną na walutę strony.

Example: pl

fr — Francja (vinted.fr), EUR. Wartość domyślna.
be — Belgia (vinted.be), EUR.
lu — Luksemburg (vinted.lu), EUR.
es — Hiszpania (vinted.es), EUR.
nl — Holandia (vinted.nl), EUR.
lt — Litwa (vinted.lt), EUR.
de — Niemcy (vinted.de), EUR.
at — Austria (vinted.at), EUR.
it — Włochy (vinted.it), EUR.
uk — Wielka Brytania (vinted.co.uk), GBP.
pt — Portugalia (vinted.pt), EUR.
us — Stany Zjednoczone (vinted.com), USD.
cz — Czechy (vinted.cz), CZK.
sk — Słowacja (vinted.sk), EUR.
pl — Polska (vinted.pl), PLN.
se — Szwecja (vinted.se), SEK.
ro — Rumunia (vinted.ro), RON.
hu — Węgry (vinted.hu), HUF.
dk — Dania (vinted.dk), DKK.
fi — Finlandia (vinted.fi), EUR.
hr — Chorwacja (vinted.hr), EUR.
gr — Grecja (vinted.gr), EUR.
ie — Irlandia (vinted.ie), EUR.
ee — Estonia (vinted.ee), EUR.
lv — Łotwa (vinted.lv), EUR.
si — Słowenia (vinted.si), EUR.
au — Australia (vinted.com.au), AUD.

querystring

Słowa kluczowe, do 200 znaków. Opcjonalne, gdy podano category_id lub brand_ids (przeglądanie kategorii lub marki).

Example: sukienka

category_idinteger

Tylko ta kategoria i jej podkategorie, po ID z /api/v1/vinted/categories (1907 to Kobiety > Ubrania > Odzież wierzchnia > Płaszcze).

Example: 1907

brand_idsinteger[]

Tylko te marki, po ID z /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805). Tablica lub lista po przecinku, do 20.

Example: [46805]

status_idsinteger[]

Tylko te stany: 6 Nowy z metką, 1 Nowy bez metki, 2 Bardzo dobry, 3 Dobry, 4 Satisfactory (nazwa angielska; /api/v1/vinted/filters z filtrem status zwraca etykiety każdej strony). Tablica lub lista po przecinku.

Example: [6, 1]

size_idsinteger[]

Tylko te rozmiary, po ID opcji z /api/v1/vinted/filters z filtrem size (4 to damskie M / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Tylko te kolory, po ID opcji z /api/v1/vinted/filters z filtrem color (1 to czarny).

Example: [1]

material_idsinteger[]

Tylko te materiały, po ID opcji z /api/v1/vinted/filters z filtrem material (123 to kaszmir).

Example: [123]

price_fromnumber

Minimalna cena przedmiotu, w walucie strony.

Example: 20

price_tonumber

Maksymalna cena przedmiotu, w walucie strony. Nie może być niższa niż price_from.

Example: 80

sortstring

relevance (domyślnie), newest_first, price_low_to_high lub price_high_to_low. Sortowanie po cenie wyciąga też luźno dopasowane przedmioty (bardzo tanie lub z ceną zastępczą), więc łącz je z kategorią lub zakresem cen.

pageinteger

Strona wyników, 1-10. Vinted udostępnia maksymalnie 10 stron po 96. Domyślnie 1.

Example: 1

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.vinted.search(country="uk", query="barbour jacket", sort="newest_first")["data"]

print(res["count"], "items, page", res["page"], "of", res["total_pages"])
for item in res["items"]:
    print(item["id"], item["title"], item["price"], item["currency"],
          "with the Vinted fee", item["total_price"], item["condition"])

Response

"country": "uk",

"currency": "GBP",

"query": "barbour jacket",

"page": 1,

"per_page": 96,

"count": 96,

"listed_results": 960,

"total_is_capped": true,

"total_pages": 10,

"has_more": true,

"response_time": 6335

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.vinted.search(country="uk", query="barbour jacket", sort="newest_first")["data"] print(res["count"], "items, page", res["page"], "of", res["total_pages"]) for item in res["items"]: print(item["id"], item["title"], item["price"], item["currency"], "with the Vinted fee", item["total_price"], item["condition"])