Nuestras estadísticas de visitas propias están siempre activas. Google Analytics, que nos ayuda a entender cómo se usan nuestras páginas públicas (no tu espacio de trabajo con sesión iniciada), solo se activa con tu permiso. Consulta nuestra Política de privacidad.

API de Detalles del producto de eBay

POST

Salud de la API

Salud 24 h
Normal
Tiempo medio 24 h
—
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Lee un anuncio de eBay completo a partir de su enlace o de su ID numérico: precio, condición, disponibilidad, tipo de anuncio, opción de oferta, envío y devoluciones, observadores, marca y códigos de catálogo, ruta de categorías, todas las imágenes y la puntuación y el porcentaje positivo del vendedor. bid_count, ends_at, gtin y otros campos solo aparecen si el anuncio los muestra.

Precio $0.96 por 1.000 solicitudes ($0.000958 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Prompt para IA

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra eBay: Detalles del producto (ebay/product_detail).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en ebay y action en product_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
  - url: Un anuncio de eBay: su enlace, como https://www.ebay.com/itm/133576802017 (se quitan los parámetros de seguimiento y el título), o solo el ID numérico, que se lee en ebay.com.
- Devuelve un objeto. Campos principales: item_id, title, subtitle (Subtítulo que escribió el vendedor (pro…), url, price, currency, condition, availability (Estado de existencias tal como lo indic…), listing_type, bid_count (Pujas realizadas hasta ahora (product_d…), best_offer_enabled (Si se puede hacer una oferta al vendedo…), ends_at (Cuándo termina la subasta o el anuncio…); 32 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=ebay.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "ebay",
  "action": "product_detail",
  "params": {
    "url": "https://www.ebay.com/itm/133576802017"
  }
}
- Precio: $0.96 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíebayIdentificador de la plataforma, valor fijo.
actionbodystringSíproduct_detailIdentificador de la capacidad, valor fijo.
urlbody.paramsstringSí-Un anuncio de eBay: su enlace, como https://www.ebay.com/itm/133576802017 (se quitan los parámetros de seguimiento y el título), o solo el ID numérico, que se lee en ebay.com. Los enlaces de otros sitios de eBay se leen en ese sitio y con su moneda. Las páginas de tienda, de búsqueda y las listas se rechazan antes de ejecutar la llamada.

Ejemplos de código

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "ebay",
  "action": "product_detail",
  "params": {
    "url": "https://www.ebay.com/itm/133576802017"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

Vista previa de campos

Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.

json
{
  "id": "req_…",
  "platform": "ebay",
  "action": "product_detail",
  "results": {
    "item_id": …,
    "title": …,
    "subtitle": …,
    "url": …,
    "price": …,
    "currency": …,
    "condition": …,
    "availability": …,
    "listing_type": …,
    "bid_count": …,
    "best_offer_enabled": …,
    "ends_at": …,
    "quantity_available": …,
    "quantity_sold": …,
    "watchers": …,
    "brand": …,
    "model": …,
    "mpn": …,
    "gtin": …,
    "product_id": …,
    "categories": …,
    "image_url": …,
    "images": …,
    "item_location": …,
    "shipping_price": …,
    "free_shipping": …,
    "returns_accepted": …,
    "seller": …,
    "seller_url": …,
    "seller_feedback_score": …,
    "seller_positive_percent": …,
    "updated_at": …,
    "platform": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Campos de la respuesta

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
item_idConserva el significado de la plataforma
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
subtitleSubtítulo que escribió el vendedor (product_detail), a menudo promocional; no aparece si no lo hay.
urlEnlace al registro en la plataforma.
pricePrecio como número, sin símbolo de moneda; ver currency.
currencyCódigo de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda.
conditionConserva el significado de la plataforma
availabilityEstado de existencias tal como lo indica eBay (product_detail), como InStock u OutOfStock.
listing_typeConserva el significado de la plataforma
bid_countPujas realizadas hasta ahora (product_detail), solo en subastas.
best_offer_enabledSi se puede hacer una oferta al vendedor (Best Offer) (product_detail).
ends_atCuándo termina la subasta o el anuncio con plazo (product_detail), en ISO 8601 y UTC; no aparece en anuncios de precio fijo sin fecha de fin.
quantity_availableUnidades aún disponibles (product_detail); no aparece si el vendedor no lo muestra.
quantity_soldUnidades vendidas en este anuncio (product_detail); no aparece si no se muestra.
watchersPersonas que siguen el anuncio (product_detail); no aparece si eBay no lo muestra.
brandConserva el significado de la plataforma
modelConserva el significado de la plataforma
mpnNúmero de pieza del fabricante (product_detail).
gtinCódigo de barras GTIN, UPC o EAN (product_detail).
product_idID de producto del catálogo de eBay (product_detail); no aparece si el anuncio no lo muestra.
categoriesRuta de categorías de la más amplia a la más concreta (product_detail).
image_urlEnlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
imagesLista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
item_locationDesde dónde se envía el artículo, tal como lo muestra eBay (product_detail).
shipping_priceConserva el significado de la plataforma
free_shippingSi el envío es gratuito (product_detail).
returns_acceptedSi el vendedor acepta devoluciones (product_detail).
sellerConserva el significado de la plataforma
seller_urlEnlace a la página de tienda del vendedor (product_detail).
seller_feedback_scoreConserva el significado de la plataforma
seller_positive_percentConserva el significado de la plataforma
updated_atÚltima actualización de este registro del anuncio (product_detail), en ISO 8601 y UTC.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores