Skip to main content
GET
获取针对某条特定 Instagram 帖子进行推广(boost)的广告。 此已推广广告端点提供有关已推广广告的详细信息,包括状态、当前支出、表现指标(分析数据)和预览链接。
  • 指标数据为广告的实时总计。如需获取历史数据,请使用 广告历史端点。
  • previewLink URL 可让您与同事分享预览广告,同事在 24 小时内可以看到该广告 在各种 Instagram 版式中的呈现。同事对该广告的浏览不会计入您的广告支出。

请求头参数

查询参数

number
必填
获取该账户 ID 下的所有广告。如果未设置 adId、socialPostId 或 postId,则该参数必填。
string
必填
按广告 ID 获取一条广告。如果未设置 accountId、socialPostId 或 postId,则该参数必填。
string
必填
按 Instagram 社交帖子 ID 获取广告。如果未设置 accountId、adId 或 postId,则该参数必填。
number
默认值:25
最多获取 limit 条广告。最大值为 300;更高的值会被限制为 300。
string
必填
按 Ayrshare 帖子 ID 获取广告。如果未设置 accountId、adId 或 socialPostId,则该参数必填。
string
默认值:"all"
按广告状态过滤。省略此参数可返回所有状态的广告。可选值为:
  • active
  • paused
  • deleted
  • archived