Skip to main content
GET
獲取針對某條特定 Instagram 貼文進行推廣(boost)的廣告。 此已推廣廣告端點提供有關已推廣廣告的詳細資訊,包括狀態、當前支出、表現指標(分析資料)和預覽連結。
  • 指標資料為廣告的即時總計。如需獲取歷史資料,請使用 廣告歷史端點。
  • previewLink URL 可讓您與同事分享預覽廣告,同事在 24 小時內可以看到該廣告 在各種 Instagram 版式中的呈現。同事對該廣告的瀏覽不會計入您的廣告支出。

請求頭參數

查詢參數

string
必填
獲取該帳戶 ID 下的所有廣告。廣告帳戶 ID,可包含或不包含 act_ 前綴(1234567890 或 act_1234567890)。如果未設定 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