Facebook 广告库广告详细信息

通过 ID 或 URL 检索有关特定 Facebook 广告的详细信息。

1 credits / 次请求

GET /v1/facebook/adLibrary/ad 试用

Facebook 广告库广告详细信息
GET /v1/facebook/adLibrary/ad

通过 ID 或 URL 检索有关特定 Facebook 广告的详细信息。

鉴权：x-api-key
示例 URL: https://api.datawake.ai/v1/facebook/adLibrary/ad?id=702369045530963&url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%3Fid%3D1185617869915074&get_transcript=false&trim=false&llm_friendly=true

参数：
- id (query · string · 可选) = 702369045530963
- url (query · string · 可选) = https://www.facebook.com/ads/library?id=1185617869915074
- get_transcript (query · boolean · 可选) = false
- 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.

通过 ID 或 URL 检索有关特定 Facebook 广告的详细信息。返回 adArchiveID、pageName、isActive、startDate、endDate 以及包含正文、图像、视频、display_format、link_url 和 cta_text 的快照。对于具有多个版本的广告，广告素材位于 snapshot.cards 数组中，而不是 snapshot.body 中。

可选查询参数可以组合在同一个请求里。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

id string

Facebook 广告 ID

示例：

702369045530963

url string

Facebook 广告网址

示例：

https://www.facebook.com/ads/library?id=1185617869915074

get_transcript boolean

获取广告的文字记录。仅当视频时长低于 2 分钟时才有效。

示例：

false

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/ad?id=702369045530963&url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%3Fid%3D1185617869915074&get_transcript=false&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/ad?id=702369045530963&url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%3Fid%3D1185617869915074&get_transcript=false&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/ad?id=702369045530963&url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%3Fid%3D1185617869915074&get_transcript=false&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/ad?id=702369045530963&url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%3Fid%3D1185617869915074&get_transcript=false&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/ad?id=702369045530963&url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%3Fid%3D1185617869915074&get_transcript=false&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/ad?id=702369045530963&url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%3Fid%3D1185617869915074&get_transcript=false&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());


              {
  "adArchiveID": 1185617869915074,
  "endDate": 1750316400,
  "isAAAEligible": false,
  "isActive": true,
  "pageID": 15087023444,
  "pageName": "Nike",
  "politicalCountries": [],
  "reachEstimate": null,
  "snapshot": {
    "ad_creative_id": 1809449763118705,
    "cards": [],
    "body_translations": {},
    "byline": null,
    "caption": "fb.com",
    "cta_text": "Learn more",
    "dynamic_item_flags": {},
    "dynamic_versions": null,
    "edited_snapshots": [],
    "effective_authorization_category": "NONE",
    "event": [],
    "extra_images": [
      {
        "original_image_handle": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508997149_744746594672572_3057533797808431470_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eKgqs7-b06UQ7kNvwGSYm41&_nc_oc=Adn...",
        "resized_image_handle": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508997149_744746594672572_3057533797808431470_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eKgqs7-b0..."
      }
    ],
    "extra_links": [
      "https://www.nike.com.ar/"
    ],
    "extra_texts": [],
    "extra_videos": [],
    "instagram_shopping_products": [],
    "display_format": "image",
    "title": "6 cuotas sin interés",
    "...": "32 more fields"
  },
  "totalActiveTime": 23488,
  "spend": null,
  "startDate": 1750316400,
  "publisherPlatform": [
    "facebook"
  ],
  "url": "https://www.facebook.com/ads/library?id=1185617869915074",
  "startDateString": "2025-06-19T07:00:00.000Z",
  "endDateString": "2025-06-19T07:00:00.000Z",
  "aaa_info": null
}


              {
  "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."
  }
}