/api/v1/mentions
List mentions
Endpoint
- Method:
GET - Path:
/api/v1/mentions
Base URL
https://api.mentionkit.com
Authentication
Use Authorization: Bearer YOUR_API_KEY.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| sort | query | No | string (newest, oldest) | Sort order for results. |
| cursor | query | No | integer | Use this for pagination (pass the previous nextCursor value). |
| projectId | query | No | integer | Filter by one project ID. |
| category | query | No | string (brand, industryinsights, competitorkeywords) | Filter by keyword category. |
| platform | query | No | string | Filter by platform (reddit, x, twitter, linkedin, hn, or hackernews). |
| keywords | query | No | string | Comma-separated keywords, e.g. mentionkit,social listening. |
Responses
200: Mentions fetched successfully.
- Content-Type:
application/json - Schema:
MentionListResponse - Example:
{
"items": [
{
"id": 2001,
"platform": "REDDIT",
"keywordValue": "example alternative",
"projectId": 3001,
"subreddit": "saas",
"authorHandle": "user_123",
"text": "Looking for alternatives to ExampleMonitor for social listening.",
"sourceCreatedAt": "2026-03-20T10:15:00.000Z",
"createdAt": "2026-03-20T10:15:02.000Z",
"relevance": -1,
"relevanceText": null,
"comment": "I switched last month and setting keyword filters first reduced a lot of noise.",
"commentStatus": 1,
"platformPostId": "p_abc123",
"redditPostId": "rp_abc123",
"redditCommentId": "rc_def456"
}
],
"nextCursor": null,
"limit": 50,
"sort": "newest"
}401: Missing or invalid API key.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "Invalid API key"
}403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "API access requires a trial, paid subscription, or billing exemption"
}500: Unexpected server error.
- Content-Type:
application/json - Schema:
ErrorResponse
Error codes
401: Missing or invalid API key.403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.500: Unexpected server error.
