Búsqueda
Busca productos o resuelve un enlace de marketplace pegado.
GET /api/v1/search requiere un token bearer. Usa la misma lógica de búsqueda que la tienda y la app, sin escribir el historial del cliente ni de visitas.
curl --get https://www.ninjabuy.com/api/v1/search \
-H "Authorization: Bearer $NINJABUY_ACCESS_TOKEN" \
--data-urlencode "q=hoodie" \
--data-urlencode "provider=taobao" \
--data-urlencode "page=0"Parámetros de consulta
| Parámetro | Reglas |
|---|---|
q | Obligatorio, sin espacios en los extremos. Palabras clave: de 2 a 120 caracteres. Enlaces pegados: hasta 2.048 caracteres. |
provider | taobao (predeterminado) o a1688. |
page | Entero desde 0 hasta 20, comenzando en cero; predeterminado: 0. |
Envía cada parámetro una sola vez. Los parámetros no válidos o repetidos devuelven 400 con el problema bad-body.
Tipos de respuesta
Cada respuesta exitosa tiene kind y request_id.
kind | Campos y significado |
|---|---|
products | Resultados por palabras clave: items, page, pageSize, totalCount, maximumPageCount y unread (un objeto con el host de un enlace pegado que no se pudo leer; en otros casos, null). |
product | Un producto: handle y url en la tienda. Un enlace pegado o una búsqueda por identificador de artículo pueden resolver directamente a este tipo. |
vendor | Una tienda resuelta: vendor. |
sheet | Una hoja de Google reconocida: sheetId y gid, que puede ser null; sin contenido de la hoja. |
unsupported | Un enlace reconocido pero no compatible: link con marketplace e id. |
Cada elemento de products contiene handle, url en la tienda, title, price: { amount, currency: "CNY" }, image (puede ser null) y marketplace (taobao o a1688). amount es una cadena decimal en yuanes chinos, igual que en la cuadrícula de la tienda. Las URL de búsqueda son URL de productos normales; usa Enlaces para crear enlaces con atribución.
Consumo y límites de solicitudes
Los enlaces pegados usan el resolvedor anónimo y no pueden contratar un desbloqueo de pago de Bright Data. Los enlaces reconocidos de productos, tiendas, hojas y sitios no compatibles omiten la búsqueda por palabras clave. Un enlace pegado que no se pudo leer puede pasar a la búsqueda por palabras clave y consumir cuota de búsqueda de OT.
Las búsquedas por palabras clave tienen su propio límite de 30 llamadas por cuenta cada 60 segundos, independiente de las llamadas de creación de enlaces. Las respuestas exitosas que llegan a la admisión de búsqueda por palabras clave y los rechazos por límite de búsqueda incluyen:
RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60Un rechazo devuelve 429, el problema search-rate-limited y Retry-After en segundos. Los enlaces pegados resueltos no consumen ninguna ventana ni incluyen encabezados de límite de búsqueda. Cada respuesta incluye X-Request-Id y Cache-Control: no-store. Consulta Límites de solicitudes para los campos de los encabezados.