SearchApi icon

SearchApi

Access real-time search results from Google, Google Images, Google Maps, Google Shopping and more, plus AI answers with cited sources from Google AI Mode, ChatGPT, Gemini and Bing Copilot. Use this when you need current, up-to-date information, product searches, location data, or visual content that may not be available in your training data.

Actions55

  • Google Actions
  • Google Images Actions
  • Google Maps Actions
  • Google Shopping Actions
  • Baidu Actions
  • Bing News Actions
  • Google Rank Tracking Actions
  • Bing Actions
  • Google Maps Place Actions
  • Google Maps Reviews Actions
  • Google Maps Photos Actions
  • Google Maps Directions Actions
  • Google Ads Transparency Center Actions
  • Google Ads Transparency Center Advertiser Search Actions
  • Google Ads Transparency Center Ad Details Actions
  • Google Ads Advertiser Info Actions
  • Meta Ad Library Actions
  • Meta Ad Library Ad Details Actions
  • Meta Ad Library Page Info Actions
  • Meta Ad Library Page Search Actions
  • Youtube Actions
  • Youtube Video Actions
  • Youtube Channel Actions
  • Youtube Channel Videos Actions
  • Youtube Comments Actions
  • Youtube Transcripts Actions
  • Youtube Trends Actions
  • Google Shopping Autocomplete Actions
  • Google Shopping Filters Actions
  • Google Flights Actions
  • Google Flights Calendar Actions
  • Google Flights Location Search Actions
  • Google Hotels Actions
  • Google Hotels Property Actions
  • Google Hotels Autocomplete Actions
  • Google News Actions
  • Google Jobs Actions
  • Tiktok Profile Actions
  • Instagram Profile Actions
  • Linkedin Ad Library Actions
  • Reddit Ad Library Actions
  • Tiktok Ads Library Actions
  • Tiktok Ads Library Advertiser Search Actions
  • Tiktok Ads Library Ad Details Actions
  • Yandex Actions
  • Yandex Reverse Image Actions
  • Duckduckgo Actions
  • Duckduckgo Light Actions
  • Duckduckgo Images Actions
  • Duckduckgo Videos Actions
  • Google AI Mode Actions
  • Google AI Overview Actions
  • ChatGPT Actions
  • Gemini Actions
  • Bing Copilot Actions

Meta Ad Library Ad Details → Search

AI-generated

Summary

Query Meta Ad Library Ad Details by providing either an Ad Archive ID or an Ad Details Token to retrieve detailed information about specific ads.

Inputs

  • Ad Archive ID — Specifies the unique ID of the ad to search for. Required if Ad Details Token is not provided.
  • Ad Details Token — A token obtained from the ad_details_token field on ads returned by the Meta Ad Library API. Using this provides more comprehensive data for political ads and EU or UK transparency data. Preferred over Ad Archive ID alone.
  • Zero Retention — When enabled, disables all logging and persistent storage of request parameters and responses, suitable for high-compliance use cases but limits debugging and support.

Output shape

a single JSON object representing detailed information about the requested Meta Ad Library ad, including fields relevant to political and transparency data when available.

The response shape depends on the availability of the specified ad in the Meta Ad Library. Using the Ad Details Token yields richer data. No pagination is involved as this is a detail fetch operation for one ad. Errors may occur if neither Ad Archive ID nor Ad Details Token is provided or the ad is not found.

Examples

Example 1: Retrieve ad details using Ad Archive ID

Set 'Ad Archive ID' to the desired ad's unique ID.

Example 2: Retrieve rich ad details using Ad Details Token

Set 'Ad Details Token' to the token from the Meta Ad Library API for enhanced data, especially for political/ad transparency.

Links

Discussion