---
title: "Search"
method: GET
path: "/v1/facebook/adLibrary/search/ads"
tags: ["Facebook Ad Library"]
---

# Search

`GET /v1/facebook/adLibrary/search/ads`

Searches the Meta Ad Library by keyword and returns matching ads. Supports filtering by language with a 2-letter code such as EN or ES. Each result includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body text, images, videos, and cta_text. Both GET and POST are supported. Use GET for normal requests. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body.

## Query parameters

- `query` string, required
- `sort_by` 'total_impressions' | 'relevancy_monthly_grouped'
- `search_type` 'keyword_unordered' | 'keyword_exact_phrase'
- `ad_type` 'all' | 'political_and_issue_ads'
- `country` string
- `language` string
- `status` 'ALL' | 'ACTIVE' | 'INACTIVE'
- `media_type` 'ALL' | 'IMAGE' | 'VIDEO' | 'MEME' | 'IMAGE_AND_MEME' | 'NONE'
- `start_date` string
- `end_date` string
- `cursor` string
- `trim` boolean

## Response `200`

Successful response

---

[API](https://skmtc.dev/scrapecreators/apis/scrape-creators-api.md) · [All operations](https://skmtc.dev/scrapecreators/apis/scrape-creators-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scrapecreators/scrape-creators-api/revisions/e9ec3dbbd8b8/schema)