SocialAPIs icon

SocialAPIs

Access public data from major social platforms

Meta Ads Library → Search Ads

AI-generated

Summary

Search ads in the Meta Ads Library by keyword or page ID, optionally filtering and sorting results.

Inputs

  • limit — Max number of results to return
  • additionalFields — Optional fields to include in the response
  • requestOptions — HTTP request options such as batching and timeout
  • allowUnauthorizedCerts — Whether to accept SSL certificate validation failures
  • proxy — HTTP proxy to use (e.g. http://username:password@host:port)
  • timeout — Request timeout in milliseconds

Output shape

a list of ad objects

Pagination may be indicated by an end_cursor in the response; optional filtering fields can be included via additionalFields.

Examples

Example 1: Search ads by keyword with limit 10 and sort by impressions

limit=10, query='marketing', sort_data='impressions', additionalFields={'activeStatus':'Active'}

Example 2: Fetch ads from a specific page with pagination

ad_page_id='12345', limit=5, additionalFields={'end_cursor':'abc123'}

Links

Discussion