---
title: "Get Facebook account-level insights"
method: GET
path: "/api/v1/facebook/insights/account"
---

# Get Facebook account-level insights

`GET /api/v1/facebook/insights/account`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/facebook/insights/account`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

Get aggregated performance insights for the entire Facebook Ad account including impressions, clicks, spend, CTR, CPC, and conversions. Use when user asks 'how are my Facebook ads performing', 'show my Facebook ad spend', 'Facebook account performance'.

## Query parameters

- `date_preset` string
- `start_date` string, date
- `end_date` string, date

## Response `200`

Account-level performance insights

- object

## Other responses

- `401`: Authentication required
- `500`: Internal server error
- `503`: Facebook Marketing not configured or not authenticated

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)