Available on Premium, Business, Enterprise plans.
The
dailySpend
array contains historical daily spend and performance metrics
for each ad. The data is as of 8 AM EST. If real-time spend data is needed or spend has not yet occurred,
please use the ads endpoint.The ad will NOT be returned if no spend data is available or spend has not yet occurred.- Metrics are calculated from Facebook’s reporting API and may have slight delays (up to 24 hours).
- The
byGoalType
andbyGoalTitle
sections group performance metrics by goal objectives. - Use either
adId
orpostId
filters to narrow results to specific campaigns. - All monetary values are in the ad account’s currency (typically USD).
- The
goalPerformance
section highlights your best-performing ad objectives.
Header Parameters
Query Parameters
Filter results to a specific account ID.
Filter results to a specific ad ID.
Filter results to ads associated with a specific Ayrshare post
ID.
Filter results to ads associated with a specific Facebook social post
ID.
Retrieve a maximum of
limit
ads. Maximum is 500.Start date for the reporting period in ISO 8601 format (default: 30 days ago)
End date for the reporting period in ISO 8601 format (default: today)