Skip to main content
POST
Query synced Meta ads performance (spend, impressions, clicks, results, ROAS, budget) grouped by campaign / ad set / ad / creative component, over a date range. Use list_ad_accounts first to discover ad account ids. Data freshness depends on the team's sync schedule; check last_synced_at in list_ad_accounts.

Authorizations

Authorization
string
header
required

AdStellar API key (ast_live_...)

Body

application/json
breakdown
enum<string>

What to group by. Default "campaign".

Available options:
campaign,
ad_set,
ad,
ad_combination,
audience_variant,
creative,
headline,
primary_text,
description,
cta,
interest,
custom_audience,
lookalike,
behavior,
country,
landing_page,
audience,
placement
preset
enum<string>

Date-range preset. Default "last_7d".

Available options:
today,
yesterday,
last_7d,
last_14d,
last_30d,
last_90d,
mtd,
last_quarter,
lifetime
startDate
string

Explicit range start (YYYY-MM-DD), use with endDate.

endDate
string

Explicit range end (YYYY-MM-DD).

adAccount
string

Ad account name or id. Omit for the whole workspace.

campaignId
string

Drill into one campaign (its ad sets or ads).

adSetId
string

Drill into one ad set (its ads).

limit
integer

Max rows (default 50).

Required range: 1 <= x <= 50
workspaceId
string<uuid>

Which workspace to query (must be one this credential can access). Omit for the primary workspace.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Tool result