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.
Offering
- Provider
- ads.apitoll.cloud
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Business And Commerce
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://ads.apitoll.cloud/v1/ads/facebook/advertiser- MIME type
- application/json
- First seen
- 2026-10-16T01:50:10.647Z
- Last seen
- Tags
- facebook-ads, ad-library, competitor-intelligence, brand-ads, ad-creative, advertiser, 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
- 295 ms
- Average latency
- 998 ms
- HTTP status
- 402
- Last checked
- Reachability
- 100% over 13 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": {
"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."
},
"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."
},
"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 advertiser’s page identity (categories, profile pic). Slower. Default false."
}
},
"required": [
"advertiser"
]
}
},
"required": [
"type",
"method"
],
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"asOf": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"advertiser": {
"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"
]
}