get/fetch_search_ads_pages

Fetch Search Ads Pages (GET)

Meta Ads Library Search

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access Facebook data through agntdata: Fetch Search Ads Pages (GET). This endpoint retrieves detailed information about ad pages based on a search query, returning up to 26 ads per request. Use the end_cursor parameter to retrieve additional ads if needed. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need page and group posts, marketplace listings, video content, and ad discovery programmatically.

Use cases

AI agents that need Facebook data in structured form

Analytics and monitoring pipelines for Facebook content

Research and GTM workflows that combine Facebook signals with other data

Parameters

Name	In	Type	Required	Description
country	query	string	optional	—
after_time	query	string	optional	—
before_time	query	string	optional	—
ad_page_id	query	string	optional	Facebook AD Page ID. Used only if `query` is not provided.
activeStatus	query	string	optional	—
end_cursor	query	string	optional	—
query	query	string	optional	—Default: `for kids`

Responses

Successful response

{
  "type": "object"
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Fetch_Search_Ads_Pages__GET",
  "method": "get",
  "path": "/fetch_search_ads_pages",
  "summary": "Fetch Search Ads Pages (GET)",
  "description": "This endpoint retrieves detailed information about ad pages based on a search query, returning up to 26 ads per request. Use the end_cursor parameter to retrieve additional ads if needed.",
  "parameters": [
    {
      "name": "country",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "after_time",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "before_time",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ad_page_id",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      },
      "description": "Facebook AD Page ID. Used only if `query` is not provided."
    },
    {
      "name": "activeStatus",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "end_cursor",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "query",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "for kids"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Successful response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Bad request"
    },
    {
      "statusCode": "401",
      "description": "Unauthorized - invalid API key"
    },
    {
      "statusCode": "429",
      "description": "Rate limit exceeded"
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Start for free

Related endpoints

postFetch Search Ads Pages (POST)

/fetch_search_ads_pages

getDownload Media

/download_media

getFetch Search Videos

/search_facebook_watch_videos

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

Get started for free View all endpoints

Facebook APIFacebook data APIfetch search ads pages (get) APIAI agents data APIFacebook APIFacebook data APIFacebook for AI agents

Back to Facebook