ApiToll Facebook Ad Library
payment-ready until 2026-10-27
imported from the x402 Bazaar, not submitted by the operator · own this service? claim it · or ask to be removed
Searches the public Facebook Ad Library by keyword, advertiser or page and returns the full ad creative: headline, body copy, CTA and destination link, media URLs, run dates and platform mix across Facebook, Instagram, Messenger and Threads.
Call it x402 v2
x402 v2
- Base URL
- https://ads.apitoll.cloud
- Payment
- x402 v2, header channel
$ curl -i 'https://ads.apitoll.cloud/v1/ads/facebook/advertiser' An unpaid request returns HTTP 402 with the payment terms. Sign a payment authorization, then retry with the PAYMENT-SIGNATURE header.
Endpoints 4 paid routes on ads.apitoll.cloud
Prices as captured in the 402 response: median $0.03 across the 4 endpoints.
Example 402 response
Endpoints and prices
| Method | Path | Description | Price | Network | Asset | 402 channel | Captured |
|---|---|---|---|---|---|---|---|
| GET | / | 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. | $0.03 | Base+ | USDC | header | since 07-21 |
| GET | / | 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. | $0.03 | Base+ | USDC | header | since 07-21 |
| GET | / | Facebook Ad Library search by keyword · every live and recent ad matching a search term across all advertisers on Facebook, Instagram, Messenger and Threads. Returns the full ad creative (headline, body copy, CTA button + destination link, image and video URLs), the advertiser, run dates and days-running, and platform mix. Commercial and political ads, no Meta API or login. Competitor ad intelligence, ad spy, and creative research for AI agents. | $0.03 | Base+ | USDC | header | since 07-21 |
| GET | / | TikTok ad library · TikTok Creative Center’s global Top Ads leaderboard: the best-performing TikTok ads in any of 81 countries (incl. US and full MENA), ranked by TikTok’s CTR / likes / 2-second-view boards. Returns each ad’s video + cover image, advertiser brand (when disclosed), engagement (likes/comments/shares), landing page, a relative performance + cost index, and campaign objective. Creative trend research, winning-ad discovery, and TikTok ad spy for AI agents. | $0.03 | Base+ | USDC | header | since 07-21 |
Payment evidence
402 payload captured at . Check evidence JSON · Measurement methodology.
First of 4 payloads captured by the monitor.
340 lines, scroll inside
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x4ce88238F669d04351937420C931988e464a975a",
"amount": "30000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 150
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"
},
"payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
"amount": "30000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 150
}
],
"resource": {
"url": "https://ads.apitoll.cloud/v1/ads/facebook/search",
"tags": [
"facebook-ads",
"ad-library",
"ads",
"keyword-search",
"ad-creative",
"marketing",
"instagram-ads",
"apitoll"
],
"mimeType": "application/json",
"description": "Facebook Ad Library search by keyword — every live and recent ad matching a search term across all advertisers on Facebook, Instagram, Messenger and Threads. Returns the full ad creative (headline, body copy, CTA button + destination link, image and video URLs), the advertiser, run dates and days-running, and platform mix. Commercial and political ads, no Meta API or login. Competitor ad intelligence, ad spy, and creative research for AI agents.",
"serviceName": "ApiToll Facebook Ad Library Keyword Search"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"q": "running shoes",
"country": "US"
}
},
"output": {
"type": "json",
"example": {
"ads": [
{
"title": "Run Further in the new AeroGlide",
"pageId": "100066543210987",
"country": "US",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://acmefootwear.com/aeroglide?utm_source=fb",
"bodyText": "Lightweight cushioning for your longest runs. Free shipping this week.",
"isActive": true,
"pageName": "Acme Footwear",
"videoUrl": "https://video.xx.fbcdn.net/v/ad_hd.mp4",
"imageUrls": [
"https://scontent.xx.fbcdn.net/v/img1.jpg"
],
"scrapedAt": "2026-06-25T14:32:09Z",
"sourceUrl": "https://www.facebook.com/ads/library/?q=running%20shoes&country=US",
"startDate": 1717200000,
"adArchiveId": "1234567890123456",
"daysRunning": 28,
"linkUrlType": "destination",
"pageVerified": true,
"displayFormat": "VIDEO",
"templatedText": false,
"mediaExpiresAt": "2026-06-29T22:19:28Z",
"publisherPlatform": [
"FACEBOOK",
"INSTAGRAM"
]
}
],
"asOf": "2026-06-25T14:32:10Z",
"count": 25,
"query": {
"keyword": "running shoes"
},
"source": {
"via": "Apify",
"name": "Facebook Ad Library"
},
"country": "US"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Keyword/phrase to search ads for (e.g. \"running shoes\", \"crypto wallet\"). Defaults to a demo query if omitted."
},
"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."
},
"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 each 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"
},
"videoUrl": {
"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"
},
"pageVerified": {
"type": "boolean"
},
"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": {
"keyword": {
"type": "string"
}
}
},
"source": {
"type": "object",
"properties": {
"via": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"country": {
"type": "string"
}
}
}
}
}
}
}
}
},
"x402Version": 2
} Other captured 402 responses (3)
Captured payload 2 of 4
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x4ce88238F669d04351937420C931988e464a975a",
"amount": "30000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 150
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"
},
"payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
"amount": "30000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 150
}
],
"resource": {
"url": "https://ads.apitoll.cloud/v1/ads/facebook/advertiser",
"tags": [
"facebook-ads",
"ad-library",
"competitor-intelligence",
"brand-ads",
"ad-creative",
"advertiser",
"instagram-ads",
"apitoll"
],
"mimeType": "application/json",
"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.",
"serviceName": "ApiToll Facebook Advertiser Ads"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"country": "US",
"advertiser": "Nike"
}
},
"output": {
"type": "json",
"example": {
"ads": [
{
"title": "Just Do It",
"pageId": "15087023444",
"country": "US",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://www.nike.com/launch",
"bodyText": "Gear up for your next run. New arrivals now live.",
"isActive": true,
"pageName": "Nike",
"imageUrls": [
"https://scontent.xx.fbcdn.net/v/nike1.jpg"
],
"scrapedAt": "2026-06-25T14:32:09Z",
"sourceUrl": "https://www.facebook.com/ads/library/?q=Nike&search_type=keyword_unordered&country=US",
"startDate": 1718000000,
"adArchiveId": "9876543210987654",
"daysRunning": 14,
"linkUrlType": "destination",
"displayFormat": "VIDEO",
"templatedText": false,
"mediaExpiresAt": "2026-06-29T22:19:28Z",
"publisherPlatform": [
"FACEBOOK",
"INSTAGRAM"
]
}
],
"asOf": "2026-06-25T14:32:10Z",
"count": 12,
"query": {
"advertiser": "Nike"
},
"source": {
"via": "Apify",
"name": "Facebook Ad Library"
},
"country": "US",
"resolvedPage": {
"pageId": "15087023444",
"pageName": "Nike"
}
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"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"
}
}
}
}
}
}
}
}
}
}
},
"x402Version": 2
}Captured payload 3 of 4
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x4ce88238F669d04351937420C931988e464a975a",
"amount": "30000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 150
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"
},
"payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
"amount": "30000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 150
}
],
"resource": {
"url": "https://ads.apitoll.cloud/v1/ads/tiktok/top",
"tags": [
"tiktok-ads",
"ad-library",
"tiktok-ad-library",
"creative-center",
"ad-creative",
"top-ads",
"marketing",
"apitoll"
],
"mimeType": "application/json",
"description": "TikTok ad library — TikTok Creative Center’s global Top Ads leaderboard: the best-performing TikTok ads in any of 81 countries (incl. US and full MENA), ranked by TikTok’s CTR / likes / 2-second-view boards. Returns each ad’s video + cover image, advertiser brand (when disclosed), engagement (likes/comments/shares), landing page, a relative performance + cost index, and campaign objective. Creative trend research, winning-ad discovery, and TikTok ad spy for AI agents.",
"serviceName": "ApiToll TikTok Top Ads"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"period": "30",
"country": "US"
}
},
"output": {
"type": "json",
"example": {
"ads": [
{
"adId": "7644097429029437458",
"likes": 200,
"title": "Art you carry with you from the very first moment of the day. Shop now at casetify.com",
"shares": 1,
"country": "US",
"orderBy": "ctr",
"comments": 2,
"ctrIndex": 0.04,
"videoUrl": "https://v16m-default.tiktokcdn.com/abc/video.mp4",
"brandName": "CASETiFY",
"costIndex": 1,
"objective": "Conversion",
"scrapedAt": "2026-06-25T11:27:57Z",
"coverImage": "https://p16-sign.tiktokcdn.com/abc/cover.jpg?x-expires=1782406180",
"periodDays": 30,
"landingPage": "https://www.casetify.com/?utm_source=tiktok",
"industryCode": "label_21104000000",
"coverExpiresAt": "2026-06-25T16:49:40Z"
}
],
"asOf": "2026-06-25T11:27:57Z",
"count": 20,
"period": "30d",
"source": {
"via": "Apify",
"name": "TikTok Creative Center (Top Ads)"
},
"country": "US",
"orderBy": "ctr"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"country"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 40,
"minimum": 1,
"description": "Max ads to return (1-40)."
},
"detail": {
"type": "boolean",
"description": "Enrich each ad with landing page URL + share/comment counts. Default true."
},
"period": {
"enum": [
"7",
"30",
"180"
],
"type": "string",
"description": "Look-back window in days."
},
"country": {
"type": "string",
"description": "Two-letter ISO country for the Top Ads leaderboard (US, GB, SA, AE, EG, DE, BR…; 81 supported incl. full MENA). Default US."
},
"order_by": {
"enum": [
"ctr",
"like",
"play_2s_rate",
"for_you",
"impression"
],
"type": "string",
"description": "Which TikTok leaderboard to pull (results are returned best-first by this metric)."
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"ads": {
"type": "array",
"items": {
"type": "object",
"properties": {
"adId": {
"type": "string"
},
"likes": {
"type": "number"
},
"title": {
"type": "string"
},
"shares": {
"type": "number"
},
"country": {
"type": "string"
},
"orderBy": {
"type": "string"
},
"comments": {
"type": "number"
},
"ctrIndex": {
"type": "number"
},
"videoUrl": {
"type": "string"
},
"brandName": {
"type": "string"
},
"costIndex": {
"type": "number"
},
"objective": {
"type": "string"
},
"scrapedAt": {
"type": "string"
},
"coverImage": {
"type": "string"
},
"periodDays": {
"type": "number"
},
"landingPage": {
"type": "string"
},
"industryCode": {
"type": "string"
},
"coverExpiresAt": {
"type": "string"
}
}
}
},
"asOf": {
"type": "string"
},
"count": {
"type": "number"
},
"period": {
"type": "string"
},
"source": {
"type": "object",
"properties": {
"via": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"country": {
"type": "string"
},
"orderBy": {
"type": "string"
}
}
}
}
}
}
}
}
},
"x402Version": 2
}Captured payload 4 of 4
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x4ce88238F669d04351937420C931988e464a975a",
"amount": "30000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 150
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "GVJJ7rdGiXr5xaYbRwRbjfaJL7fmwRygFi1H6aGqDveb"
},
"payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
"amount": "30000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 150
}
],
"resource": {
"url": "https://ads.apitoll.cloud/v1/ads/facebook/page",
"tags": [
"facebook-ads",
"ad-library",
"competitor-monitoring",
"ad-creative",
"ads",
"brand-tracking",
"instagram-ads",
"apitoll"
],
"mimeType": "application/json",
"description": "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.",
"serviceName": "ApiToll Facebook Page Ad Monitor"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"page": "https://www.facebook.com/nike"
}
},
"output": {
"type": "json",
"example": {
"ads": [
{
"title": "{{product.name}}",
"pageId": "15087023444",
"country": "US",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://fb.com/canvas_doc/1357532171781925",
"bodyText": "{{product.brand}} — {{product.description}}",
"isActive": true,
"pageName": "Nike",
"imageUrls": [
"https://scontent.xx.fbcdn.net/v/nike1.jpg"
],
"scrapedAt": "2026-06-19T14:32:09Z",
"sourceUrl": "https://www.facebook.com/ads/library/?view_all_page_id=15087023444",
"startDate": 1718000000,
"adArchiveId": "9876543210987654",
"daysRunning": 14,
"linkUrlType": "canvas",
"pageVerified": true,
"displayFormat": "DCO",
"templatedText": true,
"mediaExpiresAt": "2026-06-29T22:19:28Z",
"publisherPlatform": [
"FACEBOOK",
"INSTAGRAM",
"AUDIENCE_NETWORK"
]
}
],
"asOf": "2026-06-19T14:32:10Z",
"page": "https://www.facebook.com/nike",
"count": 25,
"source": {
"via": "Apify",
"name": "Facebook Ad Library"
},
"country": "US",
"resolvedPage": {
"pageId": "15087023444",
"pageName": "Nike"
}
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"page"
],
"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."
},
"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…) 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."
},
"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 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"
},
"pageVerified": {
"type": "boolean"
},
"displayFormat": {
"type": "string"
},
"templatedText": {
"type": "boolean"
},
"mediaExpiresAt": {
"type": "string"
},
"publisherPlatform": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"asOf": {
"type": "string"
},
"page": {
"type": "string"
},
"count": {
"type": "number"
},
"source": {
"type": "object",
"properties": {
"via": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"country": {
"type": "string"
},
"resolvedPage": {
"type": "object",
"properties": {
"pageId": {
"type": "string"
},
"pageName": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
},
"x402Version": 2
}Can I trust it score from our own monitoring
score from our own monitoring
#129 of 386 in Data. Bands: strong 93+, solid 75+, mixed 55+, weak below 55.
- Reliability
- 99.9% uptime 30d
- Compliance
- A 14/14 checks pass
- Price
- $0.03 p83 in Data
- Risk
- clean no risk flag
- Traction
- $17.94 30d 10 buyers, top buyer 79% (address, not entity) Concentrated volume: 98% of 30d volume from 3 wallets
14/14 compliance checks
- 402 payload captured
- accepts[] array present
- payTo address recoverable
- payTo at accepts[0].payTo (conformant shape)
- payTo is a valid on-chain address
- atomic price declared
- atomic price in a sane range
- asset (token) address declared
- network resolves to CAIP-2
- payment scheme declared
- served over HTTPS
- declares the current x402 version (2)
- EIP-712 domain parameters present on every EVM entry
- x402 v2 envelope delivered in the payment-required header
402 terms unchanged since 2026-07-21. Last up 2026-10-20.
── Site signals
- homepage reachable
- openapi doc
- pricing page
- llms.txt
- robots.txt
- terms page
How the score works
What the score read on this service: status online, 99.9% uptime 30d, 495ms response p95, x402 compliance 14 of 14, $0.03 price against the category, on-chain traction measured. Each of those is measured, and each is published in full below.
The score comes from our own monitoring, never from reviews, operator claims, or a language model: reliability, x402 compliance, price against the category, a deterministic risk flag, and a small on-chain traction term, weighted by ranking generation 3. It is not placement anyone can buy: the paid verify tier is reported beside it and is not one of its inputs. Every component below stays published and read-only.
Bands on the 0 to 100 measured score: strong at 93 and above, solid from 75, mixed from 55, weak below 55. Price and speed are scored against the whole category field, every listing in it that carries no danger flag, the scored service included, so the score places a service in its own field.
It is a score inside Data, and only there: price and speed are scored against the whole category field, every listing in it that carries no danger flag, the scored service included, which here means 386 listings, this one among them: the same 386 the position above is counted against. When the two differ, the field is the wider one, because a listing we have measured too little of to rank still sits in the field the price and the speed are normalized over. The same service in a different field would read differently. The same engine answers GET /api/v1/best, and asked for a different pool (the whole directory, or another filter) it returns a different number for this service under this same ranking generation. Neither is more correct: they answer different questions, and the methodology states which is which.
Settled via coinbase ($17.94, 598 tx). Traction is a conservative undercount; first settlement seen 2026-06-19.
All measured facts
What it does
Searches the public Facebook Ad Library by keyword, advertiser or page and returns the full ad creative: headline, body copy, CTA and destination link, media URLs, run dates and platform mix across Facebook, Instagram, Messenger and Threads. Also serves TikTok Top Ads by country.
ApiToll Facebook Ad Library is a listed x402 Data API. Captured payment terms name Base, Solana. Monitoring and settlement figures below describe the observations available to this directory; an unpaid HTTP 402 check does not prove that a paid call will deliver.
Assessment computed at . Latest service check observed at . Service data JSON · Measurement methodology.
Page rendered at . This response time is separate from the observation and computation times attached to each measurement.
Latest endpoint observation: . Latest price capture: . Prices are recorded quotes, not a promise of availability. Token assets and payment terms are listed separately. Endpoint data JSON · Price history JSON · Measurement methodology.
Assessment computed at . Uptime uses the stated daily-rollup window; response times are in milliseconds, compliance is passed/evaluated checks, and traction is a measured settlement floor. The comparison score is out of 100 within this category. Assessment JSON · Measurement methodology.
Observed daily coverage: 2026-09-20 to 2026-10-19 UTC. Daily monitoring and settlement rollups do not expose their computation time; a bucket date is not an update timestamp. Latest settlement in the assessment: . Uptime and response JSON · Volume JSON · Buyers JSON · Measurement methodology.
Ranked from the measured category pool, refreshed at most once a minute. The comparison has no persisted computation timestamp; the assessment time above belongs to this service only. Ranking API documentation · Ranking methodology.
x402 List home · Services · Data
- uptime · latest daily rollup
- 98.6%
- uptime 7d
- 99.5%
- uptime 30d
- 99.9%
- uptime 90d
- 100%
- response p95
- 495ms
- avg response
- 229ms
- total checks
- 2,760
Measured on the unpaid 402 handshake, not the paid call. A service can 402 correctly and still fail after payment.
- price (min)
- $0.03
- category percentile (min)
- p83 in Data
- endpoints / prices
- 4 / 1
- model
- flat
- stability
- 100%
No deterministic risk flag. Risk fires only on an exact blocklist match, or a reserved-brand name with a mismatched verified payTo. Never from low uptime, a high price, or a model guess.
- domain age
- 141d
- registrar
- HOSTINGER operations, UAB
- hosting
- custom
- domain created
- 2026-05-27
Identity facts, not a risk score.
- assessment volume 30d
- $17.94
- exact assessment volume 30d (USD)
- 17.94
- assessment recorded at (UTC)
- 2026-10-19T20:13:03.800Z
- buyers 30d
- 10
- settlements 30d
- 598
- measured since
- 2026-06-19 (start of our harvest window)
- last settlement
- 2026-10-19
- top buyer share
- 79% of 30d volume (address, not entity)
- top 3 buyers share
- 98% of 30d volume (addresses, not entities)
- concentrated volume
- yes
- trend 7d vs 30d
- 0.93x the 30d daily rate
- networks
- eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d
- volume all-time
- $19.63
- settlements all-time
- 663
- median settlement 30d
- $0.03
- max settlement 30d
- $0.03
Assessment volume uses the latest 30d assessment. Over time sums daily address snapshots, rounded to cents and refreshed separately. The two sources can differ in timing, precision and shared-address attribution. Amounts use cents for comparison; known sub-cent values keep up to 12 significant digits. The exact stored assessment value is shown above.
Conservative undercount: only USDC settlements via facilitators we measure are counted. A measured floor, not an estimate.
Concentrated volume is one rule applied to every listed service: the 3 largest paying addresses hold at least 90% of 30d volume, with at least $10 of volume and 50 settlements in the same 30 days. While it applies, this service's volume counts as 0 in the Recommended and Highest volume sorts of the services list. The label says where the payments came from, not why.
Top buyer share lowers the on-chain traction part of the ranking score behind this page's verdict and /best, by up to half when one address holds all 30d volume. The Recommended and Highest volume sorts of the services list do not use it; they use the Concentrated volume rule instead.
- member since
- 2026-07-21
Recent checks
| Checked at (UTC) | Status | HTTP | Response | Endpoints |
|---|---|---|---|---|
| Online | 402 | 205ms | 4 | |
| Online | 402 | 144ms | 4 | |
| Online | 402 | 262ms | 4 | |
| Online | 402 | 284ms | 4 | |
| Online | 402 | 233ms | 4 | |
| Online | 402 | 183ms | 4 | |
| Online | 402 | 210ms | 4 | |
| Online | 402 | 214ms | 4 | |
| Online | 402 | 246ms | 4 | |
| Online | 402 | 285ms | 4 | |
| Online | 402 | 110ms | 4 | |
| Online | 402 | 227ms | 4 | |
| Online | 402 | 141ms | 4 | |
| Online | 402 | 249ms | 4 | |
| Online | 402 | 210ms | 4 | |
| Online | 402 | 165ms | 4 | |
| Online | 402 | 219ms | 4 | |
| Online | 402 | 220ms | 4 |
Changes0 in 30d
No changes recorded in the last 30 days.
Over time
- Volume 30d
- $17.94
- Uptime
- 2 of 30 completed days below 100%
More charts
09-20 to 10-19 UTC
Scores over time
09-20 to 10-19 UTC
09-20 to 10-19 UTC
09-20 to 10-19 UTC
Scores: one day per column, 09-20 to 10-19, on the columns of Response time. Uptime held below 100% on some days in this window, including any partial day. Daily readings remain in the Uptime strip and Values. The checklist grew from 11 to 14 checks on 2026-07-28, before this window. Pillar lines use their own low and high. Exact dated readings are available in each readout and in Values.
Each series spans only the dates it has data for. Every series is also served as JSON at /api, /scores, /volume and /buyers.
Values
The uptime summary counts completed UTC days only. The strip, readouts and table retain today's partial reading.
Daily snapshot total, 30d: $17.94, peak $3.54 on 10-05. The visible 30d total in Traction comes from the latest assessment. These sources can differ in their window, refresh time, cent rounding and shared-address attribution.
Daily address snapshots: 2026-09-20 to 2026-10-19 UTC. Daily snapshots store cents. A recorded $0.00 with settlements cannot distinguish exact zero from volume rounded away. Lost precision is unavailable here.
Settlement volume uses the stored USD valuation of tracked payments; it is distinct from token quantities. USD-pegged assets are valued at 1 USD per token in these rollups. The measured settlement floor does not cover all payments to this service.
Assessment history last recorded at . Each UTC day uses its last recorded run; missing readings stay unmeasured. Assessment history JSON · Measurement methodology.
| Day | Volume | Buyers | Settlements | Uptime | Response | Compliance | Price percentile | Site signals |
|---|---|---|---|---|---|---|---|---|
| 2026-09-20 | no data | no data | no data | no data | no data | 14/14 | p81 | 2/6 |
| 2026-09-21 | no data | no data | no data | 100% | 332.33ms | 14/14 | p81 | 2/6 |
| 2026-09-22 | no data | no data | no data | 100% | 459.42ms | 14/14 | p81 | 2/6 |
| 2026-09-23 | no data | no data | no data | 100% | 357.90ms | 14/14 | p81 | 2/6 |
| 2026-09-24 | $0.09 | 2 | 3 | 100% | 270.83ms | 14/14 | p81 | 2/6 |
| 2026-09-25 | $0.03 | 1 | 1 | 100% | 273.73ms | 14/14 | p81 | 2/6 |
| 2026-09-26 | $0.03 | 1 | 1 | 100% | 479.69ms | 14/14 | p81 | 2/6 |
| 2026-09-27 | $0.06 | 2 | 2 | 100% | 621.19ms | 14/14 | p80 | 2/6 |
| 2026-09-28 | no data | no data | no data | 100% | 219.48ms | 14/14 | p80 | 2/6 |
| 2026-09-29 | no data | no data | no data | 100% | 215.59ms | 14/14 | p81 | 2/6 |
| 2026-09-30 | $0.03 | 1 | 1 | 100% | 204.83ms | 14/14 | p81 | 2/6 |
| 2026-10-01 | $0.51 | 1 | 17 | 100% | 213.84ms | 14/14 | p81 | 2/6 |
| 2026-10-02 | $0.51 | 1 | 17 | 100% | 185.66ms | 14/14 | p81 | 2/6 |
| 2026-10-03 | $0.78 | 2 | 26 | 100% | 131.93ms | 14/14 | p81 | 2/6 |
| 2026-10-04 | $0.21 | 1 | 7 | 100% | 184.96ms | 14/14 | p82 | 2/6 |
| 2026-10-05 | $3.54 | 2 | 118 | 100% | 233.91ms | 14/14 | p82 | 2/6 |
| 2026-10-06 | $0.39 | 1 | 13 | 100% | 270.23ms | 14/14 | p82 | 2/6 |
| 2026-10-07 | $1.08 | 1 | 36 | 100% | 147.50ms | 14/14 | p82 | 2/6 |
| 2026-10-08 | $1.20 | 2 | 40 | 100% | 143.96ms | 14/14 | p82 | 2/6 |
| 2026-10-09 | $1.47 | 2 | 49 | 100% | 160.02ms | 14/14 | p82 | 2/6 |
| 2026-10-10 | $1.26 | 1 | 42 | 100% | 123.52ms | 14/14 | p82 | 2/6 |
| 2026-10-11 | $1.38 | 1 | 46 | 100% | 129.32ms | 14/14 | p82 | 2/6 |
| 2026-10-12 | $1.47 | 1 | 49 | 100% | 110.18ms | 14/14 | p82 | 2/6 |
| 2026-10-13 | $0.96 | 1 | 32 | 100% | 105.11ms | 14/14 | p82 | 2/6 |
| 2026-10-14 | $0.75 | 2 | 25 | 100% | 126.38ms | 14/14 | p83 | 2/6 |
| 2026-10-15 | $0.60 | 1 | 20 | 100% | 153.24ms | 14/14 | p83 | 2/6 |
| 2026-10-16 | $0.57 | 1 | 19 | 100% | 123.76ms | 14/14 | p83 | 2/6 |
| 2026-10-17 | $0.60 | 2 | 20 | 97.75% | 132.03ms | 14/14 | p83 | 2/6 |
| 2026-10-18 | no data | no data | no data | 100% | 201.38ms | 14/14 | p83 | 2/6 |
| 2026-10-19 | $0.42 | 1 | 14 | 98.88% | 216.64ms | 14/14 | p83 | 2/6 |
Alternatives in Data
5 of 385 other ranked services in Data, ordered by the same measured score.
Own this service?
Keep this listing accurate. Ownership is proven with a domain check and every change is reviewed by hand.
Update this listingEarn the verified tier: x402list pays a real call to this endpoint and, if it delivers, the service is delivery-verified. The fee covers the cost of the probe, not the badge; there is no refund if the call does not deliver. Agent and API only, no in-browser signing. See /api.
Verify this service ($0.25)Embed a badge
HTML
<a href="https://x402-list.com/services/ apitoll-facebook-ad-library? utm_source=badge& utm_medium=referral& utm_campaign=embed"> <img src="https://x402-list.com/ badge/ apitoll-facebook-ad-library.svg" alt="ApiToll Facebook Ad Library listed on x402-list" height="28"> </a>
Markdown
[](https://x402-list.com/ services/ apitoll-facebook-ad-library? utm_source=badge& utm_medium=referral& utm_campaign=embed)
HTML, live uptime variant
<a href="https://x402-list.com/services/ apitoll-facebook-ad-library? utm_source=badge& utm_medium=referral& utm_campaign=embed"> <img src="https://x402-list.com/ badge/ apitoll-facebook-ad-library.svg? data=uptime" alt="ApiToll Facebook Ad Library uptime on x402-list" height="28"> </a>
Delisting
To request delisting, email info@x402-list.com or update your listing at /services/apitoll-facebook-ad-library/update.