---
title: "Get Facebook placement insights"
method: GET
path: "/api/v1/facebook/insights/placements"
---

# Get Facebook placement insights

`GET /api/v1/facebook/insights/placements`

## Request

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

Get performance insights broken down by ad placement (e.g. Facebook Feed, Instagram Stories, Audience Network, Messenger). Use when user asks 'placement breakdown', 'where are my ads showing', 'which placements perform best', 'Facebook vs Instagram performance'.

## Query parameters

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

## Response `200`

Placement breakdown of ad performance

- 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)