# Ad intelligence (/docs/use-cases/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 - [Competitor ads template](/docs/templates.md#commerce-and-reviews): See the ads a competitor is running, as a ready program you can download. - [Ad library aggregation](/docs/recipes/ads-library-aggregation.md): Pull a brand ## 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** ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/google/adlibrary/advertisers/search?query=lululemon®ion=CA" \ -H "x-api-key: sc_your_key_here" ``` **Python** ```python title="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** ```typescript title="TypeScript" const response = await fetch( "https://www.socialcrawl.dev/v1/google/adlibrary/advertisers/search?query=lululemon®ion=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](/docs/endpoint-pricing.md) 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](/docs/choosing-endpoints.md#ad-libraries) 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](/docs/transcripts.md#transcripts-cost-the-same-at-any-length) says how it is priced. **Try it free first.** The [Facebook Ad Library search](/tools/facebook-ad-library-search) tool runs the same search in your browser before you write any code. ## Related - [Competitive intelligence](/docs/use-cases/competitive-intelligence.md): Track competitors - [Brand monitoring](/docs/use-cases/brand-monitoring.md): Hear every mention of a brand across platforms. - [Ad intelligence API](/solutions/ad-intelligence-api): How teams use SocialCrawl to study paid campaigns.