Tool detail
StableSocial
Returns a company's Facebook Ad Library ads (active/inactive) with impressions-based sort and date/media/language filters.
Categories: Social media, SEO marketing
Use when
- list a company's current Facebook ads from the Ad Library
- check what media types and languages a brand is running ads in
- sort a company's Facebook ads by impressions or recency
Not for
- not for finding a company's pageId - that needs a separate Search Companies endpoint
- not Instagram, TikTok or other platform ads - Facebook ad library only
Inputs
POST JSON body, all optional: companyName or pageId (need one in practice); country, language, media_type, status, sort_by, start_date/end_date, cursor, trim
Admitted input schema
{
"type": "object",
"properties": {
"companyName": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "The name of the company. Can either use this or pageId"
},
"country": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL."
},
"cursor": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "Cursor to paginate through results"
},
"end_date": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "End date to search for. Format: YYYY-MM-DD"
},
"language": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc"
},
"media_type": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"enum": [
"ALL",
"IMAGE",
"VIDEO",
"MEME",
"IMAGE_AND_MEME",
"NONE"
],
"description": "Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme."
},
"pageId": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName"
},
"sort_by": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"enum": [
"total_impressions",
"relevancy_monthly_grouped"
],
"description": "Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions."
},
"start_date": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "Start date to search for. Format: YYYY-MM-DD"
},
"status": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"enum": [
"ALL",
"ACTIVE",
"INACTIVE"
],
"description": "Status of the ad. Defaults to ACTIVE."
},
"trim": {
"type": "boolean",
"description": "Set to true for a trimmed down version of the response"
}
},
"required": [],
"additionalProperties": false
}Endpoint
- Method
POST- URL
https://stablesocial.dev/api/sc/facebook/adLibrary/company/ads
Payment
- Protocol
- x402
- Listed price
- 0.06 USDC per call on Base
- Payment method
- exact
- Network
- eip155:8453
- Asset
- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.
Source
- Directory
- Coinbase x402 Bazaar
- Record
- POST https://stablesocial.dev/api/sc/facebook/adLibrary/company/ads
- Retrieved
- 2026-09-30T20:37:07.382Z
- Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524- Catalog built
- 2026-09-30T22:31:58.034Z