Fetch ad insights
Returns ad performance for one ad account over a date range. You can get flat rows (one per ad, or one per aggregation dimension) or grouped rows (one per segment you define via filterGroups), optionally compared against a prior period — either a preset window via popRangeType or a custom window via popStartDate + popEndDate. The response includes platform metrics (spend, impressions, etc.), Adnova-computed metrics (ROAS, etc.), and any custom metrics or custom conversions defined on this ad account. By default you get the platform's standard metric set; pass requestedMetrics to choose a subset by id. Metric ids live in the metrics catalog. AI tag ids (for aiTags filters) live in List AI tags. Naming-convention ids (for namingConvention filters) live in Get naming convention. If the underlying report is not ready yet, the response status is PENDING with a retryAfterSeconds hint — poll the same endpoint until you see COMPLETED. To force an immediate re-fetch, call Refresh insights first.
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
curl -X POST "https://api.adnova.ai/analytics/v1/insights" \ -H "Content-Type: application/json" \ -d '{ "platform": "facebook", "adAccountId": "01JAN78QQ6BX9ZPKA6A8JWA6G1", "workspaceId": "01JF0X2QDQ648YE4J1M56EFBR4", "datePreset": "last_7d", "groupBy": "name" }'{
"status": "COMPLETED",
"lastReportGeneratedTime": "string",
"message": "string",
"retryAfterSeconds": 0,
"insights": [
{
"creativeKey": "string",
"ad": {},
"insights": {},
"firstPartyIntegrations": {},
"adBreakdown": [
{
"creativeKey": "string",
"ad": {},
"insights": {},
"firstPartyIntegrations": {},
"adBreakdown": []
}
]
}
],
"popData": {
"insights": [
{
"creativeKey": "string",
"ad": {},
"insights": {},
"firstPartyIntegrations": {},
"adBreakdown": [
{
"creativeKey": "string",
"ad": {},
"insights": {},
"firstPartyIntegrations": {},
"adBreakdown": []
}
]
}
],
"popRateOfChange": {}
},
"firstPartyIntegrationStatus": {
"property1": {
"status": "string"
},
"property2": {
"status": "string"
}
}
}{
"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"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}