AdnovaDocs
Analytics

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.

POST
/insights

Authentication

authentication
api-key<token>

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"
}