SocialAPIs icon

SocialAPIs

Access public data from major social platforms

Meta Ads Library → Search by Keyword

AI-generated

Summary

Searches the Meta Ads Library for ads matching a keyword

Inputs

  • adsQuery (required) — Search keyword
  • additionalFields — Additional fields to include in the response
  • requestOptions — Request options such as batching settings
  • allowUnauthorizedCerts — Whether to accept the response even if SSL certificate validation is not possible
  • proxy — HTTP proxy to use
  • timeout — Time in ms to wait for the server to send response headers before aborting

Output shape

A list of ads matching the keyword, possibly with pagination metadata

The response may include pagination via an end_cursor; fields are optional and can be filtered via additionalFields.

Examples

Example 1: Search for ads related to "climate change" in the US

adsQuery: climate change, country: US, timeout: 10000

Example 2: Fetch ads with batch processing of 100 items per batch

adsQuery: renewable energy, requestOptions: {"batchSize": 100}, timeout: 15000

Links

Discussion