Pedir un reporte asincrónico

POST /api/marketing/insights/reports

Mismos parámetros que la consulta sincrónica (incluidos date_preset y time_increment, los dos string libre), pero para rangos o desgloses que Graph no puede responder en una sola llamada. Devuelve { report_run_id }; el avance se consulta en GET /api/marketing/insights/reports/:reportRunId y las filas en …/results. Los reportes de Meta expiran a los 30 días. Requiere scope marketing:manage.

Request body

Field	Type		Description
`ad_account_id`	string	required	Cuenta publicitaria de Meta, con prefijo. Example: `"act_123"`.
`object_id`	string	optional	Campaña, conjunto o anuncio sobre el que consultar. Si no viene, se consulta la cuenta entera.
`level`	`account` · `campaign` · `adset` · `ad`	optional	—
`date_preset`	string	optional	Rango con nombre. Es string libre: Meta valida el valor. Los de uso corriente están en `GET /api/marketing/enums` como sugerencias. Example: `"last_7d"`.
`time_range`	object	optional	Rango explícito `{"since":"YYYY-MM-DD","until":"YYYY-MM-DD"}`. En el GET viaja como JSON en el query string; en el POST puede venir como objeto.
`time_increment`	string	optional	Corte temporal de las filas. String libre: un número de días (`1`, `7`, `28`), `monthly` o `all_days`. `1` es el valor típico para una serie diaria. Si no se manda, Graph agrega todo el rango en una sola fila. Example: `"1"`.
`fields`	string	optional	Métricas separadas por coma. Por defecto: `impressions,clicks,spend,reach,frequency,cpc,cpm,ctr,actions,cost_per_action_type,date_start,date_stop`.
`breakdowns`	string	optional	Desgloses separados por coma, p. ej. `age,gender`.
`action_breakdowns`	string	optional	Desgloses de acciones separados por coma.

Responses

Status	Description	Schema
`200`	—	—

Example

curl -X POST https://api.neike.dev/api/marketing/insights/reports \
  -H "x-neike-api-key: whk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
       "ad_account_id": "act_123"
     }'