read

Lists advertising campaigns across connected platforms (Google, Meta, TikTok, etc.): platform, name, status, objective,

Lists advertising campaigns across connected platforms (Google, Meta, TikTok, etc.): platform, name, status, objective, daily budget, and ROAS/CPA targets. Use for questions about what campaigns are running and how they are configured.

post/api/v1/tools/get_ad_campaigns

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/get_ad_campaigns
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: ads:read)

Request body

platformstring

Optional: filter by platform (e.g. "google", "meta", "tiktok").

statusstring

Optional: filter by campaign status (e.g. "enabled", "paused").

limitinteger

Max campaigns (default 50).

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.