---
title: "Meta Analyst Metric Data"
method: GET
path: "/api/v1/new-meta-analytics/meta-analyst-metric-data"
tags: ["newMetaAnalytics"]
---

# Meta Analyst Metric Data

`GET /api/v1/new-meta-analytics/meta-analyst-metric-data`

API endpoint for Meta Analyst metric-based data:
Returns top campaigns and top ads sorted by selected metric.

Supports both predefined time periods (7, 14, 30, 60, 90, all) and custom date ranges.
If start_date and end_date are provided, they take precedence over time_period.

## Query parameters

- `time_period` string
- `start_date` string, nullable — Custom start date in YYYY-MM-DD format
- `end_date` string, nullable — Custom end date in YYYY-MM-DD format
- `metric` string — Metric to sort by: spend, impressions, clicks, reach, conversions, ctr, cpm, cpc, roas
- `keywords` string, nullable — Keywords to search in campaign/ad names (comma-separated)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/a9374f6fe96c/schema)