https://api.nexscope.ai/woocommerce/productReviewsEjecutar 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/woocommerce/productReviews |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
storeUrl | string | obligatorio | Público HTTPS tienda raíz o WordPress ruta de instalación. Ejemplo: https://example.com |
pageNum | integer | opcional | Número de página, por defecto 1. Ejemplo: 1 |
pageSize | integer | opcional | Tamaño de página, por defecto 20, máximo 100. Ejemplo: 20 |
productId | string | opcional | Sólo opiniones de este producto. Productos bloqueados no devuelven opiniones públicas. Ejemplo: 34 |
categoryId | string | opcional | Restricción a una categoría de producto pública. Ejemplo: 16 |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"cost": "-1",
"data": {
"cacheHit": false,
"fetchedAt": "1792972800000",
"hasMore": false,
"pageNum": 1,
"pageSize": 20,
"reviews": [
{
"createdAt": "1792972800000",
"id": "83",
"productId": "34",
"productName": "Public review",
"productUrl": "https://example.com/product/shirt",
"rating": 5,
"review": "Public review",
"reviewer": "Public review",
"verified": true
}
],
"storeUrl": "https://example.com",
"total": 1,
"totalPages": 1
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 means accepted or successful; nonzero is a platform error. |
cost | string | obligatorio | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Epoch milliseconds. |
Opción 1 de cualquier alternativa — requiere storeUrl, fetchedAt, cacheHit, reviews, pageNum, pageSize
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.cacheHit | boolean | obligatorio | Whether the response was served from the anonymous 60-second cache. Ejemplo: false |
data.fetchedAt | string | obligatorio | Fetch time in epoch milliseconds; preserved on cache hits. Ejemplo: 1792972800000 |
data.hasMore | any | opcional | Valor de Has more usado por esta operación de API. |
data.pageNum | integer | obligatorio | Pagination metadata; omitted upstream totals become null. Ejemplo: 1 |
data.pageSize | integer | obligatorio | Pagination metadata; omitted upstream totals become null. Ejemplo: 20 |
data.reviews | array | obligatorio | Normalized public data. Missing optional values are null or empty strings. Ejemplo: [] |
data.reviews[] | object | obligatorio | Elemento de data reviews. |
data.reviews[].createdAt | any | opcional | Valor de Created at usado por esta operación de API. |
data.reviews[].id | string | obligatorio | Public review identifier or plain text; no reviewer email or private fields are exposed. Ejemplo: 83 |
data.reviews[].productId | string | obligatorio | Public review identifier or plain text; no reviewer email or private fields are exposed. Ejemplo: 34 |
data.reviews[].productName | string | obligatorio | Public review identifier or plain text; no reviewer email or private fields are exposed. Ejemplo: Public review |
data.reviews[].productUrl | string | obligatorio | Public review identifier or plain text; no reviewer email or private fields are exposed. Ejemplo: https://example.com/product/shirt |
data.reviews[].rating | integer | obligatorio | Rating from 0 (unrated) to 5. Ejemplo: 5 |
data.reviews[].review | string | obligatorio | Public review identifier or plain text; no reviewer email or private fields are exposed. Ejemplo: Public review |
data.reviews[].reviewer | string | obligatorio | Public review identifier or plain text; no reviewer email or private fields are exposed. Ejemplo: Public review |
data.reviews[].verified | any | opcional | Valor de Verified usado por esta operación de API. |
data.storeUrl | string | obligatorio | Normalized store identity. Ejemplo: https://example.com |
data.total | any | opcional | Valor de Total usado por esta operación de API. |
data.totalPages | any | opcional | Valor de Total pages usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.hasMore | boolean | opcional | Null when upstream total pages are unavailable. Ejemplo: false |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.hasMore | null | opcional | Valor de Has more usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.reviews[].createdAt | string | opcional | UTC creation time in epoch milliseconds, null when unavailable. Ejemplo: 1792972800000 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.reviews[].createdAt | null | opcional | Valor de Created at usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.reviews[].verified | boolean | opcional | Verified purchase status, null when unavailable. Ejemplo: true |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.reviews[].verified | null | opcional | Valor de Verified usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.total | integer | opcional | Pagination metadata; omitted upstream totals become null. Ejemplo: 1 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.total | null | opcional | Valor de Total usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.totalPages | integer | opcional | Pagination metadata; omitted upstream totals become null. Ejemplo: 1 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.totalPages | null | opcional | Valor de Total pages usado por esta operación de API. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.