Logo SearchApi

Meta Ad Library Page Info API Documentation

GET   /api/v1/search?engine=meta_ad_library_page_info

This API retrieves detailed information about a Facebook page from the Meta Ad Library. It returns page metadata including name, category, likes, verification status, confirmed owner, transparency info (creation date, name changes, admin locations), Instagram details, related pages, and ad spend data.

API Parameters

Search Params

  • Name
    page_id
    Required
    Required
    Description

    Specifies the Facebook page ID to retrieve information for. You can obtain it in two ways:

Engine

  • Name
    engine
    Required
    Required
    Description

    Specifies the search engine. Must be set to meta_ad_library_page_info.

Api Key

  • Name
    api_key
    Required
    Required
    Description

    Your API key for authentication. Include it as a query parameter (?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Response with page and ad_library_page_info blocks

Response with <code>page</code> and <code>ad_library_page_info</code> blocks
GET
https://www.searchapi.io/api/v1/search?engine=meta_ad_library_page_info&page_id=1105633242835047
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "meta_ad_library_page_info",
  "page_id": "1105633242835047"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_example",
    "status": "Success",
    "created_at": "2026-02-20T10:00:00Z",
    "request_time_taken": 1.23,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.24,
    "request_url": "https://www.facebook.com/api/graphql/",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_example?format=html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_example?format=json"
  },
  "search_parameters": {
    "engine": "meta_ad_library_page_info",
    "page_id": "1105633242835047"
  },
  "page": {
    "name": "HOFF",
    "id": "1105633242835047",
    "url": "https://facebook.com/TheHOFFBrand",
    "about": {
      "text": "The HOFF Brand Official\nExpress Yourself \nTag #HoffCommunity to be featured"
    },
    "is_delegate_page_with_linked_primary_profile": false,
    "confirmed_page_owner": {
      "name": "THE HOFF BRAND SL.",
      "information": {
        "address": {
          "country": "Spain"
        }
      },
      "id": "1163378067031211"
    },
    "pages_transparency_info": {
      "history_items": [
        {
          "event_time": "2022-01-04T10:44:14Z",
          "item_type": "NAME_CHANGE"
        },
        {
          "event_time": "2016-05-13T08:37:04Z",
          "item_type": "NAME_CHANGE"
        },
        {
          "event_time": "2016-05-13T08:29:37Z",
          "item_type": "CREATION"
        }
      ],
      "id": "dHJhbnNwYXJlbmN5OjExMDU2MzMyNDI4MzUwNDc=",
      "admin_locations": {
        "admin_country_counts": [
          {
            "count": 14,
            "country": {
              "iso_name": "Spain",
              "id": "119422531140"
            }
          },
          {
            "count": 2,
            "country": {
              "iso_name": "Colombia",
              "id": "92735937793"
            }
          },
          {
            "count": 1,
            "country": {
              "iso_name": "Argentina",
              "id": "93790763357"
            }
          }
        ]
      }
    },
    "shared_disclaimer_info": {
      "shared_disclaimer_pages": []
    }
  },
  "ad_library_page_info": {
    "page_info": {
      "page_name": "HOFF",
      "page_is_deleted": false,
      "page_is_actioned": false,
      "profile_photo": "https://scontent-atl3-1.xx.fbcdn.net/...",
      "related_pages": [
        {
          "category_name": "Clothing Company",
          "country": "IL",
          "country_name": "Israel and other locations",
          "page_id": "102577586220982",
          "page_name": "HOFF",
          "page_verification": "NOT_VERIFIED",
          "profile_image_uri": "https://scontent-atl3-1.xx.fbcdn.net/..."
        },
        {
          "category_name": "Design & fashion",
          "country": "CO",
          "country_name": "Colombia",
          "page_id": "254562594405934",
          "page_name": "HOFF",
          "page_verification": "NOT_VERIFIED",
          "profile_image_uri": "https://scontent-atl3-3.xx.fbcdn.net/..."
        }
      ],
      "has_blank_ads": true,
      "hidden_ads": 0,
      "page_profile_uri": "https://facebook.com/TheHOFFBrand",
      "page_id": "1105633242835047",
      "page_verification": "BLUE_VERIFIED",
      "entity_type": "PERSON_PROFILE",
      "page_alias": "TheHOFFBrand",
      "likes": 179127,
      "page_category": "Clothing Company",
      "ig_verification": true,
      "ig_username": "thehoffbrand",
      "ig_followers": 570921
    },
    "page_spend": {
      "lifetime_by_disclaimer": [],
      "weekly_by_disclaimer": []
    }
  }
}