API de plataforma de EveryData

API de eBay

Q: ¿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.

Q: ¿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 de origen contengan un valor.

Q: ¿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.

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.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 4
Por 1.000: 1,389 US$

Funciones disponibles

Compara las acciones de eBay por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

Acción	Obligatorios	Opcionales	Entrega	Límite	Por 1.000	Campos de respuesta
`search` Buscar anuncios en eBay 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.	keyword	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
`store` Consultar artículos de una tienda 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.	seller	min_price, 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
`reviews` Leer opiniones de vendedor y producto 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.	seller, item_id	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
`sold` Analizar anuncios vendidos 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.	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é 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.

¿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 search o para artículos finalizados o vendidos en sold. El cálculo del precio es diferente en cada caso; no tomes el precio del anuncio como el precio de venta final.
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. En sold, 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. Usa true para solicitar solo artículos vendidos o false para no activar el filtro. Debes usar un valor booleano de JSON, no la cadena de texto false. Este parámetro no garantiza que el importe final de la transacción haya sido verificado de forma independiente.

¿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 store busca la lista de artículos por vendedor. reviews requiere el item_id del mismo vendedor para consultar las valoraciones de la transacción del comprador.
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. En sold, 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.
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ón store debe incluir igualmente el parámetro obligatorio seller.
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. Para reviews, si envías una página de valoraciones que contenga /fdbk/, se usará directamente. Aunque envíes una URL, debes proporcionar igualmente los parámetros seller e item_id requeridos por esta API.
usernameOpcional: Parámetro compatible con seller en store y reviews. Representa el nombre de la cuenta del vendedor de eBay. seller tiene 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 store busca la lista de artículos por vendedor. reviews requiere el item_id del mismo vendedor para consultar las valoraciones de la transacción del comprador.
eBay: perfil de feedback de una transaccióneBay 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 2026-09-04
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 con seller. No es un ID de catálogo de producto genérico ni el ID de una valoración individual.
product_idOpcional: Parámetro compatible con item_id. Su valor es el ID del artículo de eBay. La acción reviews requiere igualmente que incluyas el item_id en la petición pública.
qOpcional: Parámetro compatible con item_id en reviews. Representa el ID del artículo, no es un término de búsqueda. Para buscar artículos, usa keyword; no puedes usar q aquí 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. Para reviews, si envías una página de valoraciones que contenga /fdbk/, se usará directamente. Aunque envíes una URL, debes proporcionar igualmente los parámetros seller e item_id requeridos por esta API.
usernameOpcional: Parámetro compatible con seller en store y reviews. Representa el nombre de la cuenta del vendedor de eBay. seller tiene 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 search o para artículos finalizados o vendidos en sold. 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. Esta API no declara un rango válido más específico, por lo que no se puede garantizar 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. En sold, 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, como ebay.com (por defecto) o ebay.co.uk. Es un parámetro diferente al domain que usan search, store y reviews. La moneda del precio depende del registro devuelto.
sortOpcional: Orden para sold: newest para los finalizados más recientemente o distance para 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. La ubicación de referencia para el orden por distancia no está especificada explícitamente en esta API.
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 devuelto si la acción es asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

ebay_search.sh

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 de origen contengan 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.

1688 API AliExpress API Amazon API Craigslist API Etsy API Shopee API Taobao API Temu API Ver el catálogo público →