Ads | Stophy

Search the public ad libraries of Meta, Google, TikTok, LinkedIn, Pinterest, Microsoft, and Snapchat. Get each ad’s creative and copy. See every field in the Ads reference, or try it in the playground.

Search ads in the Meta ad library

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.meta.ads.search({ query: "nike", limit: 20 });
console.log(result.data.ads);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.meta.ads.search(query="nike", limit=20)
print(result["data"]["ads"])

curl -X POST https://api.stophy.dev/v1/meta/ads/search \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"nike","limit":20}'

stophy meta ads search nike --limit 20

The response:

{
  "success": true,
  "data": {
    "ads": [
      {
        "id": "abc123",
        "url": "https://example.com/",
        "page": {
          "id": "abc123",
          "name": "Example title",
          "url": "https://example.com/",
          "avatar": "https://example.com/image.jpg",
          "categories": [
            "example"
          ],
          "likes": 1234
        },
        "isActive": false,
        "firstShownAt": "2026-09-28T12:00:00.000Z",
        "lastShownAt": "2026-09-28T12:00:00.000Z",
        "platforms": [
          "example"
        ],
        "format": "example",
        "text": "A short, readable summary of the result.",
        "link": {
          "url": "https://example.com/",
          "title": "Example title",
          "description": "A short, readable summary of the result.",
          "caption": "example"
        },
        "cta": {
          "text": "A short, readable summary of the result.",
          "type": "example"
        },
        "images": [
          {
            "url": "https://example.com/",
            "caption": "example",
            "alt": "example"
          }
        ],
        "videos": [
          {
            "url": "https://example.com/",
            "thumbnail": "https://example.com/image.jpg"
          }
        ],
        "cards": [
          {
            "text": "A short, readable summary of the result.",
            "link": {
              "url": "https://example.com/",
              "title": "Example title",
              "description": "A short, readable summary of the result.",
              "caption": "example"
            },
            "cta": {
              "text": "A short, readable summary of the result.",
              "type": "example"
            },
            "image": "https://example.com/image.jpg",
            "video": {
              "url": "https://example.com/",
              "thumbnail": "https://example.com/image.jpg"
            }
          }
        ],
        "versions": 1,
        "categories": [
          "example"
        ],
        "paidBy": "example",
        "spend": {
          "min": 1,
          "max": 1
        },
        "currency": "USD",
        "impressions": {
          "min": 1,
          "max": 1
        },
        "reach": {
          "min": 1,
          "max": 1
        },
        "countries": [
          "example"
        ]
      }
    ]
  },
  "creditsUsed": 2,
  "requestId": "a4b7b5a5-4183-4cd8-b4fb-d9fd4632efe2"
}

Endpoints

Endpoint	Cost
Search ads in the Meta ad library	2 credits per 10 items, at least 2 credits
Get the ads a Facebook page runs	2 credits per 10 items, at least 2 credits
Get a Meta ad’s details	2 credits
Find advertisers in the Google ads library	1 credit
Search ads in the Google ads library	1 credit per 25 items, at least 1 credit
Get a Google ad’s details	1 credit
Search ads in the TikTok ad library	1 credit per 12 items, at least 1 credit
Get a TikTok ad’s details and reach	1 credit
Search ads in the LinkedIn ad library	2 credits per 24 items, at least 2 credits
Get a LinkedIn ad’s details	2 credits
Search ads in the Pinterest ads library	1 credit per 24 items, at least 1 credit
Get a Pinterest ad’s details	1 credit
Search ads in the Microsoft ads library	1 credit
Get a Microsoft ad’s details	1 credit
Find advertisers in the Microsoft ads library	1 credit
Search ads in the Snapchat ads library	1 credit per 10 items, at least 1 credit
Get a Snapchat ad’s details	1 credit

More ways to call it

Search ads in the Google ads library

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.google.ads.search({ domain: "nike.com", limit: 25 });
console.log(result.data.ads);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.google.ads.search(domain="nike.com", limit=25)
print(result["data"]["ads"])

curl -X POST https://api.stophy.dev/v1/google/ads/search \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"domain":"nike.com","limit":25}'

stophy google ads search --domain nike.com --limit 25

Search ads in the TikTok ad library

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.tiktok.ads.search({ query: "adidas", limit: 12 });
console.log(result.data.ads);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.tiktok.ads.search(query="adidas", limit=12)
print(result["data"]["ads"])

curl -X POST https://api.stophy.dev/v1/tiktok/ads/search \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"adidas","limit":12}'

stophy tiktok ads search --query adidas --limit 12

Every ad library needs a keyword, an advertiser, or both. See each endpoint’s reference for what it accepts.