Facebook 广告库搜索

按关键字搜索元广告库并返回匹配的广告。

1 credits / 次请求

GET /v1/facebook/adLibrary/search/ads 试用

Facebook 广告库搜索
GET /v1/facebook/adLibrary/search/ads

按关键字搜索元广告库并返回匹配的广告。

鉴权：x-api-key
示例 URL: https://api.datawake.ai/v1/facebook/adLibrary/search/ads?query=running&sort_by=total_impressions&search_type=keyword_unordered&ad_type=all&country=ALL&status=ACTIVE&media_type=ALL&start_date=2025-01-05&end_date=2025-02-16&cursor=AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-&trim=false&llm_friendly=true

参数：
- query (query · string · 必填) = running
- sort_by (query · string · 可选) = total_impressions
- search_type (query · string · 可选) = keyword_unordered
- ad_type (query · string · 可选) = all
- country (query · string · 可选) = ALL
- status (query · string · 可选) = ACTIVE
- media_type (query · string · 可选) = ALL
- start_date (query · string · 可选) = 2025-01-05
- end_date (query · string · 可选) = 2025-02-16
- cursor (query · string · 可选) = AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-
- trim (query · boolean · 可选) = false
- llm_friendly (query · boolean · 可选) = true

概览

WakeScrap exposes this Facebook Ad Library endpoint with an LLM-friendly response by default. Set llm_friendly=false to receive the full response shape.

按关键字搜索元广告库并返回匹配的广告。每个结果包括 ad_archive_id、page_name、is_active、publisher_platform 以及包含正文、图像、视频和 cta_text 的快照。由于游标大小限制，通过 GET 的结果上限约为 1,500 个；切换到带有主体参数的 POST 方法以获得更大的结果集。

必填参数：query。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

query string 必填

要搜索的关键字

示例：

running

sort_by string

按展示次数（从高到低）或最近（relevancy_monthly_grouped）排序。默认为展示次数。

示例：

total_impressions

枚举： total_impressions, relevancy_monthly_grouped

search_type string

是否想按精确短语进行搜索

示例：

keyword_unordered

枚举： keyword_unordered, keyword_exact_phrase

ad_type string

搜索所有广告或仅搜索政治和问题广告

示例：

all

枚举： all, political_and_issue_ads

country string

这只能是一个国家。它必须是该国家/地区的 2 个字母代码。默认为全部。

示例：

ALL

status string

广告的状态。默认为活动状态。

示例：

ACTIVE

枚举： ALL, ACTIVE, INACTIVE

media_type string

广告的媒体类型。默认为全部。 Meme 只是意味着广告包含文字和图像。不知道为什么他们称之为模因。

示例：

ALL

枚举： ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE

start_date string

展示次数开始日期。需要采用 YYYY-MM-DD 格式。

示例：

2025-01-05

end_date string

展示次数结束日期。需要采用 YYYY-MM-DD 格式。

示例：

2025-02-16

cursor string

光标对结果进行分页

示例：

AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-

trim boolean

对于响应的精简版本设置为 true

示例：

false

llm_friendly boolean

Defaults to true. When true, WakeScrap returns a compact LLM-friendly response. Set false to receive the full response shape.

示例：

true


              curl 'https://api.datawake.ai/v1/facebook/adLibrary/search/ads?query=running&sort_by=total_impressions&search_type=keyword_unordered&ad_type=all&country=ALL&status=ACTIVE&media_type=ALL&start_date=2025-01-05&end_date=2025-02-16&cursor=AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-&trim=false&llm_friendly=true' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/facebook/adLibrary/search/ads?query=running&sort_by=total_impressions&search_type=keyword_unordered&ad_type=all&country=ALL&status=ACTIVE&media_type=ALL&start_date=2025-01-05&end_date=2025-02-16&cursor=AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-&trim=false&llm_friendly=true", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/facebook/adLibrary/search/ads?query=running&sort_by=total_impressions&search_type=keyword_unordered&ad_type=all&country=ALL&status=ACTIVE&media_type=ALL&start_date=2025-01-05&end_date=2025-02-16&cursor=AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-&trim=false&llm_friendly=true",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/facebook/adLibrary/search/ads?query=running&sort_by=total_impressions&search_type=keyword_unordered&ad_type=all&country=ALL&status=ACTIVE&media_type=ALL&start_date=2025-01-05&end_date=2025-02-16&cursor=AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-&trim=false&llm_friendly=true",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/facebook/adLibrary/search/ads?query=running&sort_by=total_impressions&search_type=keyword_unordered&ad_type=all&country=ALL&status=ACTIVE&media_type=ALL&start_date=2025-01-05&end_date=2025-02-16&cursor=AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-&trim=false&llm_friendly=true", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/facebook/adLibrary/search/ads?query=running&sort_by=total_impressions&search_type=keyword_unordered&ad_type=all&country=ALL&status=ACTIVE&media_type=ALL&start_date=2025-01-05&end_date=2025-02-16&cursor=AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-&trim=false&llm_friendly=true"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "searchResults": [
    {
      "ad_archive_id": "1378176106734781",
      "end_date": 1747638000,
      "is_aaa_eligible": false,
      "is_active": true,
      "page_id": "119749581219299",
      "page_name": "Makhumalo",
      "political_countries": [],
      "reach_estimate": null,
      "snapshot": {
        "branded_content": null,
        "page_id": "119749581219299",
        "page_is_deleted": false,
        "page_profile_uri": "https://www.facebook.com/61550737114480/",
        "root_reshared_post": null,
        "byline": null,
        "disclaimer_label": null,
        "page_name": "Makhumalo",
        "page_profile_picture_url": "https://scontent-sjc3-1.xx.fbcdn.net/v/t39.35426-6/499107970_2293645317822147_4932735414928456888_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=DBNo3Z6ft4...",
        "body": {
          "text": "..."
        },
        "is_reshared": false,
        "brazil_tax_id": null,
        "caption": "ghemshop.com",
        "cards": [],
        "cta_text": "Shop now",
        "cta_type": "SHOP_NOW",
        "country_iso_code": null,
        "current_page_name": "Makhumalo",
        "...": "17 more fields"
      },
      "total_active_time": null,
      "spend": null,
      "start_date": 1747638000,
      "publisher_platform": [
        "FACEBOOK"
      ],
      "url": "https://www.facebook.com/ads/library?id=1378176106734781",
      "start_date_string": "2025-05-19T07:00:00.000Z",
      "end_date_string": "2025-05-19T07:00:00.000Z"
    }
  ],
  "searchResultsCount": 50001,
  "cursor": "AQHRLKHyzb3ZNTn1O3qr6lG7ncS9gfboI0HWGSDETVUnipTSXVY8E4Wb-568JBicOvYS"
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}