SocialCrawl
View more

Ad intelligence

Search advertisers and read their ads across the public ad libraries.

See which ads a brand is running and how its campaigns change. You search the public ad libraries through one key, and every library answers in the same shape.

Start with a template

Run your first request

Resolve a brand name to its Google advertiser accounts. Each result carries the advertiser id you need for the next call.

cURL
curl "https://www.socialcrawl.dev/v1/google/adlibrary/advertisers/search?query=lululemon&region=CA" \
  -H "x-api-key: sc_your_key_here"
Python
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/google/adlibrary/advertisers/search",
    params={"query": "lululemon", "region": "CA"},
    headers={"x-api-key": "sc_your_key_here"},
)
for row in response.json()["data"]["items"]:
    print(row["author"]["id"], row["author"]["display_name"])
TypeScript
const response = await fetch(
  "https://www.socialcrawl.dev/v1/google/adlibrary/advertisers/search?query=lululemon&region=CA",
  { headers: { "x-api-key": "sc_your_key_here" } },
);
const { data } = await response.json();
for (const row of data.items) console.log(row.author.id, row.author.display_name);

region is a two-letter country code and defaults to the US. This call costs 5 credits. Price the call first, for free, with GET /v1/utility/estimate?id=google/adlibrary/advertisers/search&query=lululemon. Endpoint pricing lists every ad library call.

Each result is one advertiser account. A global brand often has one per country, so on 22/11/2026 this search returned a Hong Kong and a Canadian entity. Pick the one for the market you study and pass its id, which starts with AR, to the ads call. On Meta, facebook/adlibrary/search/companies finds the advertiser's page and facebook/adlibrary/company/ads lists its ads. LinkedIn takes a keyword or a company on linkedin/ads/search.

Meta publishes spend and reach for political and issue ads only. A commercial ad carries neither, so plan your analysis around creative, dates and placements.

How it works

  1. Resolve the brand to an advertiser with the library's advertiser search.
  2. List that advertiser's ads, for example with GET /v1/google/company/ads?advertiser_id=....
  3. Aggregate the libraries into one table, as the cookbook does in one parallel run.

Why teams choose SocialCrawl

Several libraries, one shape. The Meta, Google and LinkedIn libraries sit behind one key, and Choosing endpoints names the keyword and advertiser call for each.

The words in a video ad. The spoken script of a Meta video ad has its own call, GET /v1/facebook/adlibrary/ad/transcript, and the transcripts page says how it is priced.

Try it free first. The Facebook Ad Library search tool runs the same search in your browser before you write any code.

On this page