search_ads.py

#!/usr/bin/env python3
"""
AdScrape — search and paginate Meta Ad Library results.

Docs:  https://www.adscrape.in/docs
Signup: https://www.adscrape.in/signup

Usage:
  export ADSCRAPE_API_KEY="sk_live_..."
  python search_ads.py nike US
"""

from __future__ import annotations

import json
import os
import sys

import httpx

BASE_URL = "https://api.adscrape.in"
API_KEY = os.environ.get("ADSCRAPE_API_KEY", "")


def main() -> None:
    if not API_KEY:
        print("Set ADSCRAPE_API_KEY (get one at https://www.adscrape.in/settings/api-keys)", file=sys.stderr)
        sys.exit(1)

    query = sys.argv[1] if len(sys.argv) > 1 else "nike"
    country = sys.argv[2] if len(sys.argv) > 2 else "US"

    client = httpx.Client(
        base_url=BASE_URL,
        headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
        timeout=120.0,
    )

    page = client.post(
        "/api/v1/search",
        json={"query": query, "country": country, "max_results": 50},
    ).json()

    total = 0
    while True:
        ads = page.get("ads") or []
        total += len(ads)
        print(f"page: +{len(ads)} ads (running total: {total})")

        for ad in ads[:3]:
            print(f"  - {ad.get('page_name', '?')}: {ad.get('ad_archive_id')}")

        if not page.get("has_more"):
            break

        page = client.post(
            "/api/v1/search/next",
            json={
                "session_token": page["session_token"],
                "page_size": 100,
            },
        ).json()

    print(json.dumps({"query": query, "country": country, "ads_collected": total}, indent=2))


if __name__ == "__main__":
    main()