Read Meta ad account insights through the connection surface

GET

/api/v1/connections/{id}/insights

Fetches Meta insights for a linked ad account by using the connection resolved for the authenticated external user.

Request

Path Params

Query Params

Header Params

Responses

🟢200OK

application/json

Insights payload for the requested linked ad account.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.adlyfy.dev/api/v1/connections//insights?start_date=undefined&end_date=undefined&metrics=undefined&breakdown=undefined' \
--header 'x-api-key;'

Response Example

200 - Example 1

{
    "data": [
        {
            "date_start": "2026-06-01",
            "date_stop": "2026-06-30",
            "impressions": "12345",
            "clicks": "678",
            "spend": "123.45"
        }
    ],
    "paging": {
        "cursors": {
            "before": "MAZDZD",
            "after": "MjQZD"
        }
    }
}

Revoke a connection by connection ID

Import Meta ad account data