Vinted

API de filtros de pesquisa da Vinted

As opções de um filtro de pesquisa da Vinted (tamanho, estado, cor ou material) com o número de artigos em tempo real, opcionalmente para uma pesquisa e uma categoria: id (o que size_ids, status_ids, color_ids e material_ids da pesquisa recebem), título localizado, número de artigos, o grupo de tamanhos (por exemplo "Women > Women's items") e, nos estados, a descrição. Custa 1 crédito por pedido.

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

O site nacional da Vinted. Os nomes de categorias, estados e filtros vêm na língua do site. Os sites da UE partilham um único conjunto de anúncios transfronteiriço, e cada site pode mostrar anúncios de vendedores de outros países, com o preço convertido na moeda do site.

Example: uk

fr — França (vinted.fr), EUR. A predefinição.
be — Bélgica (vinted.be), EUR.
lu — Luxemburgo (vinted.lu), EUR.
es — Espanha (vinted.es), EUR.
nl — Países Baixos (vinted.nl), EUR.
lt — Lituânia (vinted.lt), EUR.
de — Alemanha (vinted.de), EUR.
at — Áustria (vinted.at), EUR.
it — Itália (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 — Eslováquia (vinted.sk), EUR.
pl — Polónia (vinted.pl), PLN.
se — Suécia (vinted.se), SEK.
ro — Roménia (vinted.ro), RON.
hu — Hungria (vinted.hu), HUF.
dk — Dinamarca (vinted.dk), DKK.
fi — Finlândia (vinted.fi), EUR.
hr — Croácia (vinted.hr), EUR.
gr — Grécia (vinted.gr), EUR.
ie — Irlanda (vinted.ie), EUR.
ee — Estónia (vinted.ee), EUR.
lv — Letónia (vinted.lv), EUR.
si — Eslovénia (vinted.si), EUR.
au — Austrália (vinted.com.au), AUD.

filterenum<string>required

O filtro a listar.

Example: size

size — Tamanhos, agrupados por categoria; indique category_id. Os ids vão para size_ids da pesquisa.
status — Estados (6 novo com etiquetas, 1 novo sem etiquetas, 2 muito bom, 3 bom, 4 satisfatório). Os ids vão para status_ids.
color — Cores. Os ids vão para color_ids.
material — Materiais. Os ids vão para material_ids.

querystring

Contar as opções para esta pesquisa. Opcional.

Example: dress

category_idinteger

Contar as opções dentro desta categoria, pelo id de /api/v1/vinted/categories. Os tamanhos são agrupados por categoria, por isso indique uma para size.

Example: 1904

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Women's dress sizes on vinted.co.uk with how many listings each has
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") # Women's dress sizes on vinted.co.uk with how many listings each has 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"))