---
title: "Follower & engagement trend for your page and its competitors"
method: GET
path: "/pages/{id}/competitors/metrics"
tags: ["Competitors"]
---

# Follower & engagement trend for your page and its competitors

`GET /pages/{id}/competitors/metrics`

Daily follower and engagement series for your page and each tracked competitor over a window. Own and competitor engagement use slightly different bases (own = platform-reported, competitor = scraped). Instagram, Facebook, YouTube, TikTok, LinkedIn pages only.

## Path parameters

- `id` string, required

## Query parameters

- `range` '7d' | '30d' | '90d' | 'all'
- `scrapedPageIds` string[]
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Own + competitor trend series

- object
  - `data` object[], required
    - `id` string, required
    - `isOwn` boolean, required
    - `handle` string, required
    - `displayName` string, required
    - `platform` string, required
    - `profileImageUrl` string, nullable, required
    - `points` object[], required
      - `date` string, date-time, required
      - `followers` number, nullable, required
      - `engagement` number, nullable, required

## Other responses

- `400` — Page type does not support competitor analytics
- `401` — Unauthorized
- `403` — Token cannot read this page or the Analytics add-on is inactive
- `404` — Page not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/planable/apis/planable-public-api.md) · [All operations](https://skmtc.net/planable/apis/planable-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/planable/planable-public-api/revisions/e91a4f756dfe/schema)