已推廣廣告

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890', headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890';
$apiKey = 'API_KEY';  // 将 'API_KEY' 替换为您实际的 API 密钥

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace HistoryGETRequest_csharp
{
class History
{
    static async Task Main(string[] args)
    {
        string API_KEY = "API_KEY";
        string url = "https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890";

        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            try
            {
                var response = await client.GetStringAsync(url);
                Console.WriteLine(response);
            }
            catch (HttpRequestException ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
}
}

{
    "status": "success",
    "ads": [
        {
            "postId": "DE6gpw8kxlonHy6eb721",
            "ad": {
                "accountId": "274948331",
                "adId": "6683876017501",
                "budgetRemaining": 0,
                "created": "2025-03-30T10:11:34-0700",
                "creativeId": "1033490148629541",
                "dailyBudget": 0,
                "deliveryStatus": "ACTIVE",
                "endDate": "2025-04-03T22:30:00.000Z",
                "fbPostId": "106638148652329_672633202087922",
                "goal": {
                    "title": "Get More Engagement",
                    "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
                    "type": "engagement"
                },
                "isComplete": false,
                "lifetimeBudget": 0,
                "metrics": {
                    "spend": 9.21,
                    "impressions": 6495,
                    "reach": 6272,
                    "clicks": 3,
                    "ctr": 0.046189,
                    "cpm": 1.418014,
                    "cpp": 1.468431,
                    "frequency": 1.035555,
                    "uniqueClicks": 3,
                    "uniqueCtr": 0.047832,
                    "costPerUniqueClick": 3.07,
                    "inlineLinkClicks": 0,
                    "costPerInlineLinkClick": 0,
                    "outboundClicks": 0,
                    "costPerOutboundClick": 0,
                    "websiteCtr": [],
                    "accountCurrency": "USD",
                    "accountName": "John Doe",
                    "accountId": "274948331"
                },
                "name": "API Post - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T17:11:26",
                "previewLink": "https://fb.me/22Cn31wXlzhxOC1",
                "spend": 9.21,
                "startDate": "2025-03-30T17:11:32.000Z",
                "status": "ACTIVE",
                "targeting": {
                    "ageMax": 65,
                    "ageMin": 18,
                    "geoLocations": {
                        "countries": [
                            "US"
                        ],
                        "locationTypes": [
                            "home",
                            "recent"
                        ]
                    },
                    "interests": [
                        {
                            "id": "6003195554098",
                            "name": "Rhythm and blues music"
                        }
                    ]
                }
            }
        }
    ],
    "count": 1
}

{
  "status": "success",
  "ads": [
    {
      "postId": "DE6gpw8kxlonHy6eb7Lo",
      "ad": {
        "accountId": "274948331",
        "adId": "6683876017501",
        "budgetRemaining": 0,
        "created": "2025-03-30T10:11:34-0700",
        "creativeId": "1033490148629541",
        "dailyBudget": 0,
        "deliveryStatus": "ACTIVE",
        "endDate": "2025-04-03T22:30:00.000Z",
        "fbPostId": "106638148652329_672633202087921",
        "goal": {
          "title": "Get More Engagement",
          "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
          "type": "engagement"
        },
        "isComplete": false,
        "lifetimeBudget": 0,
        "metrics": {
          "spend": 9.21,
          "impressions": 6495,
          "reach": 6272,
          "clicks": 3,
          "ctr": 0.046189,
          "cpm": 1.418014,
          "cpp": 1.468431,
          "frequency": 1.035555,
          "uniqueClicks": 3,
          "uniqueCtr": 0.047832,
          "costPerUniqueClick": 3.07,
          "inlineLinkClicks": 0,
          "costPerInlineLinkClick": 0,
          "outboundClicks": 0,
          "costPerOutboundClick": 0,
          "websiteCtr": [],
          "accountCurrency": "USD",
          "accountName": "John Doe",
          "accountId": "274948331"
        },
        "name": "API Post - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
        "previewLink": "https://fb.me/22Cn31wXlzhxOC1",
        "spend": 9.21,
        "startDate": "2025-03-30T17:11:32.000Z",
        "status": "ACTIVE",
        "targeting": {
          "ageMax": 65,
          "ageMin": 18,
          "geoLocations": {
            "countries": ["US"],
            "locationTypes": ["home", "recent"]
          },
          "interests": [
            {
              "id": "6003195554098",
              "name": "Rhythm and blues music"
            }
          ]
        }
      }
    },
    {
      "ad": {
        "accountId": "274948331",
        "adId": "6685225314301",
        "budgetRemaining": 0,
        "created": "2025-03-30T18:36:39-0700",
        "creativeId": "628434386637341",
        "dailyBudget": 0,
        "deliveryStatus": "PAUSED",
        "endDate": "2025-04-03T22:30:00.000Z",
        "fbPostId": "106638148652329_672633202087921",
        "goal": {
          "title": "Get More Engagement",
          "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
          "type": "engagement"
        },
        "isComplete": false,
        "lifetimeBudget": 0,
        "metrics": {},
        "name": "API Post 14 - 106638148652329_672633202087926 - 2025-03-31T01:36:32",
        "previewLink": "https://fb.me/2nPlTIZEpzrCnY1",
        "spend": 0,
        "startDate": "2025-03-31T01:36:37.000Z",
        "status": "PAUSED",
        "targeting": {
          "ageMax": 65,
          "ageMin": 18,
          "geoLocations": {
            "countries": ["US"],
            "locationTypes": ["home", "recent"]
          },
          "interests": [
            {
              "id": "6003195554098",
              "name": "Rhythm and blues music"
            }
          ]
        }
      }
    }
  ],
  "count": 2
}

{
  "action": "get ads",
  "status": "error",
  "code": 370,
  "message": "Error getting ads. Please try again or contact us if the issue persists."
}

GET

ads

facebook

ads

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890', headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890';
$apiKey = 'API_KEY';  // 将 'API_KEY' 替换为您实际的 API 密钥

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace HistoryGETRequest_csharp
{
class History
{
    static async Task Main(string[] args)
    {
        string API_KEY = "API_KEY";
        string url = "https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890";

        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            try
            {
                var response = await client.GetStringAsync(url);
                Console.WriteLine(response);
            }
            catch (HttpRequestException ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
}
}

{
    "status": "success",
    "ads": [
        {
            "postId": "DE6gpw8kxlonHy6eb721",
            "ad": {
                "accountId": "274948331",
                "adId": "6683876017501",
                "budgetRemaining": 0,
                "created": "2025-03-30T10:11:34-0700",
                "creativeId": "1033490148629541",
                "dailyBudget": 0,
                "deliveryStatus": "ACTIVE",
                "endDate": "2025-04-03T22:30:00.000Z",
                "fbPostId": "106638148652329_672633202087922",
                "goal": {
                    "title": "Get More Engagement",
                    "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
                    "type": "engagement"
                },
                "isComplete": false,
                "lifetimeBudget": 0,
                "metrics": {
                    "spend": 9.21,
                    "impressions": 6495,
                    "reach": 6272,
                    "clicks": 3,
                    "ctr": 0.046189,
                    "cpm": 1.418014,
                    "cpp": 1.468431,
                    "frequency": 1.035555,
                    "uniqueClicks": 3,
                    "uniqueCtr": 0.047832,
                    "costPerUniqueClick": 3.07,
                    "inlineLinkClicks": 0,
                    "costPerInlineLinkClick": 0,
                    "outboundClicks": 0,
                    "costPerOutboundClick": 0,
                    "websiteCtr": [],
                    "accountCurrency": "USD",
                    "accountName": "John Doe",
                    "accountId": "274948331"
                },
                "name": "API Post - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T17:11:26",
                "previewLink": "https://fb.me/22Cn31wXlzhxOC1",
                "spend": 9.21,
                "startDate": "2025-03-30T17:11:32.000Z",
                "status": "ACTIVE",
                "targeting": {
                    "ageMax": 65,
                    "ageMin": 18,
                    "geoLocations": {
                        "countries": [
                            "US"
                        ],
                        "locationTypes": [
                            "home",
                            "recent"
                        ]
                    },
                    "interests": [
                        {
                            "id": "6003195554098",
                            "name": "Rhythm and blues music"
                        }
                    ]
                }
            }
        }
    ],
    "count": 1
}

{
  "status": "success",
  "ads": [
    {
      "postId": "DE6gpw8kxlonHy6eb7Lo",
      "ad": {
        "accountId": "274948331",
        "adId": "6683876017501",
        "budgetRemaining": 0,
        "created": "2025-03-30T10:11:34-0700",
        "creativeId": "1033490148629541",
        "dailyBudget": 0,
        "deliveryStatus": "ACTIVE",
        "endDate": "2025-04-03T22:30:00.000Z",
        "fbPostId": "106638148652329_672633202087921",
        "goal": {
          "title": "Get More Engagement",
          "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
          "type": "engagement"
        },
        "isComplete": false,
        "lifetimeBudget": 0,
        "metrics": {
          "spend": 9.21,
          "impressions": 6495,
          "reach": 6272,
          "clicks": 3,
          "ctr": 0.046189,
          "cpm": 1.418014,
          "cpp": 1.468431,
          "frequency": 1.035555,
          "uniqueClicks": 3,
          "uniqueCtr": 0.047832,
          "costPerUniqueClick": 3.07,
          "inlineLinkClicks": 0,
          "costPerInlineLinkClick": 0,
          "outboundClicks": 0,
          "costPerOutboundClick": 0,
          "websiteCtr": [],
          "accountCurrency": "USD",
          "accountName": "John Doe",
          "accountId": "274948331"
        },
        "name": "API Post - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
        "previewLink": "https://fb.me/22Cn31wXlzhxOC1",
        "spend": 9.21,
        "startDate": "2025-03-30T17:11:32.000Z",
        "status": "ACTIVE",
        "targeting": {
          "ageMax": 65,
          "ageMin": 18,
          "geoLocations": {
            "countries": ["US"],
            "locationTypes": ["home", "recent"]
          },
          "interests": [
            {
              "id": "6003195554098",
              "name": "Rhythm and blues music"
            }
          ]
        }
      }
    },
    {
      "ad": {
        "accountId": "274948331",
        "adId": "6685225314301",
        "budgetRemaining": 0,
        "created": "2025-03-30T18:36:39-0700",
        "creativeId": "628434386637341",
        "dailyBudget": 0,
        "deliveryStatus": "PAUSED",
        "endDate": "2025-04-03T22:30:00.000Z",
        "fbPostId": "106638148652329_672633202087921",
        "goal": {
          "title": "Get More Engagement",
          "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
          "type": "engagement"
        },
        "isComplete": false,
        "lifetimeBudget": 0,
        "metrics": {},
        "name": "API Post 14 - 106638148652329_672633202087926 - 2025-03-31T01:36:32",
        "previewLink": "https://fb.me/2nPlTIZEpzrCnY1",
        "spend": 0,
        "startDate": "2025-03-31T01:36:37.000Z",
        "status": "PAUSED",
        "targeting": {
          "ageMax": 65,
          "ageMin": 18,
          "geoLocations": {
            "countries": ["US"],
            "locationTypes": ["home", "recent"]
          },
          "interests": [
            {
              "id": "6003195554098",
              "name": "Rhythm and blues music"
            }
          ]
        }
      }
    }
  ],
  "count": 2
}

{
  "action": "get ads",
  "status": "error",
  "code": 370,
  "message": "Error getting ads. Please try again or contact us if the issue persists."
}

獲取針對某條特定 Facebook 貼文進行推廣（boost）的廣告。此已推廣廣告端點提供有關已推廣廣告的詳細資訊，包括狀態、當前支出、表現指標（分析資料）和預覽連結。

指標資料為廣告的即時總計。如需獲取歷史資料，請使用廣告歷史端點。
previewLink URL 可讓您與同事分享預覽廣告，同事在 24 小時內可以看到該廣告在各種 Facebook 版式中的呈現。同事對該廣告的瀏覽不會計入您的廣告支出。

請求頭參數

查詢參數

string

必填

獲取該帳戶 ID 下的所有廣告。廣告帳戶 ID，可包含或不包含 act_ 前綴（1234567890 或 act_1234567890）。如果未設定 adId、fbPostId 或 postId，則該參數必填。

string

必填

按廣告 ID 獲取一條廣告。如果未設定 accountId、fbPostId 或 postId，則該參數必填。

string

必填

按 Facebook 社群貼文 ID 獲取廣告。如果未設定 accountId、adId 或 postId，則該參數必填。

number

預設值:25

最多獲取 limit 條廣告。最大值為 500。

string

必填

按 Ayrshare 貼文 ID 獲取廣告。如果未設定 accountId、adId 或 fbPostId，則該參數必填。

string

預設值:"all"

按廣告狀態過濾。可選值為：

active
paused
deleted
archived

使用 callToAction 推廣的廣告會在 ad.callToAction 上帶回該物件，其中 type 為 Meta 的大寫形式。沒有行動呼籲按鈕的廣告會完全省略該鍵。開啟聊天的按鈕還會帶有其 destination。以下範例使用 engagement 目標，未帶按鈕。連結按鈕需要 traffic 目標，而聊天按鈕需要 engagement 或 interactions。依活動篩選時，以 interactions 推廣的聊天按鈕會以 engagement 目標列出。

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890', headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890';
$apiKey = 'API_KEY';  // 将 'API_KEY' 替换为您实际的 API 密钥

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace HistoryGETRequest_csharp
{
class History
{
    static async Task Main(string[] args)
    {
        string API_KEY = "API_KEY";
        string url = "https://api.ayrshare.com/api/ads/facebook/ads?adId=1234567890";

        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            try
            {
                var response = await client.GetStringAsync(url);
                Console.WriteLine(response);
            }
            catch (HttpRequestException ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
}
}

{
    "status": "success",
    "ads": [
        {
            "postId": "DE6gpw8kxlonHy6eb721",
            "ad": {
                "accountId": "274948331",
                "adId": "6683876017501",
                "budgetRemaining": 0,
                "created": "2025-03-30T10:11:34-0700",
                "creativeId": "1033490148629541",
                "dailyBudget": 0,
                "deliveryStatus": "ACTIVE",
                "endDate": "2025-04-03T22:30:00.000Z",
                "fbPostId": "106638148652329_672633202087922",
                "goal": {
                    "title": "Get More Engagement",
                    "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
                    "type": "engagement"
                },
                "isComplete": false,
                "lifetimeBudget": 0,
                "metrics": {
                    "spend": 9.21,
                    "impressions": 6495,
                    "reach": 6272,
                    "clicks": 3,
                    "ctr": 0.046189,
                    "cpm": 1.418014,
                    "cpp": 1.468431,
                    "frequency": 1.035555,
                    "uniqueClicks": 3,
                    "uniqueCtr": 0.047832,
                    "costPerUniqueClick": 3.07,
                    "inlineLinkClicks": 0,
                    "costPerInlineLinkClick": 0,
                    "outboundClicks": 0,
                    "costPerOutboundClick": 0,
                    "websiteCtr": [],
                    "accountCurrency": "USD",
                    "accountName": "John Doe",
                    "accountId": "274948331"
                },
                "name": "API Post - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T17:11:26",
                "previewLink": "https://fb.me/22Cn31wXlzhxOC1",
                "spend": 9.21,
                "startDate": "2025-03-30T17:11:32.000Z",
                "status": "ACTIVE",
                "targeting": {
                    "ageMax": 65,
                    "ageMin": 18,
                    "geoLocations": {
                        "countries": [
                            "US"
                        ],
                        "locationTypes": [
                            "home",
                            "recent"
                        ]
                    },
                    "interests": [
                        {
                            "id": "6003195554098",
                            "name": "Rhythm and blues music"
                        }
                    ]
                }
            }
        }
    ],
    "count": 1
}

{
  "status": "success",
  "ads": [
    {
      "postId": "DE6gpw8kxlonHy6eb7Lo",
      "ad": {
        "accountId": "274948331",
        "adId": "6683876017501",
        "budgetRemaining": 0,
        "created": "2025-03-30T10:11:34-0700",
        "creativeId": "1033490148629541",
        "dailyBudget": 0,
        "deliveryStatus": "ACTIVE",
        "endDate": "2025-04-03T22:30:00.000Z",
        "fbPostId": "106638148652329_672633202087921",
        "goal": {
          "title": "Get More Engagement",
          "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
          "type": "engagement"
        },
        "isComplete": false,
        "lifetimeBudget": 0,
        "metrics": {
          "spend": 9.21,
          "impressions": 6495,
          "reach": 6272,
          "clicks": 3,
          "ctr": 0.046189,
          "cpm": 1.418014,
          "cpp": 1.468431,
          "frequency": 1.035555,
          "uniqueClicks": 3,
          "uniqueCtr": 0.047832,
          "costPerUniqueClick": 3.07,
          "inlineLinkClicks": 0,
          "costPerInlineLinkClick": 0,
          "outboundClicks": 0,
          "costPerOutboundClick": 0,
          "websiteCtr": [],
          "accountCurrency": "USD",
          "accountName": "John Doe",
          "accountId": "274948331"
        },
        "name": "API Post - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
        "previewLink": "https://fb.me/22Cn31wXlzhxOC1",
        "spend": 9.21,
        "startDate": "2025-03-30T17:11:32.000Z",
        "status": "ACTIVE",
        "targeting": {
          "ageMax": 65,
          "ageMin": 18,
          "geoLocations": {
            "countries": ["US"],
            "locationTypes": ["home", "recent"]
          },
          "interests": [
            {
              "id": "6003195554098",
              "name": "Rhythm and blues music"
            }
          ]
        }
      }
    },
    {
      "ad": {
        "accountId": "274948331",
        "adId": "6685225314301",
        "budgetRemaining": 0,
        "created": "2025-03-30T18:36:39-0700",
        "creativeId": "628434386637341",
        "dailyBudget": 0,
        "deliveryStatus": "PAUSED",
        "endDate": "2025-04-03T22:30:00.000Z",
        "fbPostId": "106638148652329_672633202087921",
        "goal": {
          "title": "Get More Engagement",
          "description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
          "type": "engagement"
        },
        "isComplete": false,
        "lifetimeBudget": 0,
        "metrics": {},
        "name": "API Post 14 - 106638148652329_672633202087926 - 2025-03-31T01:36:32",
        "previewLink": "https://fb.me/2nPlTIZEpzrCnY1",
        "spend": 0,
        "startDate": "2025-03-31T01:36:37.000Z",
        "status": "PAUSED",
        "targeting": {
          "ageMax": 65,
          "ageMin": 18,
          "geoLocations": {
            "countries": ["US"],
            "locationTypes": ["home", "recent"]
          },
          "interests": [
            {
              "id": "6003195554098",
              "name": "Rhythm and blues music"
            }
          ]
        }
      }
    }
  ],
  "count": 2
}

{
  "action": "get ads",
  "status": "error",
  "code": 370,
  "message": "Error getting ads. Please try again or contact us if the issue persists."
}

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

請求頭參數

查詢參數

​請求頭參數

​查詢參數

請求頭參數

查詢參數