Refresh insights
Force-refreshes the report for one (platform, adAccountId, date window) — the window is the datePreset or a custom startDate+endDate range. Returns 202 immediately — the fresh fetch runs asynchronously. After calling this, poll Fetch ad insights and watch status: PENDING → COMPLETED (or FAILED with a message explaining what broke). Only the main report window is refreshed. Period-over-period windows (popRangeType) use their own cache and are refreshed when they expire. At most one successful refresh per (platform, adAccountId, date window) every 15 minutes is allowed. Extra calls return 429 with a Retry-After header. If the refresh fails before any work is done (e.g. the platform rejects it), you can retry once you fix the underlying issue.
Authentication
authentication Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.adnova.ai/analytics/v1/refresh" \ -H "Content-Type: application/json" \ -d '{ "platform": "facebook", "adAccountId": "01JAN78QQ6BX9ZPKA6A8JWA6G1", "workspaceId": "01JF0X2QDQ648YE4J1M56EFBR4", "datePreset": "last_7d" }'{
"refreshStatus": "REFRESH_QUEUED",
"nextRefreshAllowedInSeconds": 0
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"message": "string",
"retryAfterSeconds": 0
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}