/api/v1/keywords
List keywords
Endpoint
- Method:
GET - Path:
/api/v1/keywords
Base URL
https://api.mentionkit.com
Authentication
Use Authorization: Bearer YOUR_API_KEY.
Parameters
No parameters.
Responses
200: Keywords fetched successfully.
- Content-Type:
application/json - Schema:
KeywordListResponse - Example:
{
"items": [
{
"id": 4001,
"value": "example alternative",
"category": "brand",
"englishOnly": true,
"mentionCount": 0,
"projectId": 3001,
"createdAt": "2026-03-24T01:35:50.247Z",
"updatedAt": "2026-03-24T01:45:03.878Z",
"platforms": [
{
"platform": "REDDIT",
"enabled": true
}
]
}
],
"total": 2
}401: Missing or invalid API key.
- Content-Type:
application/json - Schema:
ErrorResponse
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.
