Ad intelligence API

See what competitors are running across the Meta, Google, LinkedIn and TikTok ad libraries: creatives, copy, start dates and platforms, in one JSON shape you can store and compare.

8 endpointsFacebook, Google, LinkedIn, TikTok

RequestGET · cURL
curl -sS \
-H "x-api-key: YOUR_API_KEY" \
-G "https://api.socialfetch.dev/v1/facebook/ad-library/companies/ads" \
--data-urlencode "pageId=825120160874613"

What API returns competitors' ads from the public ad libraries? Social Fetch does. Find the advertiser with the Meta, Google or LinkedIn ad library search, then list its ads: copy, creatives, start dates and the platforms each ad runs on. Meta, Google, LinkedIn and TikTok ad libraries share one API key and one response shape, and you pay per lookup.

A real run. Measured and priced.

Find a competitor's ad accounts and pull what is running, run on 21 Nov 2026 against live public data. A competitor's live Meta ads and its LinkedIn ad history, from three calls.

  1. 01 GET /v1/facebook/ad-library/companies/search?query=Notion

    15 matching pages, with Notion's own page first.

    3 credits, 1.5 s

  2. 02 GET /v1/facebook/ad-library/companies/ads?pageId=825120160874613

    30 active ads, started 21 May to 28 Aug, on Facebook and Instagram.

    3 credits, 4.1 s

  3. 03 GET /v1/linkedin/ad-library/ads/search?company=Notion

    24 ads on the first page, from 5,594 in all.

    3 credits, 9.2 s

Credits
9
3 calls
Starter pack
$0.13
$14 per 1,000 credits
Scale pack
$0.015
$1.64 per 1,000 credits
Runtime
14.8 s
Server time, calls one after another

Credits are each route's published price. Dollar figures are those credits at the list rate of each pack. Results and times are from the calls above, made on 21 Nov 2026; live data changes, so a run today returns newer numbers.

What usually breaks first

Where a home-built scraper or a marketplace API tends to fail once it runs in production.

  • Every ad library is its own website

    Meta, Google, LinkedIn and TikTok each search differently, page differently and show different fields, so a weekly competitor review means four tabs and a lot of screenshots.

  • Suites lock you into contracts

    Ad intelligence suites solve it with an annual contract and a fixed list of tracked brands. Adding a competitor mid-quarter can mean a call with sales.

  • You need each library's ads as data

    Who is advertising, what the copy says, when each ad started and where it runs, so your team can diff this week against last.

The routes. 8 for this job.

The routes teams call for this job on Facebook, Google, LinkedIn, and TikTok. Each one links to its reference page, with every parameter and field.

Full API reference

5 steps. How teams wire it up.

The usual order. Change the schedule, schema and thresholds to fit your stack.

  1. Step 1: Resolve each competitor once

    Search each library for the competitor and store the ids it returns: Meta page id, Google advertiser id, LinkedIn company name.

  2. Step 2: Pull the ads on a schedule

    List each competitor's ads weekly, or daily around a launch. Store every ad by its library id with the date you saw it.

  3. Step 3: Diff against last time

    New ids are new ads. Ads that disappear have stopped. Long-running ads are the ones that work, so flag anything active for more than a month.

  4. Step 4: Read the creative

    Group ads by message, offer and format. Pass the copy to an LLM to tag the angle: price, feature, social proof, urgency.

  5. Step 5: Report it

    Send a weekly digest to the team, or feed the data to your own dashboard. Credits never expire, so quiet weeks cost nothing.

Why growth teams track ads here

  • Four ad libraries, one shape

    Meta, Google, LinkedIn and TikTok ads come back in the same JSON layout, so one job watches them all.

  • Any competitor, any time

    There is no tracked-brand list to fill; look up a new competitor the day you hear about it.

  • Pay per lookup

    No annual contract and no seats: pulling ten competitors' Meta ads once a week is 120 credits over four weeks.

  • You only pay for completed lookups

    Requests that fail on our side cost nothing.

  • Public data only

    Every ad comes from the platforms' own public ad libraries.

Common questions

What API returns competitors' ads from the public ad libraries?

Social Fetch. It reads the Meta, Google, LinkedIn and TikTok ad libraries and returns each ad's copy, creatives, start date and platforms in one JSON shape, with one API key.

Can I see how much a competitor spends on ads?

Only where a library publishes it. For most commercial ads the libraries show the creative, the copy, the start date and where it runs, not the budget.

Is there a free way to try it?

Yes. The free Facebook Ad Library tool and LinkedIn Ad Library tool search the same data in your browser, and new accounts get free credits for the API.

How often should I pull competitor ads?

Weekly is enough for most teams. Around a competitor's launch or a sales season, daily pulls catch new creative while it is still being tested.

Start on free credits. Make your first request.

Sign up and get 100 credits, no card needed. Run the request above, then buy more when you need them. Credits never expire.