---
title: "Channel metrics"
method: GET
path: "/social-media/channel-metrics"
tags: ["Social Media"]
---

# Channel metrics

`GET /social-media/channel-metrics`

## Request

- Base URL: `https://api.ahrefs.com/v3`
- URL: `https://api.ahrefs.com/v3/social-media/channel-metrics`
- Auth: HTTP bearer

>Requests to this endpoint are free and do not consume any API units.

## Query parameters

- `channel_id` string, required
- `date_from` string, date, required
- `date_to` string, date
- `output` 'json' | 'csv' | 'xml' | 'php'

## Response `200`

OK

- SocialMediaChannelMetrics
  - `metrics` object[]
    - `follower_count` integer: Number of followers at time of retrieval.
    - `retrieved_at` string, date-time: Timestamp when the metrics were last retrieved.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Error

---

[API](https://skmtc.dev/ahrefs/apis/ahrefs-api.md) - [All operations](https://skmtc.dev/ahrefs/apis/ahrefs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ahrefs/apis/ahrefs-api/revisions/667fedfff126?raw)