Output and formats
JSON by default, a table when you want to read it, JSONL when you want to pipe it.
Commands use JSON by default. Errors go to stderr rather than stdout.
vinted search "levis 501" | jq '.items[0]'Formats
The default format prints one JSON document.
vinted search "levis 501"Colour follows NO_COLOR and switches off when stdout is not a terminal.
Errors
Errors are human-readable by default. For scripts, ask for the envelope:
vinted --error-format json item show 1{
"code": 4,
"category": "not_found",
"message": "no item with that id",
"endpoint": "GET /items/{id}",
"suggested_commands": ["vinted search ..."]
}The category is stable and worth branching on. The prose in message is not.