---
title: "Fetch Search Ads Pages (POST)"
method: POST
path: "/v1/data/facebook/fetch_search_ads_pages"
tags: ["Facebook: Meta Ads Library Search"]
---

# Fetch Search Ads Pages (POST)

`POST /v1/data/facebook/fetch_search_ads_pages`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/facebook/fetch_search_ads_pages`
- Auth: API key in header `Authorization`

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.

## Request body

- object
  - `query` string: Search query string
  - `ad_page_id` string: Facebook Ad Page ID. Used only if query is not provided.
  - `country` string: Country filter (e.g. ALL, US, GB)
  - `activeStatus` string: Filter by active status (e.g. ALL, ACTIVE, INACTIVE)
  - `end_cursor` string: Pagination cursor for next page of results
  - `after_time` string: Filter ads created after this time
  - `before_time` string: Filter ads created before this time
  - `sort_data` string: Sort order for results

## Response `200`

Successful response

- object

## Other responses

- `400`: Bad request
- `401`: Unauthorized - invalid API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/superagnt/apis/superagnt-api.md) · [All operations](https://skmtc.dev/superagnt/apis/superagnt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superagnt/apis/superagnt-api/revisions/b2d8de30ccf0?raw)