---
title: "Daily metrics for a tracked keyword"
method: GET
path: "/keywords/{keywordId}/metrics"
tags: ["Social Listening"]
---

# Daily metrics for a tracked keyword

`GET /keywords/{keywordId}/metrics`

Daily mention, engagement, sentiment, and per-platform breakdown for a keyword over a window. Internal API-spend fields (costs/totalCost) are never exposed.

## Path parameters

- `keywordId` string, required

## Query parameters

- `workspaceId` string, required
- `range` '7d' | '14d' | '30d'
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Daily metrics series

- object
  - `data` object[], required
    - `date` string, date-time, required
    - `mentions` number, required
    - `engagement` number, required
    - `sentiment` object
      - `positive` number, required
      - `negative` number, required
      - `neutral` number, required
    - `platformBreakdown` object, required

## Other responses

- `401` — Unauthorized
- `403` — Token cannot read this workspace
- `404` — Keyword is not tracked by this workspace
- `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)