Vinted

API de pesquisa da Vinted

Pesquise anúncios em segunda mão em qualquer um dos 27 sites nacionais da Vinted por palavras-chave, categoria, marca, estado, tamanho, cor, material e intervalo de preço, ordenados por relevância, pelos mais recentes ou por preço. 96 artigos por página, páginas 1 a 10 (a Vinted não serve mais). Cada artigo traz id, título, URL, preço e moeda (a moeda do site do país), price_with_discount, service_fee (a taxa da Vinted que o comprador paga por cima do preço, antes chamada taxa de Proteção do Comprador), total_price, marca, tamanho, estado, número de favoritos, indicação de anúncio promovido, fotos e o id do vendedor com a indicação de vendedor profissional. Devolve também listed_results, total_pages e total_is_capped, e os filtros que a Vinted aplicou de facto, para que um filtro ignorado fique visível. Custa 1 crédito por pedido.

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

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.

querystring

Palavras-chave da pesquisa, até 200 caracteres. Opcional quando indica category_id ou brand_ids (para percorrer uma categoria ou uma marca).

Example: barbour jacket

category_idinteger

Só esta categoria e as suas subcategorias, pelo id de /api/v1/vinted/categories (1907 é Women > Clothing > Outerwear > Coats na árvore do Reino Unido; os ids são iguais em todos os sites).

Example: 1907

brand_idsinteger[]

Só estas marcas, pelo id de /api/v1/vinted/brands (Nike 53, Levi's 10, Barbour 46805). Array ou lista separada por vírgulas, até 20.

Example: [46805]

status_idsinteger[]

Só estes estados: 6 novo com etiquetas, 1 novo sem etiquetas, 2 muito bom, 3 bom, 4 satisfatório. Array ou lista separada por vírgulas.

Example: [6, 1]

size_idsinteger[]

Só estes tamanhos, pelo id da opção em /api/v1/vinted/filters com filter size (4 é o M de mulher / UK 12-14 / US 8-10).

Example: [4]

color_idsinteger[]

Só estas cores, pelo id da opção em /api/v1/vinted/filters com filter color (1 é preto).

Example: [1]

material_idsinteger[]

Só estes materiais, pelo id da opção em /api/v1/vinted/filters com filter material (123 é caxemira).

Example: [123]

price_fromnumber

Preço mínimo do artigo, na moeda do site do país.

Example: 20

price_tonumber

Preço máximo do artigo, na moeda do site do país. Não pode ser inferior a price_from.

Example: 80

sortstring

relevance (predefinição), newest_first, price_low_to_high ou price_high_to_low. As ordenações por preço também incluem artigos que só correspondem vagamente (anúncios muito baratos ou com preço simbólico), por isso combine-as com uma categoria ou um intervalo de preço.

pageinteger

Página de resultados, de 1 a 10. A Vinted serve no máximo 10 páginas de 96. Predefinição 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"])