Adspirer icon

Adspirer

Manage ad campaigns across Google, Meta, LinkedIn & TikTok Ads via the Adspirer REST API

Actions119

List Meta Ads

AI-generated

Summary

Retrieve a list of Meta Ads from a specified Meta Ad Account, optionally filtering by ad set ID, campaign ID, ad status, and limiting the number of results.

Inputs

  • Ad Account Id (required) — The Meta Ad Account ID to fetch ads from.
  • Ad Set Id — Filter ads to those belonging to a specific ad set ID.
  • Campaign Id — Filter ads to those within a specific campaign ID.
  • Limit — Maximum number of ads to return (default is 100 if not specified). Must be numeric if provided.
  • Status — Comma-separated list of ad statuses to filter by (e.g., 'ACTIVE,PAUSED').

Output shape

a list of Meta Ads records

The returned data includes ads matching the provided filters. If 'Limit' is omitted, up to 100 ads are returned by default. Status filter accepts multiple comma-separated values. If no filters are set other than the Ad Account Id, all ads from that account up to the limit will be returned.

Links

Discussion