Api Endpoint

Apify API

Start the "Facebook Ad Library Scraper" Apify actor (curious_coder/facebook-ads-library-scraper). Scrape facebook ads from ad library search results and ads run by facebook pages - Fast and lightweight. $0.75 per 1000 results

Open interactive test console

Offering

Provider
stableapify.dev
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://stableapify.dev/api/actors/curious_coder/facebook-ads-library-scraper/call
MIME type
Not provided
First seen
2026-10-16T01:54:06.400Z
Last seen
Tags
Actors

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0x23d931f95831cee50b5f5edf4d0e88270f6c8411"
  }
]

Observed health

Status
Healthy
Latest latency
53 ms
Average latency
315 ms
HTTP status
204
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "input": {
          "additionalProperties": {},
          "description": "Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).",
          "properties": {
            "count": {
              "description": "Leave this field empty if you want to limit number of ads scraped",
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "limitPerSource": {
              "description": "Limit number of ads scraped per input URL. Leave it blank to scrape all available ads ℹ️ Actual number might exceed the given limit by upto 30",
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "proxy": {
              "additionalProperties": {},
              "description": "You can use this option to customise the proxy country",
              "properties": {
                "apifyProxyCountry": {
                  "type": "string"
                },
                "apifyProxyGroups": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "proxyUrls": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "useApifyProxy": {
                  "type": "boolean"
                }
              },
              "type": "object"
            },
            "runTag": {
              "description": "Add this value to 'runTag' column in the output",
              "type": "string"
            },
            "scrapeAdDetails": {
              "description": "Enable this option to scrape ads details such as EU Reach info",
              "type": "boolean"
            },
            "scrapePageAds.activeStatus": {
              "default": "all",
              "enum": [
                "all",
                "active",
                "inactive"
              ],
              "type": "string"
            },
            "scrapePageAds.countryCode": {
              "default": "ALL",
              "description": "2-letter ISO country code (ISO 3166-1 alpha-2). This should be the official uppercase country code, such as `IN` for India, `US` for United States, etc. Use `ALL` for targeting all countries",
              "type": "string"
            },
            "scrapePageAds.period": {
              "default": "",
              "description": "Search ads in given date range",
              "enum": [
                "",
                "last24h",
                "last7d",
                "last14d",
                "last30d"
              ],
              "type": "string"
            },
            "scrapePageAds.sortBy": {
              "default": "impressions_desc",
              "description": "Sort by impressions or date. Default: Impressions",
              "enum": [
                "impressions_desc",
                "most_recent"
              ],
              "type": "string"
            },
            "urls": {
              "description": "List of facebook ads search URLs or Page URLs to scrape ads from",
              "items": {
                "additionalProperties": false,
                "properties": {
                  "headers": {
                    "additionalProperties": {
                      "type": "string"
                    },
                    "propertyNames": {
                      "type": "string"
                    },
                    "type": "object"
                  },
                  "method": {
                    "type": "string"
                  },
                  "payload": {
                    "type": "string"
                  },
                  "url": {
                    "format": "uri",
                    "type": "string"
                  },
                  "userData": {
                    "additionalProperties": {},
                    "propertyNames": {
                      "type": "string"
                    },
                    "type": "object"
                  }
                },
                "required": [
                  "url"
                ],
                "type": "object"
              },
              "type": "array"
            }
          },
          "required": [
            "urls",
            "scrapePageAds.period",
            "scrapePageAds.activeStatus",
            "scrapePageAds.sortBy",
            "scrapePageAds.countryCode"
          ],
          "type": "object"
        },
        "options": {
          "additionalProperties": false,
          "description": "Optional Apify run options.",
          "properties": {
            "build": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": {
              "maximum": 100000,
              "minimum": 1,
              "type": "integer"
            },
            "memory": {
              "maximum": 32768,
              "minimum": 128,
              "type": "integer"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "additionalProperties": false,
          "properties": {
            "input": {
              "additionalProperties": {},
              "description": "Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).",
              "properties": {
                "count": {
                  "description": "Leave this field empty if you want to limit number of ads scraped",
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "limitPerSource": {
                  "description": "Limit number of ads scraped per input URL. Leave it blank to scrape all available ads ℹ️ Actual number might exceed the given limit by upto 30",
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "proxy": {
                  "additionalProperties": {},
                  "description": "You can use this option to customise the proxy country",
                  "properties": {
                    "apifyProxyCountry": {
                      "type": "string"
                    },
                    "apifyProxyGroups": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "proxyUrls": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "useApifyProxy": {
                      "type": "boolean"
                    }
                  },
                  "type": "object"
                },
                "runTag": {
                  "description": "Add this value to 'runTag' column in the output",
                  "type": "string"
                },
                "scrapeAdDetails": {
                  "description": "Enable this option to scrape ads details such as EU Reach info",
                  "type": "boolean"
                },
                "scrapePageAds.activeStatus": {
                  "default": "all",
                  "enum": [
                    "all",
                    "active",
                    "inactive"
                  ],
                  "type": "string"
                },
                "scrapePageAds.countryCode": {
                  "default": "ALL",
                  "description": "2-letter ISO country code (ISO 3166-1 alpha-2). This should be the official uppercase country code, such as `IN` for India, `US` for United States, etc. Use `ALL` for targeting all countries",
                  "type": "string"
                },
                "scrapePageAds.period": {
                  "default": "",
                  "description": "Search ads in given date range",
                  "enum": [
                    "",
                    "last24h",
                    "last7d",
                    "last14d",
                    "last30d"
                  ],
                  "type": "string"
                },
                "scrapePageAds.sortBy": {
                  "default": "impressions_desc",
                  "description": "Sort by impressions or date. Default: Impressions",
                  "enum": [
                    "impressions_desc",
                    "most_recent"
                  ],
                  "type": "string"
                },
                "urls": {
                  "description": "List of facebook ads search URLs or Page URLs to scrape ads from",
                  "items": {
                    "additionalProperties": false,
                    "properties": {
                      "headers": {
                        "additionalProperties": {
                          "type": "string"
                        },
                        "propertyNames": {
                          "type": "string"
                        },
                        "type": "object"
                      },
                      "method": {
                        "type": "string"
                      },
                      "payload": {
                        "type": "string"
                      },
                      "url": {
                        "format": "uri",
                        "type": "string"
                      },
                      "userData": {
                        "additionalProperties": {},
                        "propertyNames": {
                          "type": "string"
                        },
                        "type": "object"
                      }
                    },
                    "required": [
                      "url"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                }
              },
              "required": [
                "urls",
                "scrapePageAds.period",
                "scrapePageAds.activeStatus",
                "scrapePageAds.sortBy",
                "scrapePageAds.countryCode"
              ],
              "type": "object"
            },
            "options": {
              "additionalProperties": false,
              "description": "Optional Apify run options.",
              "properties": {
                "build": {
                  "maxLength": 100,
                  "minLength": 1,
                  "type": "string"
                },
                "maxItems": {
                  "maximum": 100000,
                  "minimum": 1,
                  "type": "integer"
                },
                "memory": {
                  "maximum": 32768,
                  "minimum": 128,
                  "type": "integer"
                }
              },
              "type": "object"
            }
          },
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}