{
  "x402Version": 2,
  "id": 4758,
  "slug": "4758",
  "resource": "https://ads.apitoll.cloud/v1/ads/facebook/advertiser",
  "description": "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.",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x4ce88238F669d04351937420C931988e464a975a",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "30000",
      "maxTimeoutSeconds": 150
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "30000",
      "maxTimeoutSeconds": 150
    }
  ],
  "outputSchema": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "advertiser": "Nike",
            "country": "US"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "ads": [
              {
                "adArchiveId": "9876543210987654",
                "bodyText": "Gear up for your next run. New arrivals now live.",
                "country": "US",
                "ctaText": "Shop Now",
                "ctaType": "SHOP_NOW",
                "daysRunning": 14,
                "displayFormat": "VIDEO",
                "imageUrls": [
                  "https://scontent.xx.fbcdn.net/v/nike1.jpg"
                ],
                "isActive": true,
                "linkUrl": "https://www.nike.com/launch",
                "linkUrlType": "destination",
                "mediaExpiresAt": "2026-06-29T22:19:28Z",
                "pageId": "15087023444",
                "pageName": "Nike",
                "publisherPlatform": [
                  "FACEBOOK",
                  "INSTAGRAM"
                ],
                "scrapedAt": "2026-06-25T14:32:09Z",
                "sourceUrl": "https://www.facebook.com/ads/library/?q=Nike&search_type=keyword_unordered&country=US",
                "startDate": 1718000000,
                "templatedText": false,
                "title": "Just Do It"
              }
            ],
            "asOf": "2026-06-25T14:32:10Z",
            "count": 12,
            "country": "US",
            "query": {
              "advertiser": "Nike"
            },
            "resolvedPage": {
              "pageId": "15087023444",
              "pageName": "Nike"
            },
            "source": {
              "name": "Facebook Ad Library",
              "via": "Apify"
            }
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "active_status": {
                    "description": "Filter by whether the ad is still running.",
                    "enum": [
                      "all",
                      "active",
                      "inactive"
                    ],
                    "type": "string"
                  },
                  "ad_type": {
                    "description": "Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent).",
                    "enum": [
                      "all",
                      "political_and_issue_ads",
                      "housing_ads",
                      "employment_ads",
                      "credit_ads",
                      "financial_products_and_services_ads"
                    ],
                    "type": "string"
                  },
                  "advertiser": {
                    "description": "Brand / advertiser NAME (e.g. Nike, Spotify, Samsung). Resolves to the dominant matching Facebook page. Defaults to a demo brand if omitted.",
                    "type": "string"
                  },
                  "country": {
                    "description": "Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US.",
                    "type": "string"
                  },
                  "limit": {
                    "description": "Max ads to return (1-60).",
                    "maximum": 60,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "media_type": {
                    "description": "Creative format filter.",
                    "enum": [
                      "all",
                      "image",
                      "video",
                      "meme",
                      "image_and_meme",
                      "none"
                    ],
                    "type": "string"
                  },
                  "period": {
                    "description": "Limit to ads active in this window. Blank = all time.",
                    "enum": [
                      "",
                      "last24h",
                      "last7d",
                      "last14d",
                      "last30d"
                    ],
                    "type": "string"
                  },
                  "platforms": {
                    "description": "Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all.",
                    "type": "string"
                  },
                  "resolve_advertiser": {
                    "description": "Also resolve the advertiser’s page identity (verified status, categories, profile pic). Slower. Default false.",
                    "type": "boolean"
                  },
                  "sort_by": {
                    "description": "most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended).",
                    "enum": [
                      "impressions_desc",
                      "most_recent"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "advertiser"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "properties": {
                  "ads": {
                    "items": {
                      "properties": {
                        "adArchiveId": {
                          "type": "string"
                        },
                        "bodyText": {
                          "type": "string"
                        },
                        "country": {
                          "type": "string"
                        },
                        "ctaText": {
                          "type": "string"
                        },
                        "ctaType": {
                          "type": "string"
                        },
                        "daysRunning": {
                          "type": "number"
                        },
                        "displayFormat": {
                          "type": "string"
                        },
                        "imageUrls": {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "isActive": {
                          "type": "boolean"
                        },
                        "linkUrl": {
                          "type": "string"
                        },
                        "linkUrlType": {
                          "type": "string"
                        },
                        "mediaExpiresAt": {
                          "type": "string"
                        },
                        "pageId": {
                          "type": "string"
                        },
                        "pageName": {
                          "type": "string"
                        },
                        "publisherPlatform": {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "scrapedAt": {
                          "type": "string"
                        },
                        "sourceUrl": {
                          "type": "string"
                        },
                        "startDate": {
                          "type": "number"
                        },
                        "templatedText": {
                          "type": "boolean"
                        },
                        "title": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "asOf": {
                    "type": "string"
                  },
                  "count": {
                    "type": "number"
                  },
                  "country": {
                    "type": "string"
                  },
                  "query": {
                    "properties": {
                      "advertiser": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "resolvedPage": {
                    "properties": {
                      "pageId": {
                        "type": "string"
                      },
                      "pageName": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "source": {
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "via": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  }
                },
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar"
  ],
  "sourceHost": "ads.apitoll.cloud",
  "lastUpdated": "2026-08-30T15:50:50.317Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-08-30T15:50:49.795Z"
  },
  "liveness": {},
  "verified": false,
  "featured": false,
  "provider": {
    "host": "ads.apitoll.cloud",
    "manifest_name": "ads.apitoll.cloud",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-09-18T22:00:31.484Z"
  }
}