{
  "generated_at": "2026-04-24T15:01:35.625676+00:00",
  "slug": "www-hirescrape-com-api-tools-fb-ad-library",
  "title": "Hirescrape \u00b7 Facebook Ad Library Scraper",
  "url": "https://www.hirescrape.com/api/tools/fb-ad-library",
  "category": "data",
  "summary": "Search and retrieve Facebook and Instagram ads from Meta's Ad Library with filtering by advertiser, keyword, country, and ad type.",
  "seo": {
    "title": "Facebook Ad Library API | Ad Scraper | x402 | Hirescrape",
    "description": "Scrape Facebook and Instagram ads from Meta Ad Library via x402 micropayments. Search by keyword, company, or country. Filter political ads, retrieve creative details, and track advertiser spend. Base network, 0.05 USDC."
  },
  "use_cases": [
    "Monitor competitor advertising creative and spend patterns",
    "Research political ad disclosure data for journalism",
    "Build marketing intelligence dashboards with historical ad archives"
  ],
  "ideal_buyer": "Marketing analysts, competitive intelligence teams, and researchers needing programmatic access to Meta's public ad transparency data.",
  "example_prompt": "Find all active ads from Nike in the United States from the last 30 days",
  "example_request_body": {
    "ad_type": "All",
    "country": "US",
    "companyName": "Nike"
  },
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "normal",
    "ratio": 2.5,
    "median_category_atomic": 20000
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0xb5194a98dbdbb7028b585db26b972e7f0f3f826a",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "50000",
      "max_timeout_seconds": 60,
      "verified": false,
      "hints": {
        "input": {
          "body": {
            "type": "object",
            "title": "Facebook Ad Library Scraper",
            "required": [
              "mode"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Object ID (ad / highlight / etc)."
              },
              "url": {
                "type": "string",
                "description": "Full URL of the target object."
              },
              "mode": {
                "enum": [
                  "ad",
                  "search_ads",
                  "company_ads",
                  "search_companies"
                ],
                "type": "string",
                "default": "ad",
                "description": "Which endpoint to call. Options: ad, search_ads, company_ads, search_companies."
              },
              "trim": {
                "type": "boolean",
                "description": "Return a condensed response."
              },
              "limit": {
                "type": "integer",
                "default": 20,
                "maximum": 500,
                "minimum": 1,
                "description": "Max items to collect (applies to paginated modes)."
              },
              "query": {
                "type": "string",
                "description": "Search keyword."
              },
              "cursor": {
                "type": "string",
                "description": "Pagination cursor."
              },
              "pageId": {
                "type": "string",
                "description": "Page or ad-library page ID."
              },
              "status": {
                "type": "string",
                "description": "ACTIVE / INACTIVE / ALL."
              },
              "ad_type": {
                "type": "string",
                "description": "All or political/issue ads."
              },
              "country": {
                "type": "string",
                "description": "Country code (e.g. US, GB)."
              },
              "sort_by": {
                "type": "string",
                "description": "Sort key (depends on endpoint)."
              },
              "end_date": {
                "type": "string",
                "description": "End date (YYYY-MM-DD)."
              },
              "language": {
                "type": "string",
                "description": "2-letter language code."
              },
              "media_type": {
                "type": "string",
                "description": "IMAGE / VIDEO / MEME."
              },
              "start_date": {
                "type": "string",
                "description": "Start date (YYYY-MM-DD)."
              },
              "companyName": {
                "type": "string",
                "description": "Company name."
              },
              "search_type": {
                "type": "string",
                "description": "Keyword or exact phrase search."
              },
              "get_transcript": {
                "type": "boolean",
                "description": "Include transcript in the response."
              }
            },
            "description": "Meta Ad Library: search ads by keyword or company, get single-ad details, filter by country, status, media type, date range."
          },
          "type": "http",
          "method": "POST",
          "schema": {
            "type": "object",
            "title": "Facebook Ad Library Scraper",
            "required": [
              "mode"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Object ID (ad / highlight / etc)."
              },
              "url": {
                "type": "string",
                "description": "Full URL of the target object."
              },
              "mode": {
                "enum": [
                  "ad",
                  "search_ads",
                  "company_ads",
                  "search_companies"
                ],
                "type": "string",
                "default": "ad",
                "description": "Which endpoint to call. Options: ad, search_ads, company_ads, search_companies."
              },
              "trim": {
                "type": "boolean",
                "description": "Return a condensed response."
              },
              "limit": {
                "type": "integer",
                "default": 20,
                "maximum": 500,
                "minimum": 1,
                "description": "Max items to collect (applies to paginated modes)."
              },
              "query": {
                "type": "string",
                "description": "Search keyword."
              },
              "cursor": {
                "type": "string",
                "description": "Pagination cursor."
              },
              "pageId": {
                "type": "string",
                "description": "Page or ad-library page ID."
              },
              "status": {
                "type": "string",
                "description": "ACTIVE / INACTIVE / ALL."
              },
              "ad_type": {
                "type": "string",
                "description": "All or political/issue ads."
              },
              "country": {
                "type": "string",
                "description": "Country code (e.g. US, GB)."
              },
              "sort_by": {
                "type": "string",
                "description": "Sort key (depends on endpoint)."
              },
              "end_date": {
                "type": "string",
                "description": "End date (YYYY-MM-DD)."
              },
              "language": {
                "type": "string",
                "description": "2-letter language code."
              },
              "media_type": {
                "type": "string",
                "description": "IMAGE / VIDEO / MEME."
              },
              "start_date": {
                "type": "string",
                "description": "Start date (YYYY-MM-DD)."
              },
              "companyName": {
                "type": "string",
                "description": "Company name."
              },
              "search_type": {
                "type": "string",
                "description": "Keyword or exact phrase search."
              },
              "get_transcript": {
                "type": "boolean",
                "description": "Include transcript in the response."
              }
            },
            "description": "Meta Ad Library: search ads by keyword or company, get single-ad details, filter by country, status, media type, date range."
          },
          "bodyType": "json"
        },
        "output": {
          "type": "json",
          "schema": {
            "type": "object",
            "required": [
              "items"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Scraped items. Shape varies per tool \u00e2\u0080\u0094 see each tool's outputSample for a concrete example."
              },
              "runId": {
                "type": "string",
                "description": "Run ID for debugging/audit."
              },
              "payment": {
                "type": "object",
                "description": "Settlement summary (protocol, amount, currency)."
              },
              "duration": {
                "type": "integer",
                "description": "Run duration in seconds."
              }
            }
          },
          "example": {
            "items": [
              {
                "note": "Shape varies per tool \u00e2\u0080\u0094 see each tool's docs for fields."
              }
            ],
            "runId": "sc_example",
            "payment": {
              "amount": "0.040000",
              "currency": "USD",
              "protocol": "x402"
            },
            "duration": 4
          }
        }
      }
    }
  ],
  "duplicate_cluster_id": "data-cl-25977fd2b5ce",
  "origin": {
    "slug": "www-hirescrape-com",
    "host": "www.hirescrape.com",
    "title": "Hirescrape \u2014 Pay-per-call scraper API for AI agents",
    "description": "Pay-per-call web scrapers for AI agents. 28 tools across Reddit, 8-board job search (LinkedIn \u00b7 Indeed \u00b7 Glassdoor \u00b7 Google Jobs \u00b7 +5), TikTok \u00b7 Douyin \u00b7 Bilibili, cross-platform trend research, social media, and ad libraries. No API keys. Agent wallets settle USDC on Tempo or Base via x402 + MPP.",
    "url": "https://www.hirescrape.com",
    "og_image": "https://www.hirescrape.com/opengraph-image?c645bc0ba1f3236d",
    "favicon": "https://hirescrape.com/favicon.ico"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/www-hirescrape-com-api-tools-fb-ad-library",
    "url": "https://x402all.com/resource/www-hirescrape-com-api-tools-fb-ad-library",
    "name": "Hirescrape \u00b7 Facebook Ad Library Scraper",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/www-hirescrape-com-api-tools-fb-ad-library",
      "@type": "Offer",
      "price": "0.05",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "0.050000",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "paymentNetwork",
          "value": "base"
        },
        {
          "@type": "PropertyValue",
          "name": "paymentAsset",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ]
    },
    "sameAs": "https://www.hirescrape.com/api/tools/fb-ad-library",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/www-hirescrape-com",
      "url": "https://www.hirescrape.com",
      "name": "Hirescrape \u2014 Pay-per-call scraper API for AI agents",
      "@type": "Organization"
    },
    "identifier": "www-hirescrape-com-api-tools-fb-ad-library",
    "description": "Scrape Facebook and Instagram ads from Meta Ad Library via x402 micropayments. Search by keyword, company, or country. Filter political ads, retrieve creative details, and track advertiser spend. Base network, 0.05 USDC.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=www-hirescrape-com-api-tools-fb-ad-library",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "data"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=www-hirescrape-com-api-tools-fb-ad-library"
}