DocsGet an API key

Ad intelligence

See what a competitor is advertising. Search the public ad libraries, list an advertiser’s ads and read each creative, in one Ad shape across platforms.

Start with 100 free creditsRead the docs

The recipe

The calls, in order. Tap a platform to see its endpoint and parameters.

  1. 1

    Search advertisers

    1 credit per call

    Find the advertiser in the ad library.

    GET/v1/{platform}/advertisers/search→Advertiser[]
    FacebookGoogle
  2. 2

    An advertiser's ads

    1–2 credits per call

    List their ads, active and past.

    GET/v1/{platform}/ads→Ad[]
    TikTokFacebookLinkedInGoogle
  3. 3

    Ad

    1–2 credits per call

    Read one ad in full: copy, media, landing page, dates.

    GET/v1/{platform}/ad→Ad
    TikTokFacebookLinkedInGoogle
  4. 4

    Search ads

    1–2 credits per call

    Search ads by keyword across advertisers.

    GET/v1/{platform}/ads/search→Ad[]
    TikTokFacebookLinkedIn
What it costs
6credits

One competitor on Facebook and Google, 2 pages of ads each.

Calculated from the live price list. Failed calls are refunded.

In code

javascript
const ads = await fetch(`https://api.crawlfeed.dev/v1/facebook/ads/search?q=${encodeURIComponent('running shoes')}`, { headers: { Authorization: `Bearer ${process.env.CRAWLFEED_KEY}` } }).then((r) => r.json());
for (const ad of ads.data) {
  console.log(ad.advertiser.name, ad.headline, ad.is_active, ad.landing_url);
}

Questions

Which ad libraries are covered?

The public ad libraries the recipe lists, resolved from the live catalogue.

Related recipes