ApiToll Facebook Advertiser Ads

Facebook ads from a specific advertiser by brand name — every live and recent ad a brand runs across Facebook, Instagram, Messenger and Threads, isolated to that ONE advertiser (filters out the stray pages a name search pulls in; echoes resolvedPage to verify). Returns the full ad creative (headline, body copy, CTA + destination link, image and video URLs), run dates, and platform mix. No Meta login. Competitor ad intelligence for AI agents.

Resource: ads.apitoll.cloud/v1/ads/facebook/advertiser

Network: eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x4ce88238F669d04351937420C931988e464a975a

Payment methods: — · Last validation: 2026-09-14 11:17:55.78+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "queryParams": {
        "type": "object",
        "required": [
          "advertiser"
        ],
        "properties": {
          "limit": {
            "type": "integer",
            "maximum": 60,
            "minimum": 1,
            "description": "Max ads to return (1-60)."
          },
          "period": {
            "enum": [
              "",
              "last24h",
              "last7d",
              "last14d",
              "last30d"
            ],
            "type": "string",
            "description": "Limit to ads active in this window. Blank = all time."
          },
          "ad_type": {
            "enum": [
              "all",
              "political_and_issue_ads",
              "housing_ads",
              "employment_ads",
              "credit_ads",
              "financial_products_and_services_ads"
            ],
            "type": "string",
            "description": "Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent)."
          },
          "country": {
            "type": "string",
            "description": "Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US."
          },
          "sort_by": {
            "enum": [
              "impressions_desc",
              "most_recent"
            ],
            "type": "string",
            "description": "most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended)."
          },
          "platforms": {
            "type": "string",
            "description": "Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all."
          },
          "advertiser": {
            "type": "string",
            "description": "Brand / advertiser NAME (e.g. Nike, Spotify, Samsung). Resolves to the dominant matching Facebook page. Defaults to a demo brand if omitted."
          },
          "media_type": {
            "enum": [
              "all",
              "image",
              "video",
              "meme",
              "image_and_meme",
              "none"
            ],
            "type": "string",
            "description": "Creative format filter."
          },
          "active_status": {
            "enum": [
              "all",
              "active",
              "inactive"
            ],
            "type": "string",
            "description": "Filter by whether the ad is still running."
          },
          "resolve_advertiser": {
            "type": "boolean",
            "description": "Also resolve the advertiser’s page identity (verified status, categories, profile pic). Slower. Default false."
          }
        }
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object",
        "properties": {
          "ads": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "pageId": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "ctaText": {
                  "type": "string"
                },
                "ctaType": {
                  "type": "string"
                },
                "linkUrl": {
                  "type": "string"
                },
                "bodyText": {
                  "type": "string"
                },
                "isActive": {
                  "type": "boolean"
                },
                "pageName": {
                  "type": "string"
                },
                "imageUrls": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "scrapedAt": {
                  "type": "string"
                },
                "sourceUrl": {
                  "type": "string"
                },
                "startDate": {
                  "type": "number"
                },
                "adArchiveId": {
                  "type": "string"
                },
                "daysRunning": {
                  "type": "number"
                },
                "linkUrlType": {
                  "type": "string"
                },
                "displayFormat": {
                  "type": "string"
                },
                "templatedText": {
                  "type": "boolean"
                },
                "mediaExpiresAt": {
                  "type": "string"
                },
                "publisherPlatform": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "asOf": {
            "type": "string"
          },
          "count": {
            "type": "number"
          },
          "query": {
            "type": "object",
            "properties": {
              "advertiser": {
                "type": "string"
              }
            }
          },
          "source": {
            "type": "object",
            "properties": {
              "via": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            }
          },
          "country": {
            "type": "string"
          },
          "resolvedPage": {
            "type": "object",
            "properties": {
              "pageId": {
                "type": "string"
              },
              "pageName": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x4ce88238F669d04351937420C931988e464a975a",
        "amount": "30000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 150
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x4ce88238F669d04351937420C931988e464a975a",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "30000"
    },
    {
      "raw": {
        "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "extra": {
          "feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"
        },
        "payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
        "amount": "30000",
        "scheme": "exact",
        "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
        "maxTimeoutSeconds": 150
      },
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "amountAtomic": "30000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.