API de eBay
Busca anuncios de eBay, revisa artículos de una tienda, opiniones asociadas y ventas cerradas. Vendedor, item ID y URL cumplen funciones distintas según el objeto consultado.
Precio del artículo, envío y total vendido deben conservarse por separado. Un anuncio marcado como vendido es una observación del mercado, no ingresos netos ni demanda futura.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de eBay, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar anuncios en eBaysearch | Busca anuncios de eBay con keyword, precio mínimo y opción de vendidos. | $1.39 por 1.000 solicitudes | Normal |
Consultar artículos de una tiendastore | Consulta artículos de una tienda mediante seller, aceptando alias como store, username o url en su contexto compatible. | $1.39 por 1.000 solicitudes | Normal |
Leer opiniones de vendedor y productoreviews | Lee opiniones vinculadas al par obligatorio seller e item_id; los identificadores compatibles ayudan a resolver la misma ficha. | $1.39 por 1.000 solicitudes | Normal |
Analizar anuncios vendidossold | Busca ventas cerradas por keyword y permite acotar días, sitio, precio u orden. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de eBay?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar anuncios en eBay Busca anuncios de eBay con | keyword | condition, country, domain, max_price, min_price, sold_only | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
storeConsultar artículos de una tienda Consulta artículos de una tienda mediante | seller | country, domain, store, url, username | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
reviewsLeer opiniones de vendedor y producto Lee opiniones vinculadas al par obligatorio | seller, item_id | country, domain, product_id, q, seller_name, url, username | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | text · rating · rating_scale · username · submitted_at · seller_reply · image_count · reviewer_feedback_score · reviewer_feedback_star · product_name · product_id · product_price · platform · image_url · images |
soldAnalizar anuncios vendidos Busca ventas cerradas por | keyword | days, min_price, site, sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · name · sold_price · shipping_price · total_price · currency · sold_at · condition · listing_type · best_offer_accepted · category · seller_username · seller_feedback_score · seller_positive_percent · image_url · platform |
¿Qué significan los parámetros de eBay search?
Busca anuncios de eBay con keyword, precio mínimo y opción de vendidos. Distingue precio, envío, condición y vendedor; sold_only selecciona anuncios observados como vendidos, no calcula volumen total de mercado.
keywordObligatorio- Término de búsqueda para artículos en venta en
searcho para artículos finalizados o vendidos ensold. El cálculo del precio es diferente en cada caso; no tomes el precio del anuncio como el precio de venta final. conditionOpcional- Estado del artículo para
search. Conserva las mayúsculas y los espacios:New,Used,RefurbishedoFor parts or not working. No es un filtro de reseñas positivas o negativas. countryOpcional- Entrada compatible con
domain; también recibe un dominio de eBay comoebay.com, no un código de país comoUSoDE. Si se proporcionan ambos,domaintiene prioridad. domainOpcional- Dominio del sitio local de eBay, como
ebay.com,ebay.deoebay.co.uk, sin protocolo ni ruta. El valor por defecto esebay.com;search,storeyreviewslo usan para construir la página. max_priceOpcional- Precio máximo del artículo para
search. Es un valor numérico y se usa conmin_price; no presupone que el envío o los impuestos estén incluidos. min_priceOpcional- Precio mínimo del artículo. Es un valor numérico. En
search, se refiere al precio en los anuncios de búsqueda. Ensold, se refiere al precio en los anuncios finalizados o vendidos. La moneda depende del sitio y del registro, no es el importe de facturación de esta API. sold_onlyOpcional- Parámetro booleano para
search. Usatruepara solicitar solo artículos vendidos ofalsepara no activar el filtro. Debes usar un valor booleano de JSON, no la cadena de textofalse.
¿Qué significan los parámetros de eBay store?
Consulta artículos de una tienda mediante seller, aceptando alias como store, username o url en su contexto compatible. Devuelve fichas de artículos, no el saldo, reputación privada o inventario interno del vendedor.
sellerObligatorio- Nombre de la cuenta del vendedor de eBay, no el nombre público de la tienda ni el de la empresa. La acción
storebusca la lista de artículos por vendedor.reviewsrequiere elitem_iddel mismo vendedor para consultar las valoraciones de la transacción del comprador. countryOpcional- Entrada compatible con
domain; también recibe un dominio de eBay comoebay.com, no un código de país comoUSoDE. Si se proporcionan ambos,domaintiene prioridad. domainOpcional- Dominio del sitio local de eBay, como
ebay.com,ebay.deoebay.co.uk, sin protocolo ni ruta. El valor por defecto esebay.com;search,storeyreviewslo usan para construir la página. storeOpcional- Parámetro compatible con
seller. Se refiere al nombre de la cuenta del vendedor, no a un título de tienda arbitrario. La acciónstoredebe incluir igualmente el parámetro obligatorioseller. urlOpcional- Para
store, puedes enviar la URL de una tienda o de la lista de artículos de un vendedor de eBay para sustituir la dirección que se genera automáticamente. Parareviews, si envías una página de valoraciones que contenga/fdbk/, se usará directamente. Aunque envíes una URL, debes proporcionar igualmente los parámetrossellereitem_idrequeridos por esta API. usernameOpcional- Parámetro compatible con
sellerenstoreyreviews. Representa el nombre de la cuenta del vendedor de eBay.sellertiene prioridad y sigue siendo obligatorio en la petición pública. No es el nombre de usuario del comprador ni del autor de la valoración.
¿Qué significan los parámetros de eBay reviews?
Lee opiniones vinculadas al par obligatorio seller e item_id; los identificadores compatibles ayudan a resolver la misma ficha. Conserva respuesta del vendedor y producto, sin prometer todo el historial de feedback.
sellerObligatorio- Nombre de la cuenta del vendedor de eBay, no el nombre público de la tienda ni el de la empresa. La acción
storebusca la lista de artículos por vendedor.reviewsrequiere elitem_iddel mismo vendedor para consultar las valoraciones de la transacción del comprador.eBay: perfil de feedback de una transacción — eBay separa el feedback positivo, neutro o negativo y el comentario breve asociado a una transacción. Ese perfil no es lo mismo que una reseña de producto de cinco estrellas, por lo que ambas medidas no deben mezclarse. · Consultada item_idObligatorio- ID del artículo de eBay para la acción
reviews. Suele ser el número que aparece en la URL/itm/del artículo. Se usa junto conseller. No es un ID de catálogo de producto genérico ni el ID de una valoración individual. countryOpcional- Entrada compatible con
domain; también recibe un dominio de eBay comoebay.com, no un código de país comoUSoDE. Si se proporcionan ambos,domaintiene prioridad. domainOpcional- Dominio del sitio local de eBay, como
ebay.com,ebay.deoebay.co.uk, sin protocolo ni ruta. El valor por defecto esebay.com;search,storeyreviewslo usan para construir la página. product_idOpcional- Parámetro compatible con
item_id. Su valor es el ID del artículo de eBay. La acciónreviewsrequiere igualmente que incluyas elitem_iden la petición pública. qOpcional- Parámetro compatible con
item_idenreviews. Representa el ID del artículo, no es un término de búsqueda. Para buscar artículos, usakeyword; no puedes usarqaquí como palabra clave. seller_nameOpcional- Nombre de la cuenta del vendedor.
urlOpcional- Para
store, puedes enviar la URL de una tienda o de la lista de artículos de un vendedor de eBay para sustituir la dirección que se genera automáticamente. Parareviews, si envías una página de valoraciones que contenga/fdbk/, se usará directamente. Aunque envíes una URL, debes proporcionar igualmente los parámetrossellereitem_idrequeridos por esta API. usernameOpcional- Parámetro compatible con
sellerenstoreyreviews. Representa el nombre de la cuenta del vendedor de eBay.sellertiene prioridad y sigue siendo obligatorio en la petición pública. No es el nombre de usuario del comprador ni del autor de la valoración.
¿Qué significan los parámetros de eBay sold?
Busca ventas cerradas por keyword y permite acotar días, sitio, precio u orden. sold_price, envío y fecha pertenecen al anuncio observado; no estiman ingresos netos ni demanda futura.
keywordObligatorio- Término de búsqueda para artículos en venta en
searcho para artículos finalizados o vendidos ensold. El cálculo del precio es diferente en cada caso; no tomes el precio del anuncio como el precio de venta final. daysOpcional- Número de días de antigüedad para
sold. Es un entero con valor por defecto de 30. No es el número de días que el artículo estuvo anunciado ni el número de resultados devueltos. No se garantiza que existan registros completos para cualquier número de días. min_priceOpcional- Precio mínimo del artículo. Es un valor numérico. En
search, se refiere al precio en los anuncios de búsqueda. Ensold, se refiere al precio en los anuncios finalizados o vendidos. La moneda depende del sitio y del registro, no es el importe de facturación de esta API. siteOpcional- Dominio del sitio local de eBay usado por
sold, comoebay.com(por defecto) oebay.co.uk. Es un parámetro diferente aldomainque usansearch,storeyreviews. La moneda del precio depende del registro devuelto. sortOpcional- Orden para
sold:newestpara los finalizados más recientemente odistancepara los más cercanos. No es la fecha de publicación más reciente del artículo. Si se omite, se usa el orden de finalización más reciente.Valores permitidos:distancenewest
Cómo usar la API de eBay
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"ebay","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de eBay
¿Cómo llamo a la API de eBay?
Envía POST /api/v1/social con platform igual a ebay, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de eBay?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye item_id, title, price y price_text. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de eBay?
eBay separa el feedback positivo, neutro o negativo y el comentario breve asociado a una transacción. Ese perfil no es lo mismo que una reseña de producto de cinco estrellas, por lo que ambas medidas no deben mezclarse.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; store requiere seller; reviews requiere seller e item_id; consulta las demás acciones en la lista de funciones.
¿Las acciones de eBay responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.