Track Keyword

POST /v1/keywords/track

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",
  "platform": "apple",
  "country": "us"
}

Field	Type	Required	Description
keyword	string	Yes	Keyword to track (min 2 characters)
platform	string	No	`apple` (default) or `google` for Google Play — see Platforms
country	string	No	ISO country code (default `us`)

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"}'

const res = await fetch("https://api.appeeky.com/v1/keywords/track", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ keyword: "puzzle game" }),
});
const { data } = await res.json();
console.log(data.message); // "Keyword added to tracking list"

import requests

res = requests.post(
    "https://api.appeeky.com/v1/keywords/track",
    json={"keyword": "puzzle game"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]
print(data["message"])  # "Keyword added to tracking list"

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

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

Request Body

Code Examples

Response

Errors

​Request Body

​Code Examples

​Response

​Errors

Request Body

Code Examples

Response

Errors