apify.facebook-ads

Search Facebook Ad Library: pay per use, no API key

Use Apify from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Search public Meta Ad Library ads by keyword using Apify. Price is per ad (quoted from `limit`, max 1000).

Price and execution

Price: $0.00075 / ad
Pricing model: Per ad, billed on success
Execution class: queued

Limits

No additional limits are published for this tool.

Parameters

Fields apify.facebook-ads accepts as JSON input.

urlstring (uri)Optional
Optional Ad Library or Page URL. If omitted, the tool builds one from `query` and `country`.
limitintegerOptional
Maximum number of records to return (1 to 1000, default 10). Quoted price scales with this limit.
querystringRequired
Advertiser or keyword to search in the Meta Ad Library, such as `openai`.
countrystringOptional
Two-letter country code for the Ad Library search.

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https://(www\\.)?facebook\\.com/",
      "description": "Optional Ad Library or Page URL. If omitted, the tool builds one from `query` and `country`."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum number of records to return (1 to 1000, default 10). Quoted price scales with this limit."
    },
    "query": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "Advertiser or keyword to search in the Meta Ad Library, such as `openai`."
    },
    "country": {
      "type": "string",
      "default": "US",
      "pattern": "^[A-Za-z]{2}quot;,
      "description": "Two-letter country code for the Ad Library search."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful apify.facebook-ads call returns.

countintegerRequired
resultsarrayRequired
retrieved_atstring (date-time)Required
provider_request_idstring | nullRequired

Raw output JSON Schema

{
  "type": "object",
  "required": [
    "results",
    "count",
    "provider_request_id",
    "retrieved_at"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0
    },
    "results": {
      "type": "array",
      "maxItems": 1000
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    },
    "provider_request_id": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the apify.facebook-ads tool with this input: {"query":"openai","country":"US","limit":1}

Start with $1 free See pricing

Safety notes

Side Effect: read_only
Public Sources Only: Yes
Authenticated Content: No

How this compares to using Apify directly

You do not need a separate Apify account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]