ASO — Keywords

Track keywords and pull ranking history.

Updated 2026-05-24
2 min read

Keywords are tracked per project + store + country. Tracking enrolls the keyword in Forvibe's periodic ranking capture so you can chart movement over time.

List tracked keywords

bash
GET /api/v1/projects/:projectId/keywords?store_type=appstore&country=US

# Scope: aso:read

Track a new keyword

bash
POST /api/v1/projects/:projectId/keywords
Content-Type: application/json

{
  "store_type": "appstore",
  "keyword": "focus timer",
  "country": "US",
  "language": "en",
  "search_volume": 65,
  "difficulty": 40
}

# Scope: aso:write
# 409 DUPLICATE if the same (project, store, country, keyword) already exists

Untrack a keyword

bash
DELETE /api/v1/keywords/:keywordId

# Scope: aso:write
# Returns: 204 No Content

Ranking history

bash
GET /api/v1/keywords/:keywordId/rankings?days=30

# Scope: aso:read
# Returns: { data: { tracked_keyword_id, window_days, points: [{rank_position, captured_at}, ...] } }