https://api.nexscope.ai/ebay/searchEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/ebay/search |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | opcional | Palabras clave de búsqueda, máximo 1024 caracteres |
ebayDomain | string | opcional | eBay nombre de dominio del sitio. Valores opcionales: `ebay.com` (Estados Unidos), `ebay.co.uk` (UK), `ebay.de` (Alemania), `ebay.fr` (Francia), `ebay.it` (Italia), `ebay.es` (España), `ebay.ca` (Canadá), `ebay.com.au` (Australia) ), `ebay.nl` (Países Bajos), `ebay.at` (Austria), `ebay.ch` (Suiza), `ebay.pl` (Polonia), `ebay.ie` (Irlanda), `ebay.com.hk` (Hong Kong, China), `ebay.com.my` (Malasia), `ebay.com.sg` (Singapur) |
page | integer | opcional | Número de página, utilizado para la paginación Ejemplo: 1 |
pageSize | integer | opcional | El número máximo de resultados devueltos por página. Valores opcionales: `25`, `50`, `100`, `200` Ejemplo: 50 |
orderBy | string | opcional | Ordenar por. Valores opcionales: `1` (pronto hasta el final), `2` (precio más bajo), `3` (precio más alto), `7` (más cercano), `10` (último en los estantes), `12` (mejor partido), `15` (precio más bajo + comisión de envío), `16` (precio más alto + gastos de envío), `18` (primero el nuevo producto), `19` (prioridad de segunda mano) Ejemplo: 12 |
priceMin | number | opcional | Filtro de precio más bajo |
priceMax | number | opcional | Filtro de precio más alto |
itemCondition | string | opcional | Código de estado del producto, múltiple separado por `\|`. Valores opcionales: `1000` (nuevo), `1500` (nuevo otro), `1750` (nuevo con defectos), `2000` (rehabilitado oficialmente), `2010` (excelentemente reformado), `2020` (Buena renovación), `2030` (Rehabilitado en general), `2500` (Reformado del vendedor), `2750` (Casi nuevo), `3000` (Segunda mano/utilizada), `7000` (Accesorio o no funciona) |
buyingFormat | string | opcional | Formato de compra. Valores opcionales: `Auction` (supresión), `BIN` (precio fijo), `BO` (mejor oferta) |
showOnly | string | opcional | Condiciones de filtro, múltiples valores separados por comas. Valores opcionales: `Complete` (Fin), `Sold` (Vendido), `FR` (Retornos libres), `RPA` (Regresos aceptados), `AS` (Vendedor autorizado), `Savings` (descuento), `SaleItems` (artículos promocionales), `Lots` (bulk), `Charity` (caridad), `AV`, `FS` (libre envío), `LPickup` (auto-recogida) |
location | integer | opcional | Código del país/región donde se encuentra el producto, por ejemplo: `1` (Estados Unidos), `2` (Canadá), `3` (UK), `45` (China), `77` (Alemania) |
prefLoc | string | opcional | Rango de ubicación preferido. Valores opcionales: `1` (nacional), `2` (regional), `3` (mundial) |
zipCode | string | opcional | Código postal o postal para filtrar productos para su entrega por área |
categoryId | integer | opcional | eBay ID de categoría, utilizado para buscar categorías especificadas |
noCache | boolean | opcional | Deshabilitar el almacenamiento en caché Ejemplo: false |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (27 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número total de resultados coincidentes |
products | array | opcional | Lista de productos (ver campos de productos más abajo para más detalles) |
columns | array | opcional | Definiciones de columna renderizadas |
type | string | opcional | Identificador de estilo de renderizado |
costToken | integer | opcional | Consumir token |
productId | string | opcional | eBay ID del elemento |
title | string | opcional | Título del producto |
subtitle | string | opcional | Subtítulo del producto |
price | number | opcional | Precio actual/precio de transacción |
minPrice | number | opcional | Valor de partida de la gama de precios (aplicable a productos de especificaciones múltiples) |
maxPrice | number | opcional | Valor final de la gama de precios (aplicable a productos de múltiples especificaciones) |
oldPrice | number | opcional | Precio original antes del descuento |
currency | string | opcional | Unidades monetarias como USD, GBP, EUR |
condition | string | opcional | Descripción del estado del producto |
link | string | opcional | eBay detalle del producto enlace de la página |
imageUrl | string | opcional | Producto en miniatura URL |
shipping | string | opcional | Información sobre el envío |
location | string | opcional | Ubicación del producto |
sellerName | string | opcional | Nombre del vendedor |
sellerReviews | integer | opcional | Número de comentarios de los vendedores |
positiveFeedbackInPercentage | number | opcional | Calificación positiva del vendedor |
salesQuantity | integer | opcional | Cantidad vendida |
bidsCount | integer | opcional | Cantidad de ofertas (artículos de subasta) |
returns | string | opcional | Información de devolución |
promotion | string | opcional | Información de promoción |
sponsored | boolean | opcional | ¿Es un producto patrocinado/promocionado? |
sourceType | string | opcional | Identificación de la plataforma de fuentes (`ebay`) |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.