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

# List mentions for a tracked keyword

`GET /keywords/{keywordId}/mentions`

Windowed mentions for a keyword, with optional platform/sentiment filter and sort. Brand listeners only return brand mentions. Mentions are returned as a curated, typed shape — common fields plus per-platform metric fields as optional properties.

## Path parameters

- `keywordId` string, required

## Query parameters

- `workspaceId` string, required
- `range` '7d' | '14d' | '30d'
- `startDate` string, date-time
- `endDate` string, date-time
- `platform` 'twitter' | 'youtube' | 'reddit' | 'tiktok' | 'facebook' | 'instagram'
- `sentiment` 'all' | 'positive' | 'negative' | 'neutral'
- `sortBy` 'engagement' | 'recency'
- `cursor` integer
- `limit` integer

## Response `200`

Mentions for the keyword

- object
  - `data` object[], required
    - `platform` string, required
    - `publishedAt` string, date-time, required
    - `engagement` number, required
    - `sentiment` 'positive' | 'negative' | 'neutral'
    - `url` string, required
    - `text` string, required
    - `author` object, required
      - `name` string, required
      - `username` string, nullable, required
      - `profileImageUrl` string, nullable, required
    - `likes` number
    - `comments` number
    - `shares` number
    - `views` number
    - `upvotes` number
    - `replies` number
    - `retweets` number
    - `quotes` number
    - `bookmarks` number
    - `impressions` number
    - `plays` number
    - `saves` number
  - `pagination` object, required
    - `nextCursor` number, nullable, required
    - `total` number, 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)