facebook_adLibrary_ads_search_get

Parameters schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "trim": {
      "type": "boolean",
      "description": "When true, returns a smaller response with fewer fields."
    },
    "query": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "Search query text for Facebook Ad Library ads."
    },
    "adType": {
      "enum": [
        "all",
        "political-and-issue"
      ],
      "type": "string",
      "description": "Optional filter for all ads or political and issue ads."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque pagination cursor from a previous response."
    },
    "sortBy": {
      "enum": [
        "impressions",
        "most-recent"
      ],
      "type": "string",
      "description": "Optional sort order for returned ads."
    },
    "status": {
      "enum": [
        "all",
        "active",
        "inactive"
      ],
      "type": "string",
      "description": "Optional ad status filter."
    },
    "country": {
      "type": "string",
      "maxLength": 3,
      "minLength": 2,
      "description": "Optional country code filter. Use ALL to search all countries."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional end date filter in YYYY-MM-DD format."
    },
    "mediaType": {
      "enum": [
        "all",
        "image",
        "video",
        "meme",
        "image-and-meme",
        "none"
      ],
      "type": "string",
      "description": "Optional creative media filter."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional start date filter in YYYY-MM-DD format."
    },
    "searchType": {
      "enum": [
        "keyword-unordered",
        "exact-phrase"
      ],
      "type": "string",
      "description": "Optional keyword matching mode for the search query."
    }
  }
}

No endpoints wrapped at confidence ≥ 0.70.

Parent server