Facebook Ad Library Search for Companies

Searches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library endpoints.

1 credit / request

Open Playground

GET /v1/facebook/adLibrary/search/companies Try it

Facebook Ad Library Search for Companies
GET /v1/facebook/adLibrary/search/companies

Searches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library endpoints.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/facebook/adLibrary/search/companies?query=nike&llm_friendly=true

Parameters:
- query (query · string · required) = nike
- 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.

Searches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library endpoints. Each result includes page_id, name, category, likes, verification status, and Instagram details like ig_username and ig_followers.

Required params: query.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

query string required

Keyword to search for

Example:

nike

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/search/companies?query=nike&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/companies?query=nike&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/companies?query=nike&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/companies?query=nike&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/companies?query=nike&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/companies?query=nike&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": [
    {
      "page_id": "51212153078",
      "category": "Product/service",
      "image_uri": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.30808-1/387181570_863325755161415_3589774989337788111_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=103&ccb=1-7&_nc_sid=418b77&_nc_ohc=SzL6Lox...",
      "likes": 41136495,
      "verification": "BLUE_VERIFIED",
      "name": "Nike Football",
      "country": null,
      "entity_type": "PERSON_PROFILE",
      "ig_username": "nikefootball",
      "ig_followers": 46451228,
      "ig_verification": true,
      "page_alias": "nikefootball",
      "page_is_deleted": false
    }
  ]
}


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