Vinted

API de filtros de búsqueda de Vinted

Las opciones de un filtro de búsqueda de Vinted (talla, estado, color o material) con el número de artículos en ese momento, opcionalmente para una búsqueda y una categoría: id (lo que aceptan size_ids, status_ids, color_ids y material_ids en la búsqueda), título en el idioma del sitio, número de artículos, el grupo de tallas (p. ej. "Women > Women's items") y, en los estados, su descripción. Cuesta 1 crédito por solicitud.

POST/api/v1/vinted/filters

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.

filterenum<string>required

Qué filtro listar.

Example: size

size — Tallas, agrupadas por categoría; envía category_id. Los ids van a size_ids en la búsqueda.
status — Estados (6 nuevo con etiquetas, 1 nuevo sin etiquetas, 2 muy bueno, 3 bueno, 4 satisfactorio). Los ids van a status_ids.
color — Colores. Los ids van a color_ids.
material — Materiales. Los ids van a material_ids.

querystring

Cuenta las opciones para esta búsqueda. Opcional.

Example: dress

category_idinteger

Cuenta las opciones dentro de esta categoría, por id de /api/v1/vinted/categories. Las tallas van agrupadas por categoría, así que envía una para size.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Tallas de vestidos de mujer en vinted.co.uk con cuántos anuncios tiene cada una
res = client.vinted.filters(country="uk", filter="size", query="dress", category_id=1904)["data"]

for o in res["options"]:
    print(o["id"], o["title"], o["item_count"], o.get("group"))

Response

"country": "us",

"filter": "status",

"search_param": "status_ids",

"query": null,

"category_id": null,

"count": 5,

"response_time": 10985

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Tallas de vestidos de mujer en vinted.co.uk con cuántos anuncios tiene cada una res = client.vinted.filters(country="uk", filter="size", query="dress", category_id=1904)["data"] for o in res["options"]: print(o["id"], o["title"], o["item_count"], o.get("group"))