# Ranktrack — Full reference

## Product

Ranktrack is a SaaS tool that tracks how a mobile app ranks for any search keyword on the Apple App Store and Google Play, across any country. It's built for App Store Optimization (ASO) work: founders, growth teams, and agencies measuring how metadata changes, screenshot updates, and localization affect storefront visibility over time.

The product is intentionally narrow — it does rank tracking, not analytics, not install attribution, not reviews monitoring.

Primary URL: https://useranktrack.com
Contact email: hello@useranktrack.com

## Coverage

| Storefront            | Platform identifier |
|-----------------------|---------------------|
| Apple App Store iPhone  | iphone   |
| Apple App Store iPad    | ipad     |
| Mac App Store           | mac      |
| Google Play             | android  |

- Apple storefronts supported: 175 (every region the iTunes Search API serves)
- Google Play markets supported: 180

## Tracked-keyword limits

A "tracked keyword" is one keyword × country combination — the unit Ranktrack meters, since each one is a separate rank lookup per refresh. Tracking "vpn" in the US and the UK counts as 2.

| Plan  | Tracked keywords | Rank history |
|-------|------------------|--------------|
| Free  | 15               | 7 days       |
| Pro   | 300              | Full         |
| Power | Unlimited        | Full         |

- The cap only blocks new additions. Existing users already over a limit keep everything they have; they just can't add more until they upgrade or remove some.
- Removing a keyword or a country frees the cell immediately.
- Hitting the cap via the API returns HTTP 402.

## Refresh cadence

| Plan  | Auto-refresh interval | Manual refresh budget |
|-------|----------------------|------------------------|
| Free  | every 12 hours       | 3 manual refreshes / day |
| Pro   | every 2 hours        | unlimited |
| Power | every 1 hour         | unlimited |

The rank queue is deduplicated server-side: if N users track the same (platform, term, country) tuple, one API call serves all of them. This means heavy plans don't degrade lighter plans.

## Pricing

| Plan  | Monthly  | Tracked keywords | App groups | Auto-refresh | Rank history | Notifications | Outbound webhooks |
|-------|----------|------------------|------------|--------------|--------------|----------------|---------------------|
| Free  | $0       | 15               | 3          | 12h           | 7 days       | —              | —                   |
| Pro   | $12      | 300              | 10         | 2h            | Full         | All channels   | —                   |
| Power | $49      | Unlimited        | Unlimited  | 1h            | Full         | All channels   | HMAC-signed         |

- No credit card required for Free
- Cancel any time, switch tiers prorated
- Billing via DodoPayments

## Features

### Multi-platform app groups
An "app" in Ranktrack is a product. The user can attach iPhone, iPad, Mac, and Android entries to the same product group, tracked together. The same keyword can be tracked across all platforms with different country sets per keyword.

### Competitor flag
Users can mark a tracked app as a competitor. The dashboard renders a "Competitor" badge so the user doesn't confuse a tracked competitor's data with their own.

### Cross-platform keyword sync
- Copy keywords + countries from one platform to another in the same product group
- "Match all platforms" applies the union of all keywords and countries to every platform in the group

### Keyword views
- All keywords: matrix view (keyword rows × country columns)
- By country: pivot showing one country across all keywords
- Movers: cells that shifted since the last check, sorted by absolute delta
- Needs work: keywords ranking below 50 or dropped out

### Live rank checks
- Streaming refresh: rank cells update in the UI as the storefront responds, no full-page reload
- Per-cell manual refresh
- Per-keyword history modal with chart and prior-rank context

### Notifications
- Channels: Email, Telegram, Slack incoming webhook, custom HMAC-signed webhook
- Rules: rank moves by N+ positions, enters top N, leaves top N, drops out entirely
- Scope: all apps, single app, or single keyword
- Cooldown per rule (5 min, 15 min, 1 hour, 6 hours, 12 hours, 24 hours, or custom)
- Quiet hours (UTC window per rule)
- Digest cadence: off, daily, or weekly (daily at 08:00 UTC, weekly Mondays 08:00 UTC)

### Authentication
- Email + password
- Google OAuth
- GitHub OAuth
- Account linking by verified email — signing in with Google or GitHub on an existing email address links automatically; the original password keeps working

### Keyword explorer
Public endpoint at https://useranktrack.com/explore — anyone can search any keyword in any country on any storefront and see the top apps ranking right now. No signup required. Logged-out users see the top 10 results; logged-in users see the full 25.

### API access (Pro + Power)
Bearer-token API at `https://useranktrack.com/api/v1`. Endpoints cover apps, keywords, countries, ranks, and history. Reads return whatever the cron has stored (no live refresh); writes are immediate and queue new cells for the next cron tick.

Rate limits: Pro = 60 req/min per key, 5 keys total. Power = 300 req/min per key, 25 keys total. Free tier has no API access.

AI agents should read `https://useranktrack.com/skill.md` for the full operational guide — endpoint shapes, JSON schemas, recommended workflow.

## Common questions

**How fresh are the ranks?**
Hourly on Power, every 2 hours on Pro, every 12 hours on Free. Manual refresh is one click; Pro and Power are unlimited.

**Which stores and countries are covered?**
Apple App Store (iPhone, iPad, Mac) in all 175 storefronts, and Google Play across 180 markets.

**Can I track competitor apps?**
Yes — any public listing on either store. Mark them as a competitor for a badge.

**Do I need a credit card to start?**
No. Free covers 3 apps and 15 tracked keywords with 12-hour refreshes and 7 days of history.

**How many keywords can I track?**
A tracked keyword is one keyword × country. Free includes 15, Pro 300, Power unlimited. Upgrading raises the cap instantly; you keep everything you've already added.

**Will my team get notified?**
Email, Telegram, Slack, and signed webhooks are all wired in. Set rules, quiet hours, and digest cadence per channel.

**Can I cancel anytime?**
Yes — cancel mid-cycle, keep access until the period ends.

## Affiliations

Ranktrack is a Cyber Sky product (https://thecybersky.com).