Vinted

API de búsqueda de Vinted

Busca anuncios de segunda mano en cualquiera de los 27 sitios de Vinted por palabras clave, categoría, marca, estado, talla, color, material y rango de precios, ordenados por relevancia, por lo más nuevo o por precio. Para Vinted España, envía "country": "es". 96 artículos por página, páginas de la 1 a la 10 (Vinted no sirve más). Cada artículo trae su id, título, URL, precio y moneda (la del sitio), price_with_discount, service_fee (la tarifa de Vinted que paga el comprador además del precio, antes llamada Buyer Protection fee), total_price, marca, talla, estado, número de favoritos, si está promocionado, fotos, y el id del vendedor y si es profesional. También devuelve listed_results, total_pages y total_is_capped, y los filtros que Vinted aplicó de verdad, así que se ve si alguno se ignoró. Cuesta 1 crédito por solicitud.

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

El sitio de Vinted del país. Los nombres de categoría, estado y filtro llegan en el idioma del sitio. Los sitios de la UE comparten un único fondo de anuncios transfronterizo, y cada sitio puede mostrar anuncios de vendedores de otros países, con el precio convertido a la moneda del sitio.

Example: es

fr — Francia (vinted.fr), EUR. El valor por defecto.
be — Bélgica (vinted.be), EUR.
lu — Luxemburgo (vinted.lu), EUR.
es — España (vinted.es), EUR.
nl — Países Bajos (vinted.nl), EUR.
lt — Lituania (vinted.lt), EUR.
de — Alemania (vinted.de), EUR.
at — Austria (vinted.at), EUR.
it — Italia (vinted.it), EUR.
uk — Reino Unido (vinted.co.uk), GBP.
pt — Portugal (vinted.pt), EUR.
us — Estados Unidos (vinted.com), USD.
cz — República Checa (vinted.cz), CZK.
sk — Eslovaquia (vinted.sk), EUR.
pl — Polonia (vinted.pl), PLN.
se — Suecia (vinted.se), SEK.
ro — Rumanía (vinted.ro), RON.
hu — Hungría (vinted.hu), HUF.
dk — Dinamarca (vinted.dk), DKK.
fi — Finlandia (vinted.fi), EUR.
hr — Croacia (vinted.hr), EUR.
gr — Grecia (vinted.gr), EUR.
ie — Irlanda (vinted.ie), EUR.
ee — Estonia (vinted.ee), EUR.
lv — Letonia (vinted.lv), EUR.
si — Eslovenia (vinted.si), EUR.
au — Australia (vinted.com.au), AUD.

querystring

Palabras clave, hasta 200 caracteres. Opcional si envías category_id o brand_ids (para recorrer una categoría o una marca).

Example: barbour jacket

category_idinteger

Solo esta categoría y sus subcategorías, por id de /api/v1/vinted/categories (1907 son los abrigos de mujer, Women > Clothing > Outerwear > Coats en vinted.co.uk).

Example: 1907

brand_idsinteger[]

Solo estas marcas, por id de /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805, Zara 12). Array o lista separada por comas, hasta 20.

Example: [46805]

status_idsinteger[]

Solo estos estados: 6 nuevo con etiquetas, 1 nuevo sin etiquetas, 2 muy bueno, 3 bueno, 4 satisfactorio. Array o lista separada por comas.

Example: [6, 1]

size_idsinteger[]

Solo estas tallas, por id de opción de /api/v1/vinted/filters con filter size (4 es la M de mujer / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Solo estos colores, por id de opción de /api/v1/vinted/filters con filter color (1 es negro).

Example: [1]

material_idsinteger[]

Solo estos materiales, por id de opción de /api/v1/vinted/filters con filter material (123 es cachemira).

Example: [123]

price_fromnumber

Precio mínimo del artículo, en la moneda del sitio.

Example: 20

price_tonumber

Precio máximo del artículo, en la moneda del sitio. No puede ser menor que price_from.

Example: 80

sortstring

relevance (por defecto), newest_first, price_low_to_high o price_high_to_low. Las ordenaciones por precio también incluyen artículos que encajan poco con la búsqueda (anuncios muy baratos o con precio de relleno), así que combínalas con una categoría o un rango de precios.

pageinteger

Página de resultados, 1-10. Vinted sirve como máximo 10 páginas de 96. Por defecto, 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"], "artículos, página", res["page"], "de", res["total_pages"])
for item in res["items"]:
    print(item["id"], item["title"], item["price"], item["currency"],
          "con la tarifa de Vinted", 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"], "artículos, página", res["page"], "de", res["total_pages"]) for item in res["items"]: print(item["id"], item["title"], item["price"], item["currency"], "con la tarifa de Vinted", item["total_price"], item["condition"])