Skip to content
onelayer.
All tools

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

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