API de eBay: anuncios activos de ebay.es, con precio y envío, como JSON

eBay ofrece sus propias APIs, pero están hechas para el que vende: publicar anuncios, llevar el inventario y gestionar pedidos con cuenta y token. Esta cubre el lado del comprador. Trabaja con lo que ebay.es enseña a un visitante anónimo y lo entrega en JSON: título, precio, estado, envío y formato de compra, escritos con las palabras de la web española («Totalmente nuevo», «¡Cómpralo ya!», «o Mejor oferta»). Encaja en el seguimiento de precios de un modelo concreto, en la vigilancia del catálogo de una tienda o en comparar lo que se pide por el mismo artículo en distintos anuncios. No publica, no puja y no compra. Cada llamada necesita `"domain": "es"`, porque el dominio por defecto es el estadounidense.

Ejemplo que funciona

Esta búsqueda se hizo el 28 de octubre de 2026. De los 10 primeros resultados, 7 eran artículos fuera de España: 6 en Liechtenstein y uno en Suiza, que cobraba 30 € de envío. En la búsqueda, eBay solo escribió el país en los artículos situados en el extranjero, así que los anuncios desde España llegan sin campo `location`. Con `"location": "domestic"` la misma búsqueda devolvió 10 filas sin país, todas en España. Si el objetivo es saber cuánto paga un comprador aquí, hay que sumar el envío y tratar aparte los anuncios de fuera.

curl -X POST https://api.reefapi.com/ebay/v1/search \
  -H "x-api-key: TU_CLAVE" \
  -H "content-type: application/json" \
  -d '{"query": "bicicleta electrica", "domain": "es", "max_results": 10}'

{
  "ok": true,
  "data": {
    "query": "bicicleta electrica",
    "results": [
      {
        "item_id": "178370146261",
        "title": "Bicicleta Eléctrica Chrisson E SARGOS NUEVA",
        "price": { "raw": "550,00 EUR", "value": 550.0, "currency": "EUR" },
        "condition": "Totalmente nuevo",
        "buying_format": "o Mejor oferta",
        "buying_format_code": "best_offer",
        "shipping": "Envío gratis en 3 días",
        "url": "https://www.ebay.es/itm/178370146261",
        "best_offer": true,
        "in_stock": true
      },
      {
        "item_id": "820265054105",
        "title": "Bicicleta eléctrica de doble motor 48V 25Ah 26 pulgadas Offroad ebikes 45 km/h bicicleta eléctrica de montaña",
        "price": { "raw": "1 390,00 EUR", "value": 1390.0, "currency": "EUR" },
        "condition": "Totalmente nuevo",
        "buying_format": "o Mejor oferta",
        "buying_format_code": "best_offer",
        "shipping": "Envío gratis",
        "location": "Liechtenstein",
        ...
      },
      {
        "item_id": "860010958704",
        "title": "Bicicleta urbana - Youin Amsterdam, 250 W, 25 km/h, 45 km, Plegable, Azul/negro",
        "price": { "raw": "499,00 EUR", "value": 499.0, "currency": "EUR" },
        "condition": "Nuevo (de otro tipo)",
        "buying_format": "¡Cómpralo ya!",
        "buying_format_code": "buy_it_now",
        "shipping": "+ 1,99 EUR de envío",
        ...
      },
      {
        "item_id": "820041109514",
        "title": "Bicicleta Eléctrica Off-Road 20\" E-MountainBike HEADEER BK20 E-Bike 750W 48V 20A 80KM",
        "price": { "raw": "779,00 EUR", "value": 779.0, "currency": "EUR" },
        "condition": "Totalmente nuevo",
        "buying_format_code": "best_offer",
        "shipping": "+ 30,00 EUR de envío",
        "location": "Suiza",
        ...
      },
      ...
    ]
  },
  "meta": {
    "record_count": 10,
    "domain": "es",
    "pagination": { "page": 1, "has_more": true },
    "charged_credits": 1,
    "cache_hit": false,
    "mode": "live"
  }
}

Límites y notas honestas

• No es la API oficial de eBay. La mantenemos por nuestra cuenta: eBay no participa en ella y no existe contrato ni asociación con eBay.
• El dominio por defecto es `com`. Sin `"domain": "es"` los resultados llegan de ebay.com y en dólares.
• No hay precios de vendidos. eBay solo enseña los anuncios vendidos y finalizados a quien ha iniciado sesión (lo comprobamos el 5 de agosto de 2026), y esta API no utiliza cuentas. Un historial de precios hay que construirlo guardando con fecha las búsquedas propias sobre anuncios activos.
• `categories` no funciona en ebay.es y por eso no aparece en la tabla. El 28 de octubre de 2026 devolvió PARSE_ERROR dos veces sin filtro y NOT_FOUND con «móviles», «telefon» y «Bicicletas», sin coste. En ebay.com sí responde. El número de categoría que admite `search` se puede sacar de la URL de esa categoría en ebay.es.
• En la ficha, `brand` y `model` llegaron vacíos en las 6 fichas distintas que comprobamos, también cuando el vendedor había rellenado «Marca» y «Modelo»: esos datos están en `item_specifics`. `condition` viene normalizado en inglés (`New`), mientras que `search` da el texto de ebay.es («Nuevo (de otro tipo)»). `return_policy` fue null en esas 6 fichas.
• El bloque `seller` de la ficha llega sin reputación (`feedback_pct` y `feedback_count` en null) o directamente null. La reputación se consulta con `seller_profile`.
• `shipping.country` de la ficha no es el lugar donde está el artículo: salió `DEU` en anuncios que la búsqueda situaba en Liechtenstein, Suiza o Italia, y `USA` en otro situado en Italia. En uno de ellos el coste también difería: 20 € en la ficha frente a «+ 30,00 EUR de envío» en la búsqueda. Para el país, usa `location` de `search`.
• `deals` muestra los títulos tal como los escribió el vendedor; en nuestra llamada a ebay.es los 5 primeros estaban en inglés o en alemán.
• En anuncios con variantes (tallas, colores), eBay a veces no imprime en la tarjeta ni el formato ni el envío ni la ubicación, y esas columnas quedan vacías porque la fuente no las da.
• `items_batch` acepta como máximo 40 números; con 41 responde INVALID_PARAM sin cobrar. Se factura por artículo, 2 créditos cada uno: nuestra petición de 16 artículos costó 32 créditos y tardó 15 segundos.
• Créditos por llamada: `search` y `deals` 1 (cada llamada es una página, de hasta 240 resultados en `search`), `item_detail` y `seller_items` 2, `seller_profile` 3. Las llamadas que fallan no se cobran.