采集 Meta 广告库公开广告记录

{
  "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": "必填 Meta/Facebook 广告库搜索链接或 Facebook 公共主页链接列表，以链接请求列表格式提供。广告库搜索链接沿用其自身搜索条件；Page 链接使用下方 Page 筛选。"
        },
        "count": {
          "type": "integer",
          "title": "#️⃣ Total number of records required",
          "editor": "number",
          "prefill": 100,
          "description": "可选，本次期望的总记录数。预填的 100 是示例，不是默认值。实际返回数量可能不同，不保证精确条数。"
        },
        "proxy": {
          "type": "object",
          "title": "Custom proxy",
          "editor": "proxy",
          "description": "可选代理配置，可在支持时指定网络路由国家。代理位置影响连接，与 Page 广告国家筛选不同。"
        },
        "runTag": {
          "type": "string",
          "title": "Run tag",
          "editor": "textfield",
          "description": "可选文字标签，来源可将其附在返回记录中。用于标注本次请求，不证明请求标识唯一或结果已经去重。"
        },
        "limitPerSource": {
          "type": "integer",
          "title": "#️⃣ Limit per input URL",
          "editor": "number",
          "description": "可选，每个输入链接期望获取的记录上限。省略时来源尝试获取可用广告；实际可能比所设上限多出最多 30 条，不保证严格停止或完整档案。"
        },
        "scrapeAdDetails": {
          "type": "boolean",
          "title": "Scrape ad details",
          "editor": "checkbox",
          "description": "可选，请求来源可提供的附加资料，例如欧盟透明度或触达信息。开启后也不保证每条广告、每个地区或类别都有这些资料。本例明确设为 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 链接：空值选择不限时间，也是默认值。last24h（最近 24 小时）、last7d（最近 7 天）、last14d（最近 14 天）、last30d（最近 30 天）请求相应来源时间范围，不保证完整历史覆盖；广告库搜索链接使用其自身条件。",
          "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 链接：impressions_desc 按来源展示次数由高到低排序，也是默认值；most_recent 请求按最近时间排序。排序不证明展示次数经过精确测量，也不代表全局广告排名。"
        },
        "scrapePageAds.countryCode": {
          "type": "string",
          "title": "Filter ads by country",
          "editor": "textfield",
          "default": "ALL",
          "prefill": "ALL",
          "description": "仅作用于 Page 链接：填写大写两位国家代码，例如 US（美国）、IN（印度），或 ALL（所有国家）；默认 ALL。筛选的是来源中的广告国家信息，不是广告主居住地或代理位置，也不保证完整国家覆盖。"
        },
        "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": "必填请求对象，包含必填链接列表，以及可选数量、附加详情、Page 筛选、代理和标签设置。Page 筛选只作用于 Page 链接。",
      "schemaVersion": 1
    }
  },
  "additionalProperties": false
}