Scrape Creators · Facebook — Company Ads

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xCfA26F13c6C18307033EcE13BBb8F470dA5b4dbE",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "60000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "8VZEQmHM8ADqTSWMtnn3cMmevBaR1E8xrrzm2zf81g2U",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "60000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "body": {},
        "bodyType": "json",
        "method": "POST",
        "type": "http"
      }
    },
    "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": {
                "companyName": {
                  "description": "The name of the company. Can either use this or pageId",
                  "type": "string"
                },
                "country": {
                  "description": "This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.",
                  "type": "string"
                },
                "cursor": {
                  "description": "Cursor to paginate through results",
                  "type": "string"
                },
                "end_date": {
                  "description": "End date to search for. Format: YYYY-MM-DD",
                  "type": "string"
                },
                "language": {
                  "description": "Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc",
                  "type": "string"
                },
                "media_type": {
                  "description": "Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme.",
                  "enum": [
                    "ALL",
                    "IMAGE",
                    "VIDEO",
                    "MEME",
                    "IMAGE_AND_MEME",
                    "NONE"
                  ],
                  "type": "string"
                },
                "pageId": {
                  "description": "The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName",
                  "type": "string"
                },
                "sort_by": {
                  "description": "Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.",
                  "enum": [
                    "total_impressions",
                    "relevancy_monthly_grouped"
                  ],
                  "type": "string"
                },
                "start_date": {
                  "description": "Start date to search for. Format: YYYY-MM-DD",
                  "type": "string"
                },
                "status": {
                  "description": "Status of the ad. Defaults to ACTIVE.",
                  "enum": [
                    "ALL",
                    "ACTIVE",
                    "INACTIVE"
                  ],
                  "type": "string"
                },
                "trim": {
                  "description": "Set to true for a trimmed down version of the response",
                  "type": "boolean"
                }
              },
              "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"
    }
  }
}

curl "https://stablesocial.dev/api/sc/facebook/adLibrary/company/ads"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://stablesocial.dev/api/sc/facebook/adLibrary/company/ads");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://stablesocial.dev/api/sc/facebook/adLibrary/company/ads")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header