API de Detalles del producto de eBay
Salud de la API
- Salud 24 h
- Normal
- Tiempo medio 24 h
- —
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
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
| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | 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. |
platform | body | string | Sí | ebay | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | product_detail | Identificador de la capacidad, valor fijo. |
url | body.params | string | Sí | - | 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
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
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.
{
"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.
| Campo | Significado |
|---|---|
item_id | Conserva el significado de la plataforma |
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
subtitle | Subtítulo que escribió el vendedor (product_detail), a menudo promocional; no aparece si no lo hay. |
url | Enlace al registro en la plataforma. |
price | Precio como número, sin símbolo de moneda; ver currency. |
currency | Código de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda. |
condition | Conserva el significado de la plataforma |
availability | Estado de existencias tal como lo indica eBay (product_detail), como InStock u OutOfStock. |
listing_type | Conserva el significado de la plataforma |
bid_count | Pujas realizadas hasta ahora (product_detail), solo en subastas. |
best_offer_enabled | Si se puede hacer una oferta al vendedor (Best Offer) (product_detail). |
ends_at | Cuá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_available | Unidades aún disponibles (product_detail); no aparece si el vendedor no lo muestra. |
quantity_sold | Unidades vendidas en este anuncio (product_detail); no aparece si no se muestra. |
watchers | Personas que siguen el anuncio (product_detail); no aparece si eBay no lo muestra. |
brand | Conserva el significado de la plataforma |
model | Conserva el significado de la plataforma |
mpn | Número de pieza del fabricante (product_detail). |
gtin | Código de barras GTIN, UPC o EAN (product_detail). |
product_id | ID de producto del catálogo de eBay (product_detail); no aparece si el anuncio no lo muestra. |
categories | Ruta de categorías de la más amplia a la más concreta (product_detail). |
image_url | Enlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls. |
images | Lista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes. |
item_location | Desde dónde se envía el artículo, tal como lo muestra eBay (product_detail). |
shipping_price | Conserva el significado de la plataforma |
free_shipping | Si el envío es gratuito (product_detail). |
returns_accepted | Si el vendedor acepta devoluciones (product_detail). |
seller | Conserva el significado de la plataforma |
seller_url | Enlace a la página de tienda del vendedor (product_detail). |
seller_feedback_score | Conserva el significado de la plataforma |
seller_positive_percent | Conserva el significado de la plataforma |
updated_at | Última actualización de este registro del anuncio (product_detail), en ISO 8601 y UTC. |
platform | Identificador 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.