API de Vinted: anuncios y precios de vinted.es en JSON

Para leer su catálogo desde código, Vinted no ofrece ninguna API pública. Esta interfaz lee vinted.es como lo vería cualquier visitante sin iniciar sesión y devuelve en JSON título, marca, talla, estado, precio en euros y fotos de cada anuncio. El precio llega por partida doble: el que pone el vendedor y el total que paga el comprador con la tarifa de Protección al comprador ya sumada. Conviene aclararlo para quien vende como Vinted Pro: con esto no se publican artículos ni se tramitan pedidos. Es la vista del comprador, limitada a anuncios y perfiles públicos.

Ejemplo que funciona

En vinted.es la búsqueda cruza fronteras. De las 20 chaquetas vaqueras más recientes, 10 tenían el título en español; las otras estaban en portugués, italiano, francés o neerlandés. Como todas tienen el precio en euros, la moneda no delata nada: si necesitas solo vendedores de España, el `country_code` está en `seller`, no en la fila de búsqueda. Fíjate también en la diferencia entre `price` y `total_item_price`: en esta muestra la tarifa fue de 1 € sobre 6 € y de 2,20 € sobre 30 €.

curl -X POST https://api.reefapi.com/vinted/v1/catalog_search \
  -H "x-api-key: TU_CLAVE" \
  -H "content-type: application/json" \
  -d '{"query": "chaqueta vaquera", "tld": "es", "per_page": 20, "order": "newest_first"}'

{
  "ok": true,
  "data": {
    "items": [
      ...
      {
        "id": 10524989021,
        "title": "Chaqueta vaquera Pull&Bear talla M",
        "url": "/items/10524989021-chaqueta-vaquera-pullbear-talla-m",
        "price": { "amount": 15.0, "currency": "EUR" },
        "total_item_price": { "amount": 16.45, "currency": "EUR" },
        "service_fee": { "amount": 1.45, "currency": "EUR" },
        "brand": "Pull & Bear",
        "size": "M",
        "condition": "Muy bueno",
        "uploaded_ts": null,
        "promoted": false
      },
      ...
      {
        "id": 10524990535,
        "title": "Blusão de ganga",
        "price": { "amount": 30.0, "currency": "EUR" },
        "total_item_price": { "amount": 32.2, "currency": "EUR" },
        "service_fee": { "amount": 2.2, "currency": "EUR" },
        "brand": "Cheyenne",
        "size": "S",
        "condition": "Muy bueno"
      },
      {
        "id": 10524988247,
        "title": "Giubbino jeans bambina/o",
        "price": { "amount": 6.0, "currency": "EUR" },
        "total_item_price": { "amount": 7.0, "currency": "EUR" },
        "service_fee": { "amount": 1.0, "currency": "EUR" },
        "brand": "United Colors of Benetton",
        "size": "8 años / 128 cm",
        "condition": "Muy bueno"
      },
      ...
    ],
    "pagination": { "current_page": 1, "per_page": 20, "total_entries": 960, "total_pages": 48 },
    "tld": "es"
  },
  "meta": {
    "record_count": 20,
    "cache_hit": false,
    "mode": "live",
    "tld": "es",
    "total_entries": 960,
    "window_cap": 960,
    "warnings": ["source_fields_unavailable: uploaded_ts, seller.login, seller.profile_url, is_visible, stats_visible, view_count, is_reserved, ..."]
  }
}

Límites y notas honestas

• Esta API no es de Vinted ni se ofrece en colaboración con Vinted; no hay ningún acuerdo entre ambas partes.
• Sin `"tld": "es"` la consulta va a vinted.fr, que es el valor por defecto.
• Varios endpoints auxiliares fallan ahora mismo (medido el 25 de octubre de 2026, dos o tres intentos cada uno): `autocomplete` y `conditions` devuelven UPSTREAM_HTTP, `catalog_filters` NOT_FOUND y `similar` TARGET_BLOCKED. `brand_search` responde, pero ignora el texto: con «pull», «pull & bear» o «nike» devolvió siempre la misma lista de 12 marcas. Por eso no aparecen en la tabla de arriba. Mientras dure, el filtro `brand_ids` solo sirve con esas 12 marcas o con ids que ya tengas: ni la fila de búsqueda ni `item_detail` traen ahora `brand_id`.
• Por cada combinación de filtros Vinted no da más de 960 resultados (`total_entries` se queda en 960). Para llegar más lejos, acota la búsqueda por categoría, talla o precio.
• La fila de búsqueda no trae fecha de subida, visitas ni estado de reserva: esos campos llegan en null y se enumeran en `meta.warnings`. `seller_items` sí los trae, pero solo para el armario de un vendedor.
• En `item_detail` el estado llega en formato schema.org (`UsedCondition`) y `url` en null; la etiqueta en español («Muy bueno») está en `attributes`.
• El gasto de envío no aparece en ninguna respuesta. `total_item_price` suma la tarifa de Protección al comprador, no el envío.
• Si la consulta no coincide con nada, Vinted puede rellenar la página con otros anuncios y la API los entrega tal como llegan; conviene comprobar que los títulos tienen algo que ver con lo buscado.
• No servimos respuestas guardadas de llamadas anteriores: en nuestras pruebas `cache_hit` fue siempre false.