Api Endpoint

ApiToll Facebook Page Ad Monitor

Facebook ads from a specific advertiser page — monitor every live and recent ad a competitor runs by passing their Facebook page URL, vanity handle, or page id. Returns the full ad creative (headline, body copy, CTA + destination link, image and video URLs), run dates, and platform mix across Facebook, Instagram, Messenger and Threads. Track a competitor’s ad strategy and winning creatives over time. No Meta login.

Open interactive test console

Offering

Provider
ads.apitoll.cloud
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://ads.apitoll.cloud/v1/ads/facebook/page
MIME type
application/json
First seen
2026-10-16T01:59:37.852Z
Last seen
Tags
facebook-ads, ad-library, competitor-monitoring, ad-creative, ads, brand-tracking, instagram-ads, apitoll

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.03 USDC
Atomic price: 30000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.03 USDC
Atomic price: 30000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0x4ce88238F669d04351937420C931988e464a975a"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "30000",
    "payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x"
  }
]

Observed health

Status
Healthy
Latest latency
293 ms
Average latency
1056 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "page": {
          "type": "string",
          "description": "Facebook page URL (facebook.com/nike), vanity handle, profile.php?id=, or numeric page id. Defaults to a demo page if omitted."
        },
        "country": {
          "type": "string",
          "description": "Two-letter ISO country (US, GB, DE…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US."
        },
        "media_type": {
          "type": "string",
          "description": "Creative format filter.",
          "enum": [
            "all",
            "image",
            "video",
            "meme",
            "image_and_meme",
            "none"
          ]
        },
        "ad_type": {
          "type": "string",
          "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"
          ]
        },
        "platforms": {
          "type": "string",
          "description": "Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all."
        },
        "period": {
          "type": "string",
          "description": "Limit to ads active in this window. Blank = all time.",
          "enum": [
            "",
            "last24h",
            "last7d",
            "last14d",
            "last30d"
          ]
        },
        "active_status": {
          "type": "string",
          "description": "Filter by whether the ad is still running.",
          "enum": [
            "all",
            "active",
            "inactive"
          ]
        },
        "sort_by": {
          "type": "string",
          "description": "most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended).",
          "enum": [
            "impressions_desc",
            "most_recent"
          ]
        },
        "limit": {
          "type": "integer",
          "description": "Max ads to return (1-60).",
          "minimum": 1,
          "maximum": 60
        },
        "resolve_advertiser": {
          "type": "boolean",
          "description": "Also resolve the page identity (categories, profile pic). Slower. Default false."
        }
      },
      "required": [
        "page"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object",
      "properties": {
        "asOf": {
          "type": "string"
        },
        "page": {
          "type": "string"
        },
        "resolvedPage": {
          "type": "object",
          "properties": {
            "pageId": {
              "type": "string"
            },
            "pageName": {
              "type": "string"
            }
          }
        },
        "country": {
          "type": "string"
        },
        "count": {
          "type": "number"
        },
        "ads": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "adArchiveId": {
                "type": "string"
              },
              "pageId": {
                "type": "string"
              },
              "pageName": {
                "type": "string"
              },
              "isActive": {
                "type": "boolean"
              },
              "startDate": {
                "type": "number"
              },
              "daysRunning": {
                "type": "number"
              },
              "publisherPlatform": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "displayFormat": {
                "type": "string"
              },
              "templatedText": {
                "type": "boolean"
              },
              "title": {
                "type": "string"
              },
              "bodyText": {
                "type": "string"
              },
              "ctaText": {
                "type": "string"
              },
              "ctaType": {
                "type": "string"
              },
              "linkUrl": {
                "type": "string"
              },
              "linkUrlType": {
                "type": "string"
              },
              "imageUrls": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "mediaExpiresAt": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "sourceUrl": {
                "type": "string"
              },
              "scrapedAt": {
                "type": "string"
              }
            }
          }
        },
        "source": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "via": {
              "type": "string"
            }
          }
        }
      }
    }
  },
  "required": [
    "type"
  ]
}