Facebook Ad Library Company Ads

Fetches all ads currently running for a specific company from the Meta Ad Library.

1 credit / request

GET /v1/facebook/adLibrary/company/ads Try it

Facebook Ad Library Company Ads
GET /v1/facebook/adLibrary/company/ads

Fetches all ads currently running for a specific company from the Meta Ad Library.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/facebook/adLibrary/company/ads?pageId=367152833370567&companyName=Lululemon&country=ALL&status=ACTIVE&media_type=ALL&language=EN&sort_by=total_impressions&start_date=2025-01-01&end_date=2025-12-31&cursor=AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP&trim=false&llm_friendly=true

Parameters:
- pageId (query · string · optional) = 367152833370567
- companyName (query · string · optional) = Lululemon
- country (query · string · optional) = ALL
- status (query · string · optional) = ACTIVE
- media_type (query · string · optional) = ALL
- language (query · string · optional) = EN
- sort_by (query · string · optional) = total_impressions
- start_date (query · string · optional) = 2025-01-01
- end_date (query · string · optional) = 2025-12-31
- cursor (query · string · optional) = AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP
- trim (query · boolean · optional) = false
- llm_friendly (query · boolean · optional) = true

Overview

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

Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body, images, videos, and display_format. Supports filtering by country, media_type, date range, and language with cursor-based pagination.

Optional query parameters can be combined in a single request.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

pageId string

The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName

Example:

367152833370567

companyName string

The name of the company. Can either use this or pageId

Example:

Lululemon

country string

This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.

Example:

ALL

status string

Status of the ad. Defaults to ACTIVE.

Example:

ACTIVE

enum: ALL, ACTIVE, INACTIVE

media_type string

Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.

Example:

ALL

enum: ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE

language string

Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc

Example:

sort_by string

Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.

Example:

total_impressions

enum: total_impressions, relevancy_monthly_grouped

start_date string

Start date to search for. Format: YYYY-MM-DD

Example:

2025-01-01

end_date string

End date to search for. Format: YYYY-MM-DD

Example:

2025-12-31

cursor string

Cursor to paginate through results

Example:

AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP

trim boolean

Set to true for a trimmed down version of the response

Example:

false

llm_friendly boolean

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

Example:

true


              curl 'https://api.datawake.ai/v1/facebook/adLibrary/company/ads?pageId=367152833370567&companyName=Lululemon&country=ALL&status=ACTIVE&media_type=ALL&language=EN&sort_by=total_impressions&start_date=2025-01-01&end_date=2025-12-31&cursor=AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP&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/company/ads?pageId=367152833370567&companyName=Lululemon&country=ALL&status=ACTIVE&media_type=ALL&language=EN&sort_by=total_impressions&start_date=2025-01-01&end_date=2025-12-31&cursor=AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP&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/company/ads?pageId=367152833370567&companyName=Lululemon&country=ALL&status=ACTIVE&media_type=ALL&language=EN&sort_by=total_impressions&start_date=2025-01-01&end_date=2025-12-31&cursor=AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP&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/company/ads?pageId=367152833370567&companyName=Lululemon&country=ALL&status=ACTIVE&media_type=ALL&language=EN&sort_by=total_impressions&start_date=2025-01-01&end_date=2025-12-31&cursor=AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP&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/company/ads?pageId=367152833370567&companyName=Lululemon&country=ALL&status=ACTIVE&media_type=ALL&language=EN&sort_by=total_impressions&start_date=2025-01-01&end_date=2025-12-31&cursor=AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP&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/company/ads?pageId=367152833370567&companyName=Lululemon&country=ALL&status=ACTIVE&media_type=ALL&language=EN&sort_by=total_impressions&start_date=2025-01-01&end_date=2025-12-31&cursor=AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP&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());


              {
  "results": [
    {
      "ad_archive_id": "1212560900568826",
      "end_date": 1750230000,
      "is_aaa_eligible": false,
      "is_active": true,
      "page_id": "15087023444",
      "page_name": "Nike",
      "political_countries": [],
      "reach_estimate": null,
      "snapshot": {
        "body": {
          "text": "..."
        },
        "branded_content": null,
        "brazil_tax_id": null,
        "byline": null,
        "caption": "fb.com",
        "cards": [],
        "cta_text": "Learn more",
        "cta_type": "LEARN_MORE",
        "country_iso_code": null,
        "current_page_name": "Nike",
        "disclaimer_label": null,
        "display_format": "VIDEO",
        "event": null,
        "images": [],
        "is_reshared": false,
        "link_description": null,
        "link_url": "https://fb.com/canvas_doc/569658969305127",
        "page_categories": [
          "..."
        ],
        "...": "17 more fields"
      },
      "total_active_time": null,
      "spend": null,
      "start_date": 1750143600,
      "publisher_platform": [
        "FACEBOOK"
      ],
      "url": "https://www.facebook.com/ads/library?id=1212560900568826",
      "start_date_string": "2025-06-17T07:00:00.000Z",
      "end_date_string": "2025-06-18T07:00:00.000Z"
    }
  ],
  "cursor": "AQHR2LpCDWOZyAGp-ZKr8rUsapAXh8rWjYuNxVvuU7L0kte18hxkxnaXM3e5jEZNgdcU"
}


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