Vinted

Vinted API för sökning

Sök begagnade annonser på någon av Vinteds 27 landssajter på nyckelord, kategori, varumärke, skick, storlek, färg, material och prisintervall, sorterat på relevans, nyast först eller pris. 96 annonser per sida, sidorna 1-10 (Vinted visar inte fler). Varje annons har id, titel, URL, pris och valuta (landssajtens valuta), price_with_discount, service_fee (Vinted-avgiften som köparen betalar utöver priset, tidigare avgiften för köparskydd), total_price, varumärke, storlek, skick, antal favoriter, flagga för marknadsförd annons, foton och säljarens id med en flagga för företagssäljare. Svaret innehåller också listed_results, total_pages och total_is_capped, och de filter som Vinted faktiskt tillämpade, så att ett ignorerat filter syns. Kostar 1 kredit per anrop.

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

Vilken av Vinteds landssajter anropet går till. Namn på kategorier, skick och filter kommer tillbaka på sajtens språk. EU-sajterna delar en gemensam gränsöverskridande annonspool, och varje sajt kan visa annonser från säljare i andra länder, med priset omräknat till sajtens valuta.

Example: uk

fr — Frankrike (vinted.fr), EUR. Standardvärdet.
be — Belgien (vinted.be), EUR.
lu — Luxemburg (vinted.lu), EUR.
es — Spanien (vinted.es), EUR.
nl — Nederländerna (vinted.nl), EUR.
lt — Litauen (vinted.lt), EUR.
de — Tyskland (vinted.de), EUR.
at — Österrike (vinted.at), EUR.
it — Italien (vinted.it), EUR.
uk — Storbritannien (vinted.co.uk), GBP.
pt — Portugal (vinted.pt), EUR.
us — USA (vinted.com), USD.
cz — Tjeckien (vinted.cz), CZK.
sk — Slovakien (vinted.sk), EUR.
pl — Polen (vinted.pl), PLN.
se — Sverige (vinted.se), SEK.
ro — Rumänien (vinted.ro), RON.
hu — Ungern (vinted.hu), HUF.
dk — Danmark (vinted.dk), DKK.
fi — Finland (vinted.fi), EUR.
hr — Kroatien (vinted.hr), EUR.
gr — Grekland (vinted.gr), EUR.
ie — Irland (vinted.ie), EUR.
ee — Estland (vinted.ee), EUR.
lv — Lettland (vinted.lv), EUR.
si — Slovenien (vinted.si), EUR.
au — Australien (vinted.com.au), AUD.

querystring

Sökord, upp till 200 tecken. Valfritt när category_id eller brand_ids anges (för att bläddra i en kategori eller ett varumärke).

Example: barbour jacket

category_idinteger

Bara den här kategorin och dess underkategorier, med id från /api/v1/vinted/categories (1907 är Women > Clothing > Outerwear > Coats i det brittiska kategoriträdet; id:na är desamma på alla sajter).

Example: 1907

brand_idsinteger[]

Bara de här varumärkena, med id från /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805). Array eller kommaseparerad lista, högst 20.

Example: [46805]

status_idsinteger[]

Bara de här skicken: 6 ny med prislapp, 1 ny utan prislapp, 2 mycket bra, 3 bra, 4 acceptabelt. Array eller kommaseparerad lista.

Example: [6, 1]

size_idsinteger[]

Bara de här storlekarna, med alternativets id från /api/v1/vinted/filters med filter size (4 är dam M / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Bara de här färgerna, med alternativets id från /api/v1/vinted/filters med filter color (1 är svart).

Example: [1]

material_idsinteger[]

Bara de här materialen, med alternativets id från /api/v1/vinted/filters med filter material (123 är kashmir).

Example: [123]

price_fromnumber

Lägsta pris, i landssajtens valuta.

Example: 20

price_tonumber

Högsta pris, i landssajtens valuta. Får inte vara lägre än price_from.

Example: 80

sortstring

relevance (standard), newest_first, price_low_to_high eller price_high_to_low. Prissortering tar också med annonser som bara matchar löst (mycket billiga annonser eller annonser med symboliskt pris), så kombinera den med en kategori eller ett prisintervall.

pageinteger

Resultatsida, 1-10. Vinted visar högst 10 sidor med 96 annonser. Standard 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"])