Skip to content

Ad library lookup API for Meta, Google and LinkedIn

Send an advertiser name or domain and pick a library. Get back the ads that advertiser is running now, with creative text, format, start date, platforms and landing URL. Each lookup costs 10 credits.

10 creditsSocialCSV bulkMCPNew
POST/v1/ad-library-lookup
{
  "success": true,
  "data": {
    "platform": "meta",
    "query": "northwind.example",
    "advertiser": "Northwind Coffee Roasters",
    "ads": [
      {
        "id": "ad_1029384756",
        "creative_text": "Three new single origins, roasted to order. Free shipping on your first bag.",
        "format": "video",
        "start_date": "2026-10-14",
        "platforms": [
          "facebook",
          "instagram"
        ],
        "landing_url": "https://northwind.example/fall-lineup"
      },
      {
        "id": "ad_1029384811",
        "creative_text": "Coffee for the office, delivered every two weeks. Get a wholesale quote.",
        "format": "image",
        "start_date": "2026-08-03",
        "platforms": [
          "facebook"
        ],
        "landing_url": "https://northwind.example/wholesale"
      }
    ]
  },
  "meta": {
    "credits_used": 10,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

advertiserAdvertiserThe advertiser that was matched to the name or domain you sent.
platformAd libraryWhich library the ads came from: meta, google or linkedin.
ads[].creative_textCreative textThe copy shown in the ad.
ads[].formatFormatThe ad format, such as image or video.
ads[].start_dateStart dateThe date the ad began running.
ads[].platformsPlatformsWhere the ad is delivered within that library, for example Facebook and Instagram.
ads[].landing_urlLanding URLThe page the ad sends people to.
[02/Capabilities]

What Ad Library Lookup does

01

Three public ad libraries, one schema

Set platform to meta, google or linkedin and name the advertiser. Ads from all three libraries come back with the same fields, so you can compare a company's activity across them.

02

Creative text and format

Each ad includes its copy and its format, such as image or video. That is the raw material for a swipe file or a messaging comparison.

03

Start dates that show staying power

Every ad carries the date it started running. Ads that have been live for months are usually the ones an advertiser keeps funding, which makes the start date a useful sorting key.

04

Landing URLs for the next step

You see where each ad sends its clicks. Pass that URL to Website Scraper to read the landing page, or group ads by destination to map a campaign.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/ad-library-lookup10 credits

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/ad-library-lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"meta","advertiser":"northwind.example"}'
Endpoint
POST /v1/ad-library-lookup
Base URL
https://api.1lookup.dev
Request
platformadvertiser
Price
10 credits
Coverage
Meta, Google and LinkedIn ad libraries
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Research competitor messaging

Look up the companies you compete with and read the offers, hooks and formats they are paying to show right now.

Qualify accounts for ad services

Agencies and ad tech sellers can check whether a prospect is advertising at all, in which libraries, and with what kind of creative before the first call.

Track new campaigns

Run the same lookup weekly with fresh: true and compare against last week's result to catch new ads and new landing pages.

Brief your creative team

Collect live examples from a category and hand them over as reference, each with the date it started and the page it points to.

Ads are read from public ad libraries, and you are responsible for using the results in line with those platforms' terms and applicable law, including privacy law.

[06/Cost]

10 credits

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 lookups
Starter $29/mo$4.83$48.33
Growth $99/mo$3.96$39.60
Pro $299/mo$3.32$33.22
Scale $799/mo$2.66$26.63
[07/FAQ]

Ad Library Lookup questions

Which ad libraries are covered?

The Meta ad library, which includes Facebook and Instagram, the Google ad library and the LinkedIn ad library. TikTok's ad library is not covered.

How much does a lookup cost?

10 credits per lookup, and one lookup covers one advertiser in one library. Checking the same company in all three takes three lookups. If no matching advertiser is found, you are not charged.

Does it show spend, impressions or targeting?

No. The response covers creative text, format, start date, platforms and landing URL. Budget, reach and audience targeting are not part of what this product returns.

Does it include ads that have stopped running?

No. It returns the ads that are live when the lookup runs. To keep a history, schedule regular lookups and store each result yourself.

Should I search by name or by domain?

Either works. A domain is usually the more precise input when several advertisers share a similar name. The advertiser field in the response shows which advertiser was matched.

[ Validate ][ Enrich ]
[Get started]

Run Ad Library Lookup on your own data

Starter is $29 a month for 6,000 credits, enough for 600 lookups a month.

[ Screen ][ Scrape ]