search_meta_ads

Active

declared in 1.0.0

Structured Meta (Facebook/Instagram) Ad Library pull — use when you know exactly WHAT to fetch: a keyword (query) OR one advertiser (companyName / pageId). Returns compact JSON {page_name, body, cta, link, dates, media} per ad. For open-ended research that needs judgment across platforms, use research_ads instead. Spends ScrapeCreators credits (~1–2).

Parameters schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "max ads returned (1–25, default 8)"
    },
    "query": {
      "type": "string",
      "description": "keyword search across ALL advertisers (use INSTEAD of companyName/pageId)"
    },
    "pageId": {
      "type": "string",
      "description": "one advertiser’s ads by Facebook page id (most precise)"
    },
    "status": {
      "enum": [
        "ACTIVE",
        "INACTIVE",
        "ALL"
      ],
      "type": "string",
      "description": "ACTIVE = currently running; default ALL (includes proven past winners)"
    },
    "country": {
      "type": "string",
      "description": "2-letter code or 'ALL' (default ALL)"
    },
    "mediaType": {
      "enum": [
        "ALL",
        "IMAGE",
        "VIDEO",
        "MEME",
        "IMAGE_AND_MEME",
        "NONE"
      ],
      "type": "string",
      "description": "filter by creative type (default ALL)"
    },
    "companyName": {
      "type": "string",
      "description": "one advertiser’s ads by brand name"
    }
  }
}

What this tool wraps· 0 endpoints

min confidence0.70 0.50

No endpoints wrapped at confidence ≥ 0.50.

Parent server

Hermoso

https://github.com/hermoso-ai/hermoso

1/7 registries

View full server →