Adspirer icon

Adspirer

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

Actions119

List Meta Campaigns

AI-generated

Summary

Retrieve a list of Meta advertising campaigns from a specified Meta Ad Account, optionally filtered by parameters such as effective status, objective, and campaign status, with a limit on the number of campaigns returned.

Inputs

  • Ad Account Id (required) — Specify the Meta Ad Account ID to fetch campaigns from.
  • Effective Status — Comma-separated string to filter campaigns by their effective status.
  • Objective — Filter campaigns by objective such as OUTCOME_TRAFFIC, OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_AWARENESS, or OUTCOME_ENGAGEMENT.
  • Status — Comma-separated string to filter campaigns by their status, e.g., 'ACTIVE,PAUSED'.
  • Limit — Maximum number of campaigns to return, numeric string (default is 100, maximum is 500). Leave blank to omit.

Output shape

a list of campaign objects representing Meta ads campaigns matching the given filters

The output list will adhere to the provided limit if set (default 100, max 500). Filters like effective status, objective, and status are optional and if not set, campaigns are returned unfiltered on those criteria.

Examples

Example 1: List up to 50 active Meta ad campaigns with the objective OUTCOME_TRAFFIC from a specific Meta Ad Account.

Platform set to Meta Ads, Ad Account Id provided, Status set to 'ACTIVE', Objective set to 'OUTCOME_TRAFFIC', and Limit set to '50'.

Links

Discussion