https://api.nexscope.ai/api/skill-api/v1/skills/amazon-ads-sp-search-impression-share-report/runEjecutar 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/api/skill-api/v1/skills/amazon-ads-sp-search-impression-share-report/run |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Guía de operaciones de Amazon Ads
El flujo de información de Sponsored Products usa un connectionId que te pertenezca: crea un informe, consúltalo mediante reportId y descarga las partes CSV completadas con el documentToken devuelto por el backend. El perfil y la región se obtienen de la conexión autorizada.
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
connectionId | integer | obligatorio | Propiedad de Amazon Ads ID de conexión; perfil y región se resuelven por el motor. Ejemplo: 123 |
startDate | string | obligatorio | Fecha de inicio del informe inclusivo en AAAA-MM-DD. Ejemplo: 2026-08-01 |
endDate | string | obligatorio | Fecha de AAAA-MM-DD inclusiva, no después de hoy o antes startDate. Ejemplo: 2026-08-07 |
advertiserAccountId | string | opcional | Opcionalmente, el ID explícito de la cuenta de recuperación; omitido significa asignación única del perfil autorizado. |
timeUnit | string | opcional | DIARIO o RESUMEN; por defecto DIARIO. |
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": {
"reportId": "report-id",
"status": "PENDING",
"completedReportParts": [],
"reportParts": []
},
"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 reportId
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.completedReportParts | array | opcional | Completed CSV parts; each part contains a backend documentToken instead of a signed URL. Ejemplo: [] |
data.costTime | integer | opcional | Execution time reported by the upstream provider. Ejemplo: null |
data.costToken | integer | opcional | Token cost reported by the upstream provider. Ejemplo: null |
data.dataSnapshotMonth | string | opcional | Data snapshot month returned by the upstream provider. Ejemplo: null |
data.page | integer | opcional | Current page returned by the upstream provider. Ejemplo: null |
data.pageItemCount | integer | opcional | Item count on the current page returned by the upstream provider. Ejemplo: null |
data.pageSize | integer | opcional | Page size returned by the upstream provider. Ejemplo: null |
data.reportId | string | obligatorio | Created or queried report identifier. Ejemplo: report-id |
data.reportParts | array | opcional | Provider alias for completed parts, when present. Ejemplo: [] |
data.sourceTool | string | opcional | Provider-specific source tool name. Ejemplo: null |
data.sourceType | string | opcional | Provider-specific source platform type. Ejemplo: null |
data.status | string | opcional | Provider report state when present. Ejemplo: PENDING |
data.title | string | opcional | Provider-specific response title. Ejemplo: null |
data.totalPage | integer | opcional | Total page count returned by the upstream provider. Ejemplo: null |
data.type | string | opcional | Provider-specific render or payload type. Ejemplo: null |
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.