You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 207ba2b
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: openapi.yaml
+3-6Lines changed: 3 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -19821,7 +19821,6 @@ paths:
19821
19821
Returns a paginated list of ads with metrics computed over an optional date range.
19822
19822
Use source=all to include externally-synced ads from platform ad managers.
19823
19823
If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
19824
-
Ranges older than 90 days trigger a one-time on-demand fetch from the platform when scoped to a specific accountId, then serve from cache on subsequent requests.
19825
19824
security:
19826
19825
- bearerAuth: []
19827
19826
parameters:
@@ -19834,7 +19833,7 @@ paths:
19834
19833
- { name: adAccountId, in: query, schema: { type: string }, description: "Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree." }
- { name: campaignId, in: query, schema: { type: string }, description: Platform campaign ID (filter ads within a campaign) }
19837
-
- { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId." }
19836
+
- { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago." }
19838
19837
- { name: toDate, in: query, schema: { type: string, format: date }, description: "End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range." }
19839
19838
responses:
19840
19839
'200':
@@ -20275,7 +20274,6 @@ paths:
20275
20274
and campaign levels. Pagination is at the campaign level. Ads without a campaign or ad set
20276
20275
ID are grouped into synthetic "Ungrouped" buckets.
20277
20276
If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
20278
-
Ranges older than 90 days trigger a one-time on-demand fetch from the platform when scoped to a specific accountId, then serve from cache on subsequent requests.
20279
20277
security:
20280
20278
- bearerAuth: []
20281
20279
parameters:
@@ -20287,7 +20285,7 @@ paths:
20287
20285
- { name: adAccountId, in: query, schema: { type: string }, description: Platform ad account ID }
20288
20286
- { name: accountId, in: query, schema: { type: string }, description: Social account ID }
- { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId." }
20288
+
- { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago." }
20291
20289
- { name: toDate, in: query, schema: { type: string, format: date }, description: "End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range." }
20292
20290
responses:
20293
20291
'200':
@@ -20439,12 +20437,11 @@ paths:
20439
20437
Returns detailed performance analytics for an ad. Includes summary metrics, a daily timeline
20440
20438
over the requested date range, and optional demographic breakdowns (Meta and TikTok only).
20441
20439
If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
20442
-
Ranges older than 90 days trigger a one-time on-demand fetch from the platform, then serve from cache on subsequent requests.
- { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch." }
20444
+
- { name: fromDate, in: query, schema: { type: string, format: date }, description: "Start of date range (YYYY-MM-DD). Defaults to 90 days ago." }
20448
20445
- { name: toDate, in: query, schema: { type: string, format: date }, description: "End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range." }
from_date: Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
1174
+
from_date: Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
1175
1175
to_date: End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range."""
1176
1176
client=_get_client()
1177
1177
try:
@@ -1219,7 +1219,7 @@ def ads_list_ads(
1219
1219
ad_account_id: Platform ad account ID (e.g. act_123 for Meta). Mirrors the same filter on /v1/ads/campaigns and /v1/ads/tree.
1220
1220
profile_id: Profile ID
1221
1221
campaign_id: Platform campaign ID (filter ads within a campaign)
1222
-
from_date: Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch when scoped to a specific accountId.
1222
+
from_date: Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
1223
1223
to_date: End of metrics date range (YYYY-MM-DD). Defaults to today. Max 730-day range."""
1224
1224
client=_get_client()
1225
1225
try:
@@ -1313,7 +1313,7 @@ def ads_get_ad_analytics(
1313
1313
1314
1314
Args:
1315
1315
ad_id: (required)
1316
-
from_date: Start of date range (YYYY-MM-DD). Defaults to 90 days ago. Ranges older than 90 days trigger an on-demand platform fetch.
1316
+
from_date: Start of date range (YYYY-MM-DD). Defaults to 90 days ago.
1317
1317
to_date: End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.
0 commit comments