Campaign tree · Adeli API

curl --fail-with-body "https://app.tryadeli.com/api/v1/ads/tree?adAccountId=act_1234567890&since=2026-09-12&until=2026-10-09&accountId=00000000-0000-0000-0000-000000000000" \ -H "Authorization: Bearer $ADELI_API_KEY"

{ "platform": "facebook", "accountId": "00000000-0000-0000-0000-000000000000", "profileId": "00000000-0000-4000-8000-000000000002", "adAccount": { "id": "act_1234567890", "accountId": "1234567890", "name": "Client A — Ads", "currency": "USD", "timezoneName": "America/New_York", "accountStatus": 1, "minDailyBudget": 100, "businessId": "1122334455", "businessName": "Client A" }, "campaigns": [ { "id": "120210000000000001", "name": "Fall launch", "status": "ACTIVE", "effectiveStatus": "ACTIVE", "metrics": { "spend": 182.4, "impressions": 41250, "reach": 30110, "clicks": 912, "ctr": 2.210909, "cpc": 0.2, "cpm": 4.421818, "conversions": 0 }, "objective": "OUTCOME_ENGAGEMENT", "adSets": [ { "id": "120210000000000002", "name": "Fall launch — ad set", "status": "ACTIVE", "effectiveStatus": "ACTIVE", "metrics": { "spend": 182.4, "impressions": 41250, "reach": 30110, "clicks": 912, "ctr": 2.210909, "cpc": 0.2, "cpm": 4.421818, "conversions": 0 }, "ads": [ { "id": "120210000000000004", "name": "Fall launch — ad", "status": "ACTIVE", "effectiveStatus": "ACTIVE", "metrics": { "spend": 182.4, "impressions": 41250, "reach": 30110, "clicks": 912, "ctr": 2.210909, "cpc": 0.2, "cpm": 4.421818, "conversions": 0 } } ] } ] } ], "range": { "since": "2026-09-12", "until": "2026-10-09" }, "fetchedAt": "2026-10-09T16:00:00.000Z" }

The Campaign → Ad set → Ad hierarchy for one ad account, with spend, impressions, reach, clicks, ctr, cpc and cpm rolled up at every level. An object that did not deliver in the range reports zeroes rather than being omitted.

Query parameters

adAccountIdstringRequired: An ad account id, in Meta's act_<digits> form.
sincedate: YYYY-MM-DD. Defaults to 28 days ago.
untildate: YYYY-MM-DD. Defaults to today. Ranges over 730 days are rejected.
accountIduuid: A connected Facebook account.
profileIduuid: Required unless you pass accountId, which names its profile. If you pass both, they must agree.