Collect Meta Ad Library ad records

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "title": "Facebook ads scraper",
      "required": [
        "urls"
      ],
      "properties": {
        "urls": {
          "type": "array",
          "title": "🔗 URLs",
          "editor": "requestListSources",
          "prefill": [
            {
              "url": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=IN&q=linkedin&search_type=keyword_unordered&media_type=all"
            },
            {
              "url": "https://www.facebook.com/ZapierApp"
            }
          ],
          "description": "Required list of Meta/Facebook Ad Library search URLs or Facebook Page URLs. Supply entries in the URL request-list format. Library search URLs keep their own search conditions; Page URLs use the Page filters below."
        },
        "count": {
          "type": "integer",
          "title": "#️⃣ Total number of records required",
          "editor": "number",
          "prefill": 100,
          "description": "Optional requested total record quantity. The prefilled 100 is an example, not a default. Actual results vary; this setting does not guarantee an exact count."
        },
        "proxy": {
          "type": "object",
          "title": "Custom proxy",
          "editor": "proxy",
          "description": "Optional proxy configuration, including a custom routing country where supported. Proxy location affects the connection and is separate from the Page ad-country filter."
        },
        "runTag": {
          "type": "string",
          "title": "Run tag",
          "editor": "textfield",
          "description": "Optional text label that the source can attach to returned records. Use it to label the request, not as proof of a unique run or deduplicated results."
        },
        "limitPerSource": {
          "type": "integer",
          "title": "#️⃣ Limit per input URL",
          "editor": "number",
          "description": "Optional requested limit for each input URL. If omitted, the source seeks available ads. It can return up to 30 more records than the selected limit; this is not a guaranteed hard stop or a complete-archive promise."
        },
        "scrapeAdDetails": {
          "type": "boolean",
          "title": "Scrape ad details",
          "editor": "checkbox",
          "description": "Optional request for extra source details, such as EU transparency or reach information where available. Enabling it does not guarantee these details for every ad, region or category. The example explicitly uses false."
        },
        "scrapePageAds.period": {
          "enum": [
            "",
            "last24h",
            "last7d",
            "last14d",
            "last30d"
          ],
          "type": "string",
          "title": "Date range",
          "editor": "select",
          "default": "",
          "prefill": "",
          "enumTitles": [
            "All time",
            "Last 24 hours",
            "Last 7 days",
            "Last 14 days",
            "Last 30 days"
          ],
          "description": "Page URLs only: an empty value selects All time and is the default. last24h, last7d, last14d and last30d request the source’s last 24 hours, 7 days, 14 days or 30 days. This window does not guarantee full historical coverage; library-search URLs use their own conditions.",
          "sectionCaption": "Search filters for page URLs",
          "sectionDescription": "When scraping page ads from page URLs, these filters will be applied to each pages ads search query"
        },
        "scrapePageAds.sortBy": {
          "enum": [
            "impressions_desc",
            "most_recent"
          ],
          "type": "string",
          "title": "Sort ads by",
          "editor": "select",
          "default": "impressions_desc",
          "prefill": "impressions_desc",
          "enumTitles": [
            "Impressions (High to Low)",
            "Most recent"
          ],
          "description": "Page URLs only: impressions_desc orders by source impressions from high to low and is the default; most_recent requests the most recent ordering. The ordering does not establish exact measured impressions or a global ad ranking."
        },
        "scrapePageAds.countryCode": {
          "type": "string",
          "title": "Filter ads by country",
          "editor": "textfield",
          "default": "ALL",
          "prefill": "ALL",
          "description": "Page URLs only: use an uppercase two-letter country code such as US or IN, or ALL for all countries; ALL is the default. This filters source ad-country information, not the advertiser’s residence or the proxy location, and does not guarantee complete country coverage."
        },
        "scrapePageAds.activeStatus": {
          "enum": [
            "all",
            "active",
            "inactive"
          ],
          "type": "string",
          "title": "Filter ads by active status",
          "editor": "select",
          "default": "all",
          "prefill": "all",
          "enumTitles": [
            "All",
            "Active",
            "Inactive"
          ],
          "description": ""
        }
      },
      "description": "Required request object containing the required URL list and optional quantity, detail, Page-filter, proxy and tagging settings. Page filters apply only to Page URLs.",
      "schemaVersion": 1
    }
  },
  "additionalProperties": false
}