# Meta Ads API

> Search Meta's Facebook and Instagram Ad Library by keyword or advertiser. Retrieve ad details, advertiser pages, filter options, and API parameters from public Ad Library URLs.

Page: https://docs.toolzerhub.com/reference/meta-ads

## Meta Ads

Search Meta's Facebook and Instagram Ad Library by keyword or advertiser. Retrieve ad details, advertiser pages, filter options, and API parameters from public Ad Library URLs.

- [Get Meta ad details](https://docs.toolzerhub.com/reference/meta-ads/get-ad-details.md): `GET /v1/meta/ad-details`. Returns public metadata for one Meta ad, including its advertiser. Requires ad_archive_id and the advertiser page_id, both from a search or page-ads result. Optional country sets the region; raw returns the unprocessed payload.
- [List Meta ad filter options](https://docs.toolzerhub.com/reference/meta-ads/get-filter-options.md): `GET /v1/meta/filter-options`. Returns the languages, advertiser pages, and regions that match required query_string in the Meta Ad Library. Optional ad_type, country, and search_type set the context; raw returns the unprocessed payload.
- [List Meta ads by page ID](https://docs.toolzerhub.com/reference/meta-ads/get-page-ads.md): `GET /v1/meta/page`. Lists ads from the public Meta Ad Library for one advertiser, identified by required page_id. Filter by country, status, media type, dates, language, and platform. Use cursor to page; page_size is 1-50.
- [List Meta ads by page URL](https://docs.toolzerhub.com/reference/meta-ads/get-page-ads-without-id.md): `GET /v1/meta/page-by-url`. Lists Meta Ad Library ads for a Facebook Page given its url (page URL or username), with no numeric page_id needed. Filters and cursor pagination match Get Page Ads.
- [Resolve a Facebook Page ID](https://docs.toolzerhub.com/reference/meta-ads/resolve-page-id.md): `GET /v1/meta/page-id`. Converts a Facebook Page url (page URL or username) to the numeric Ad Library page_id used by the page endpoints. A bare numeric id or a profile.php?id= URL is returned as-is.
- [Resolve a Meta Ad Library URL](https://docs.toolzerhub.com/reference/meta-ads/resolve-meta-ads-url.md): `GET /v1/meta/resolve-url`. Parses a public Facebook Ad Library search or page-browse url and returns the matching operation (search or page) with its parameters. It returns resolution data only, not ads.
- [Search Meta ads by keyword](https://docs.toolzerhub.com/reference/meta-ads/search-ads.md): `GET /v1/meta/search`. Searches the public Meta Ad Library (Facebook and Instagram ads) for required q. Filter by country, delivery status, ad type, media type, dates, language, platform, advertiser page, and reach. Use cursor to page; page_size is 1-50.
- [Search Meta advertisers](https://docs.toolzerhub.com/reference/meta-ads/search-pages.md): `GET /v1/meta/search-pages`. Searches the Meta Ad Library for advertiser pages matching required q. Returns page IDs and verification details to use with the page endpoints. Optional country and ad_type narrow results; raw returns the unprocessed payload.