Skip to main content
GET
Retrieve ads that have been boosted for a specific Instagram post. This boosted ads endpoint provides detailed information about the boosted ads, including status, current spend, performance metrics (analytics), and preview links.
  • The metrics are real-time totals for the ads. If you need historical data, use the get ad history endpoint.
  • The previewLink URL allows you share the preview ad with your colleagues, so that they will see the ad for 24-hours across the various Instagram formats. Your colleagues’ views of the ad will not be counted towards your ad spend.

Header Parameters

Query Parameters

number
required
Retrieve all ads under the account ID.Required if adId, socialPostId, or postId is not set.
string
required
Retrieve an ad with the ad ID.Required if accountId, socialPostId, or postId is not set.
string
required
Retrieve ads with the Instagram social post ID.Required if accountId, adId, or postId is not set.
number
default:25
Retrieve a maximum of limit ads. Maximum is 300; higher values are capped at 300.
string
required
Retrieve ads with the Ayrshare post ID.Required if accountId, adId, or socialPostId is not set.
string
default:"all"
Filter ads by status of the ad. Omit this parameter to return ads of every status. Valid values are:
  • active
  • paused
  • deleted
  • archived