Adds a keyword to your tracking list. Tracked keywords accumulate historical rank snapshots over time, which powers the Keyword Trends and Visibility endpoints.
Request Body
{
"keyword": "puzzle game"
}
| Field | Type | Required | Description |
|---|
| keyword | string | Yes | Keyword to track (min 2 characters) |
Code Examples
curl -X POST "https://api.appeeky.com/v1/keywords/track" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "puzzle game"}'
Response
Status: 201 Created
{
"data": {
"keyword": "puzzle game",
"message": "Keyword added to tracking list"
}
}
| Field | Type | Description |
|---|
| keyword | string | The tracked keyword |
| message | string | Confirmation message |
Idempotent upsert: If the keyword already exists in the tracking list, it is updated to active status. You can safely call this endpoint multiple times for the same keyword without creating duplicates.
Auto-tracking: Keywords you query through GET /v1/keywords/ranks are also added to your tracking list automatically once they’ve been queried more than once. If you already use the ranks endpoint for keyword research, many keywords will be tracked for you — no need to call this endpoint separately for those.
Errors
| Status | Code | When |
|---|
| 400 | INVALID_KEYWORD | Keyword shorter than 2 characters |
| 401 | UNAUTHORIZED | Missing or invalid API key |
| 429 | RATE_LIMITED | Too many requests — slow down |
| 500 | DB_ERROR | Database operation failed |
