read

Run a Meta Ads Insights query against the store's ad account. Pick a level (account/campaign/adset/ad), a date range (si

Changed on Oct 20, 2026

Run a Meta Ads Insights query against the store's ad account. Pick a level (account/campaign/adset/ad), a date range (since+until ISO dates, or a date_preset like last_7d/last_30d), optional breakdowns (e.g. "publisher_platform", "age,gender", "country") and optional explicit fields. Returns raw insight rows incl. spend, impressions, clicks, ctr, cpm, frequency, reach and the purchase actions/action_values. Queries the Meta Marketing API Insights endpoint, see https://developers.facebook.com/docs/marketing-api/insights

post/api/v1/tools/meta_run_insights

Request

Base URL: https://app.magistry.io
URL: https://app.magistry.io/api/v1/tools/meta_run_insights
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

level'account' | 'campaign' | 'adset' | 'ad'

Aggregation level (default campaign).

sincestring

ISO start date (with until).

untilstring

ISO end date (with since).

date_presetstring

Meta date preset (default last_30d) when since/until absent.

time_incrementinteger

1 for daily rows.

breakdownsstring

Comma-separated Meta breakdowns.

fieldsstring

Comma-separated insight fields (sane default).

limitinteger

Max rows (default 200).

Response

Tool result

okboolean required

resultunknown required

Changes

Oct 20, 20264a749f94b35c Revision changes
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new app_not_reviewed enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status
- warning
  added the new unsupported_behavior enum value to the response property for the response status

Operation history