Vinted

This connector uses the internal API behind the Vinted website (api.vinted.fr). Vinted has no official public API for the catalog: this is the one its own web app calls, it is undocumented, and Vinted changes it without notice (in September 2026 it retired www.vinted.fr/api/v2/catalog/items, which is why earlier versions of this connector failed on every call).

Setup: nothing to enter. On the first call the connector requests https://www.vinted.fr/catalog once, keeps the anonymous access_token_web session cookie Vinted hands to every visitor, and sends it as a bearer token. The token lasts 24 hours; the connector renews it on its own, and again whenever Vinted answers 401.

Workflow:

1. Optional: vinted_get_categories for category IDs and vinted_get_filters (filter_code = brand, size, status, color or material) for the IDs of brands, sizes, conditions, colours and materials, with item counts for the current search.
2. vinted_search_items with search_text and any of those IDs (comma-separated for several).

Condition IDs (status_ids): 6 new with tags, 1 new without tags, 2 very good, 3 good, 4 satisfactory.

Limits:

• Read-only: no buying, messaging, favourites or listing. Those need a logged-in Vinted account and happen in the Vinted app.
• One market: the catalog is served for vinted.fr, prices are in EUR, titles and filter names are in French. Items listed in other EU markets appear too.
• A search reaches at most 960 items (e.g. 10 pages of 96); narrow it with filters rather than paging further. total_entries is capped at 960 for the same reason.
• Size IDs depend on the category: pass catalog_ids to vinted_get_filters with filter_code=size, or the answer lists every size chart (about 30 KB).
• Unofficial: if Vinted moves the endpoint or blocks the session request, calls fail with 401/403/404 until the connector is updated. Use it for occasional lookups, in line with Vinted's terms, not for bulk collection.

Suggested starter prompts:

• "Find Stone Island jackets size L under €150 on Vinted, newest first."
• "Search Vinted for 'Carhartt WIP' trousers in very good condition."
• "Which brands have the most 'veste en jean' listings on Vinted right now?"