vinted-cli
Command reference

search

Search the catalog

Search the catalog

vinted search [text...] [flags]

Search the Vinted catalog of the profile's site.

Common filters are flags; ids for --catalog and --brand come from vinted category list and vinted brand search. Any other catalog query parameter goes through --filter key=value verbatim. No login is needed.

vinted search "levis 501" --price-to 30 --order newest_first --format pretty
vinted search --catalog 1206 --brand 53 --condition very_good --condition good
vinted search nike --pages 3 --limit 100 --format jsonl
vinted search nike --page 2
FlagTypeDefaultDescription
--attrstringArray[]any other filter as CODE=ID[,ID], repeatable (codes and ids from vinted search filters)
--brandintSlice[]brand id, repeatable (ids from vinted brand search)
--catalogintSlice[]category id, repeatable (ids from vinted category list)
--colorintSlice[]colour id, repeatable (ids from vinted search filters)
--conditionstringSlice[]item condition, repeatable: new_with_tags, new_without_tags, new, very_good, good, satisfactory, not_fully_functional, or a status id
--currencystring-code of the --price-from/--price-to currency (EUR, USD...; default the site's)
--filterstringArray[]any other catalog query parameter as key=value, repeatable, sent verbatim
--languageintSlice[]book language id, repeatable (books)
--limitint0stop after this many items (0 = whole pages)
--materialintSlice[]material id, repeatable (ids from vinted search filters)
--modelintSlice[]model id, repeatable (phones and other electronics)
--orderstring-order: relevance, newest_first, price_low_to_high, price_high_to_low
--pageint1first result page
--pagesint1how many result pages to fetch (max 5)
--patternintSlice[]pattern id, repeatable (clothing)
--platformintSlice[]video game platform id, repeatable (video games)
--price-fromfloat640minimum price
--price-tofloat640maximum price
--sim-lockintSlice[]SIM lock id, repeatable (phones)
--sizeintSlice[]size id, repeatable (ids from vinted search filters --catalog ID)
--storageintSlice[]storage capacity id, repeatable (phones, tablets)
--video-game-ratingintSlice[]content rating id, repeatable (video games)

vinted search filters

List the catalog filters with their option ids

vinted search filters [text...] [flags]

List the filters Vinted offers for a search, as the site's filter bar shows them: each filter's code, whether several options can be picked, the search flag that sets it (--attr CODE=ID for filters without their own flag), and every option id with its title. Options depend on the category, so pass --catalog for the category you search in. Brand lists only popular brands; find any other with vinted brand search. The other search flags narrow the options the way a selection on the site does.

The filter list is one request to Vinted and each filter's options one more, as on the site; --code loads only the options of the filters named.

vinted search filters --format pretty
vinted search filters --catalog 1845 --code size --format pretty
vinted search filters --catalog 1845 | jq '.[] | {code, params}'
FlagTypeDefaultDescription
--attrstringArray[]any other filter as CODE=ID[,ID], repeatable (codes and ids from vinted search filters)
--brandintSlice[]brand id, repeatable (ids from vinted brand search)
--catalogintSlice[]category id, repeatable (ids from vinted category list)
--codestringSlice[]load options only for these filter codes (size, status, color...), repeatable
--colorintSlice[]colour id, repeatable (ids from vinted search filters)
--conditionstringSlice[]item condition, repeatable: new_with_tags, new_without_tags, new, very_good, good, satisfactory, not_fully_functional, or a status id
--currencystring-code of the --price-from/--price-to currency (EUR, USD...; default the site's)
--filterstringArray[]any other catalog query parameter as key=value, repeatable, sent verbatim
--languageintSlice[]book language id, repeatable (books)
--materialintSlice[]material id, repeatable (ids from vinted search filters)
--modelintSlice[]model id, repeatable (phones and other electronics)
--orderstring-order: relevance, newest_first, price_low_to_high, price_high_to_low
--patternintSlice[]pattern id, repeatable (clothing)
--platformintSlice[]video game platform id, repeatable (video games)
--price-fromfloat640minimum price
--price-tofloat640maximum price
--sim-lockintSlice[]SIM lock id, repeatable (phones)
--sizeintSlice[]size id, repeatable (ids from vinted search filters --catalog ID)
--storageintSlice[]storage capacity id, repeatable (phones, tablets)
--video-game-ratingintSlice[]content rating id, repeatable (video games)

On this page