appgoat.ai

# AppGoat

> App store intelligence for your AI agent: apps, reviews, metric history, listing changes, keywords, competitors, top charts and developers for the App Store and Google Play. REST API at https://api.appgoat.ai/v1 and a remote MCP server at https://api.appgoat.ai/mcp.

Authenticate with the `x-api-key` header (keys start with `ag_`; the MCP server and examples read `APPGOAT_API_KEY`). `{app}` accepts any App Store id, Play package, bundle id, store URL or name. Every success is `{ data, meta }` with `meta.credits_used` and `meta.credits_remaining`; every error is `{ error: { code, message, hint, docs } }` (read `hint`). Data refreshes from the stores automatically when older than `max_age`. Failed requests are free. The Free plan has 250 credits a month plus a free first App Audit.

## Docs

- [Quickstart](https://docs.appgoat.ai): API key, first call (curl, JavaScript, Python), MCP in one command
- [MCP setup](https://docs.appgoat.ai/mcp-server/setup): Claude Code, Claude, Cursor, ChatGPT and other clients; tool list
- [Concepts](https://docs.appgoat.ai/concepts/app-resolver): {app} resolver, freshness (max_age, wait, country), envelope and meta, credits, pagination, rate limits
- [Errors](https://docs.appgoat.ai/errors/list): every error code with cause and fix
- [Webhooks](https://docs.appgoat.ai/webhooks): push watch events to a URL, Slack or GitHub; signature verification and retries
- [Connections](https://docs.appgoat.ai/connections): connect App Store Connect, Play Console and Apple Ads; actions with approval
- [API reference](https://docs.appgoat.ai/api-reference/introduction): every endpoint with parameters, credits and examples
- [OpenAPI 3.1](https://api.appgoat.ai/v1/openapi.json): machine-readable spec (no key needed)
- [llms-full.txt](https://appgoat.ai/llms-full.txt): this file plus the full reference, errors and playbooks in one document

## REST API (base https://api.appgoat.ai/v1)

### Apps

- [`GET /apps/{app}`](https://docs.appgoat.ai/api-reference/endpoint/get-app): Get everything about one app (metadata, ratings, price, markets, linked app in the other store). (credits: 1 + 1 per country refreshed from the store (max 10))
- [`GET /apps/{app}/reviews`](https://docs.appgoat.ai/api-reference/endpoint/list-reviews): List an app's user reviews, newest first, with filters (rating, version, date, text). (credits: 1 per page + 1 if the US reviews are refreshed)
- [`GET /apps/{app}/history`](https://docs.appgoat.ai/api-reference/endpoint/get-app-history): Get an app's daily metric history (rating, ratings count, installs, star histogram, price). (credits: 1 + 1 per country refreshed (max 10))
- [`GET /apps/{app}/changes`](https://docs.appgoat.ai/api-reference/endpoint/list-app-changes): List what changed in an app's store listing (version, title, subtitle, screenshots, price, IAP, …). (credits: 1 + 1 if the US listing is refreshed)
- [`GET /apps/{app}/keywords`](https://docs.appgoat.ai/api-reference/endpoint/list-app-keywords): List the search keywords an app ranks for, best rank first, with popularity and difficulty. (1 credit)
- [`GET /apps/{app}/competitors`](https://docs.appgoat.ai/api-reference/endpoint/list-competitors): Find an app's competitors (store "similar apps" plus apps ranking for the same keywords). (1 credit)
- [`GET /apps/{app}/insights`](https://docs.appgoat.ai/api-reference/endpoint/get-app-insights): Review intelligence for an app - top issues with trends and samples, topics per version, weekly sentiment. (25 credits)

### Search & charts

- [`GET /search`](https://docs.appgoat.ai/api-reference/endpoint/search-apps): Search the catalog (~5M apps in both stores) by app name or id. (1 credit)
- [`GET /charts`](https://docs.appgoat.ai/api-reference/endpoint/get-chart): Get a top chart (free, paid, grossing) for a store, country and category, today or on a past date. (1 credit)

### Keywords

- [`GET /keywords`](https://docs.appgoat.ai/api-reference/endpoint/get-keywords): Get keyword metrics (popularity, difficulty) for up to 25 terms; with include=related, keyword research. (credits: 1 per keyword; 5 per seed with include=related or suggestions)
- [`GET /tracked-keywords`](https://docs.appgoat.ai/api-reference/endpoint/list-tracked-keywords): List your tracked keywords with their latest top 10. (free)
- [`POST /tracked-keywords`](https://docs.appgoat.ai/api-reference/endpoint/track-keywords): Start tracking search ranks for keywords (daily re-rank; idempotent). (free)
- [`GET /tracked-keywords/{id}`](https://docs.appgoat.ai/api-reference/endpoint/get-tracked-keyword): Get one tracked keyword and its latest top 10. (free)
- [`PATCH /tracked-keywords/{id}`](https://docs.appgoat.ai/api-reference/endpoint/update-tracked-keyword): Change a tracked keyword's depth, cadence or tags. (free)
- [`DELETE /tracked-keywords/{id}`](https://docs.appgoat.ai/api-reference/endpoint/untrack-keyword): Stop tracking a keyword (frees its slot). (free)
- [`GET /tracked-keywords/{id}/ranks`](https://docs.appgoat.ai/api-reference/endpoint/get-tracked-keyword-ranks): Get a tracked keyword's ranking history (or one app's rank over time with app=). (1 credit)
- [`POST /tracked-keywords/{id}/run`](https://docs.appgoat.ai/api-reference/endpoint/run-tracked-keyword): Re-rank a tracked keyword now instead of waiting for the next scheduled run (paid plans). (credits: 1 when queued, 0 when the last hour's ranking is returned)

### Developers

- [`GET /developers/{dev}`](https://docs.appgoat.ai/api-reference/endpoint/get-developer): Get a developer's profile, all their apps and the same company in the other store. (1 credit)

### Audits

- [`POST /apps/{app}/audit`](https://docs.appgoat.ai/api-reference/endpoint/run-app-audit): Run an App Audit - prioritised ASO actions, metadata rewrites and findings with evidence (first one free). (credits: 100 (the first audit of an organization is free))
- [`GET /audits`](https://docs.appgoat.ai/api-reference/endpoint/list-audits): List your organization's App Audits, newest first, with status and score (free). (free)
- [`GET /audits/{id}`](https://docs.appgoat.ai/api-reference/endpoint/get-audit): Get one App Audit by id - poll this after POST /v1/apps/{app}/audit answered 202 (free). (free)
- [`PATCH /audits/{id}`](https://docs.appgoat.ai/api-reference/endpoint/update-audit): White-label an App Audit report with your branding (Studio) or switch it back, and set its label (free). (free)

### Watches & events

- [`GET /watches`](https://docs.appgoat.ai/api-reference/endpoint/list-watches): List your watches (apps, competitor sets, keyword sets) with usage against your plan's limits. (free)
- [`POST /watches`](https://docs.appgoat.ai/api-reference/endpoint/create-watch): Watch an app, a set of competitors or a set of keywords and get events when something significant changes. (free)
- [`GET /watches/{id}`](https://docs.appgoat.ai/api-reference/endpoint/get-watch): Get one watch with its apps, keyword slots, thresholds and event types. (free)
- [`PATCH /watches/{id}`](https://docs.appgoat.ai/api-reference/endpoint/update-watch): Change a watch (apps, competitors, terms, countries, event types, thresholds) or pause it with active=false. (free)
- [`DELETE /watches/{id}`](https://docs.appgoat.ai/api-reference/endpoint/delete-watch): Stop watching (frees its apps and keyword slots; past events are kept). (free)
- [`GET /events`](https://docs.appgoat.ai/api-reference/endpoint/list-events): List significant changes on your watched apps and keywords, newest first (free; poll this to wake an agent). (free)

### Webhooks

- [`GET /webhooks`](https://docs.appgoat.ai/api-reference/endpoint/list-webhooks): List your event endpoints (signed webhooks, Slack incoming webhooks, GitHub repository_dispatch). (free)
- [`POST /webhooks`](https://docs.appgoat.ai/api-reference/endpoint/create-webhook): Send events to a URL, a Slack channel or a GitHub repository (repository_dispatch) as they happen (paid plans). (free)
- [`GET /webhooks/{id}`](https://docs.appgoat.ai/api-reference/endpoint/get-webhook): Get one event endpoint with its delivery health (failure count, last success / failure). (free)
- [`PATCH /webhooks/{id}`](https://docs.appgoat.ai/api-reference/endpoint/update-webhook): Change an endpoint's URL, event types or description, re-enable it, or rotate its signing secret. (free)
- [`DELETE /webhooks/{id}`](https://docs.appgoat.ai/api-reference/endpoint/delete-webhook): Delete an event endpoint and its delivery log. (free)
- [`POST /webhooks/{id}/test`](https://docs.appgoat.ai/api-reference/endpoint/test-webhook): Send a `test` event to an endpoint now and see what it answered (status, body, latency). (free)
- [`GET /webhooks/{id}/deliveries`](https://docs.appgoat.ai/api-reference/endpoint/list-webhook-deliveries): List an endpoint's delivery log (every attempt's status, response and next retry), newest first. (free)

### Connections

- [`GET /connections`](https://docs.appgoat.ai/api-reference/endpoint/list-connections): List the connected App Store Connect, Play Console and Apple Ads accounts (ids, linked apps, status; never secrets). (free)
- [`POST /connections`](https://docs.appgoat.ai/api-reference/endpoint/create-connection): Connect an App Store Connect, Play Console or Apple Ads account (credentials are verified, then stored encrypted). (free)
- [`GET /connections/{id}`](https://docs.appgoat.ai/api-reference/endpoint/get-connection): Get one connection (status, linked apps, non-secret account identifiers). (free)
- [`PATCH /connections/{id}`](https://docs.appgoat.ai/api-reference/endpoint/update-connection): Rename a connection, switch it between read_only and actions, or change which apps it links. (free)
- [`DELETE /connections/{id}`](https://docs.appgoat.ai/api-reference/endpoint/delete-connection): Disconnect an account; its credentials are erased and open (draft / pending) actions are rejected. (free)
- [`POST /connections/{id}/verify`](https://docs.appgoat.ai/api-reference/endpoint/verify-connection): Re-check a connection's credentials with the provider (after fixing a role or key); lists every app it can access. (free)
- [`GET /connections/{id}/reviews`](https://docs.appgoat.ai/api-reference/endpoint/list-connection-reviews): Read your own app's reviews from App Store Connect / Play Console with reply status; their ids feed review.reply. (1 credit)
- [`GET /connections/{id}/listings`](https://docs.appgoat.ai/api-reference/endpoint/get-connection-listing): Read your app's current listing text for one locale and which fields can be edited right now. (1 credit)
- [`GET /connections/{id}/ads`](https://docs.appgoat.ai/api-reference/endpoint/get-connection-ads): Read Apple Ads campaigns, ad groups, keywords (with bids), negatives, or a performance report. (1 credit)

### Actions

- [`GET /actions`](https://docs.appgoat.ai/api-reference/endpoint/list-actions): List proposed and applied actions (drafts, pending approval, applied, failed, rejected), newest first. (free)
- [`POST /actions`](https://docs.appgoat.ai/api-reference/endpoint/create-action): Propose a write to a connected account (reply to a review, update a listing, set keywords, upload screenshots, change Apple Ads bids / keywords / negatives); always start with dry_run=true. (credits: 0 (dry run, pending approval) or 1 when auto-applied)
- [`GET /actions/{id}`](https://docs.appgoat.ai/api-reference/endpoint/get-action): Get one action with its diff, guardrail scores, status, result or error, and audit trail. (free)
- [`POST /actions/{id}/approve`](https://docs.appgoat.ai/api-reference/endpoint/approve-action): Go ahead with a draft or pending action; applies it when a person approves (or a rule allows), else submits it for approval. (credits: 1 when applied, else 0)
- [`POST /actions/{id}/reject`](https://docs.appgoat.ai/api-reference/endpoint/reject-action): Discard a draft or pending action (nothing is written to the account). (free)

### Jobs

- [`GET /jobs/{id}`](https://docs.appgoat.ai/api-reference/endpoint/get-job): Poll a background store fetch started by a read that answered refreshing:true (free). (free)

### Account

- [`GET /openapi.json`](https://docs.appgoat.ai/api-reference/endpoint/get-openapi): This OpenAPI 3.1 document (no key needed, free). (free)
- [`GET /me`](https://docs.appgoat.ai/api-reference/endpoint/get-me): Your plan, credits left this cycle and limits. (free)

Example:

```
curl "https://api.appgoat.ai/v1/apps/com.spotify.music?include=versions" \
  -H "x-api-key: $APPGOAT_API_KEY"
```

## MCP server

- Remote: `https://api.appgoat.ai/mcp` (Streamable HTTP), sign in with OAuth or send `x-api-key`
- Claude (claude.ai, Desktop, mobile): one click at https://claude.ai/directory/appgoat ("Add to Claude"), then sign in
- Cursor: one click at https://cursor.com/en-US/install-mcp?name=appgoat&config=eyJ1cmwiOiJodHRwczovL2FwaS5hcHBnb2F0LmFpL21jcCJ9
- ChatGPT: coming soon to the app directory; until then add a developer-mode app with the URL above
- Claude Code: `claude mcp add --transport http appgoat https://api.appgoat.ai/mcp`, then `/mcp` to sign in
- Windsurf, VS Code and other clients (`mcpServers` JSON): `{ "mcpServers": { "appgoat": { "url": "https://api.appgoat.ai/mcp" } } }`
- No npm package: stdio-only clients bridge with `npx -y mcp-remote https://api.appgoat.ai/mcp`
- Tools:
  - `get_app`: One app from any id, bundle id, package, store URL or name: metadata, ratings, version, description and the same app in the other store. include adds markets, versions, IAP, privacy, estimates and chart positions. (1 (+1 per country refreshed) credits)
  - `get_reviews`: Reviews, newest first, with star, version, date, text and AI-tag filters (intent=bug,crash). (1 per page credits)
  - `get_app_history`: Daily rating, ratings, installs, histogram and price history, with the change over the period. (1 credits)
  - `get_app_changes`: Listing change feed (title, subtitle, screenshots, price, version, …) with old and new values. (1 credits)
  - `get_app_keywords`: Search terms the app ranks for, with popularity and difficulty. (1 credits)
  - `get_competitors`: Competitors from shared keywords and the store's similar apps. (1 credits)
  - `search_apps`: Find apps by name or id across both stores. (1 credits)
  - `get_charts`: Top free, paid or grossing chart, today or on a past date, with moves and drop-outs. (1 credits)
  - `keyword_research`: Popularity, difficulty, results and #1 downloads for up to 25 terms; related terms, autocomplete, top apps; an app's rank and relevance per term. (1 per term, 5 per seed with related or suggestions credits)
  - `track_keywords`: Deprecated: use watch with kind keyword. Starts daily rank tracking. (free)
  - `untrack_keywords`: Deprecated: use unwatch. Stops tracking keywords. (free)
  - `list_tracked_keywords`: Deprecated: use list_watches. Your tracked keywords with their latest top 10. (free)
  - `get_keyword_ranks`: Ranking history of a tracked term, or one app's rank over time. (1 credits)
  - `get_developer`: Developer profile, all their apps and the same company in the other store. (1 credits)
  - `get_job`: Poll a background store fetch. (free)
  - `audit_app`: App Audit: score, prioritised ASO actions, metadata rewrites within the character limits, findings and a shareable report page. (100 (the first one is free) credits)
  - `get_audit`: Wait for or read an audit that audit_app started. (free)
  - `get_insights`: What users praise and complain about, from AI-tagged reviews: top issues with 30-day trends and samples, per-version changes, weekly sentiment. (25 credits)
  - `watch`: Watch an app, a set of competitors or keywords; significant changes become events. With id, change or pause a watch. (free)
  - `list_watches`: Your watches with their apps, terms and event types, and usage against the plan's limits. (free)
  - `unwatch`: Stop watches and free their apps and keyword slots. (free)
  - `get_events`: Significant changes on your watched apps and keywords (new versions, metadata, price, rating drops, rank moves), newest first. (free)
  - `list_playbooks`: The AppGoat playbooks (also served as MCP prompts). (free)
  - `list_connections`: Your connected App Store Connect, Play Console and Apple Ads accounts: ids, mode, status, linked apps. (free)
  - `read_connection`: Live data from a connection: own reviews with reply status, one listing locale with its editable fields, or Apple Ads campaigns, keywords and reports. (1 credits)
  - `propose_action`: Dry run of a change (review reply, listing update, keywords, screenshots, Apple Ads bids, keywords and negatives): before → after diff, guardrail scores and an action id. Nothing is written. (free)
  - `apply_action`: Go ahead with a proposed action: applied, or pending a person's approval (returns the dashboard link). (1 when applied credits)
  - `get_action`: Status, diff, result and audit trail of an action. (free)
  - `reject_action`: Discard a proposed action. (free)

## Playbooks

Agent Skills (appgoat/skills, repository private until its public release), also served as MCP prompts and by the `list_playbooks` tool; each playbook page links its SKILL.md.

- [App audit (lite)](https://appgoat.ai/playbooks/app-audit-lite) (`app-audit-lite`, ~25–40 credits per run): Runs a quick App Store / Google Play audit of one app with live AppGoat data – listing quality, ratings trend, recent complaints, keyword rankings, competitors and their recent changes – and ends with a prioritized fix list.
- [Find app ideas](https://appgoat.ai/playbooks/find-app-ideas) (`find-app-ideas`, ~150–250 credits per run): Finds underserved App Store / Google Play niches with live AppGoat data – search demand (keyword popularity) against weak supply (low ratings, abandoned incumbents, few strong apps) – and returns a ranked shortlist of app ideas with evidence and user pain points.
- [ASO keywords → metadata rewrite](https://appgoat.ai/playbooks/aso-keywords-metadata-rewrite) (`aso-keywords-metadata-rewrite`, ~40–80 credits per run): Researches App Store / Google Play keywords for one app with live AppGoat data (current ranks, competitor keyword gaps, popularity, difficulty, relevance) and rewrites the title, subtitle, keyword field and description within the store character limits.
- [Competitor digest](https://appgoat.ai/playbooks/competitor-digest) (`competitor-digest`, ~15–55 credits per run): Writes a weekly competitor digest for one App Store / Google Play app from an AppGoat competitor watch – what each competitor changed (title, subtitle, description, screenshots, icon), price and in-app purchase changes, new versions with release-note summaries, rating and chart moves, keyword gains and losses against the user's app, keyword gaps and review themes – and ends with 3 recommended actions linked to other playbooks. Sets up or reuses the competitor_set watch.
- [Reviews → GitHub issues](https://appgoat.ai/playbooks/reviews-to-github-issues) (`reviews-to-github-issues`, ~2–10 credits per run): Turns recent negative App Store / Google Play reviews into deduplicated GitHub issues – one issue per problem topic, with linked and quoted reviews, new reviews added as comments to the existing issue instead of duplicates. Uses AppGoat review data and the gh CLI (or the GitHub MCP server).
- [Reply to every review](https://appgoat.ai/playbooks/reply-to-every-review) (`reply-to-every-review`, ~1–3 + 1 per posted reply credits per run): Drafts a reply to every unanswered App Store and Google Play review of the user's own app, in the app's voice, through their connected App Store Connect / Play Console account – each reply is a dry run with a before/after diff and AppGoat guardrail scores (policy, tone, claims), and only the replies the user approves are posted.
- [Apple Ads optimizer](https://appgoat.ai/playbooks/apple-ads-optimizer) (`apple-ads-optimizer`, ~5–8 per campaign + 1 per applied change credits per run): Optimizes the user's Apple Ads (Search Ads) campaigns through their connected Apple Ads account – reads the last 14 days of keyword and search term reports, raises bids on keywords that convert under the target CPA (capped +30% per run), lowers or pauses keywords that spend without installs, adds converting search terms as exact keywords and wasteful ones as negatives – every change a dry run with a diff the user approves.
- [Localization push](https://appgoat.ai/playbooks/localization-push) (`localization-push`, ~35–60 per locale + 1 per applied change credits per run): Localizes the user's own App Store / Google Play listing into new languages through their connected App Store Connect or Play Console account – picks target locales from markets with demand, researches the keywords people actually search in each country with AppGoat, writes a localized name, subtitle, keyword field and promotional text (Play title, short and full description) within the store limits, and pushes each locale as a dry run with a before/after diff the user approves.

## Free tools and guides

- [Free ASO tools](https://appgoat.ai/tools): Index of the free App Store and Google Play tools.
- [App Ranking Tracker](https://appgoat.ai/tools/app-ranking-tracker): Any app’s top chart ranks by country and category (last 7 days) and the search keywords it ranks for.
- [ASO Keyword Research](https://appgoat.ai/tools/aso-keyword-research): Popularity, difficulty, related terms and top apps for any App Store or Google Play keyword.
- [Top charts](https://appgoat.ai/tools/top-charts): Daily top free, paid and grossing charts by store, country and category, with rank changes (/tools/top-charts/{app-store|google-play}/{country}/{category}[/paid|/grossing]).
- [Apple Search Ads optimization](https://appgoat.ai/solutions/apple-search-ads): Weekly Apple Ads bid, keyword and negative changes from your CPA target, proposed by your agent and applied after approval.
- [App review analysis](https://appgoat.ai/solutions/app-review-analysis): Review insights (top issues, topics per version, sentiment), reviews to GitHub issues and approved AI replies.
- [AI ASO (MCP server)](https://appgoat.ai/solutions/ai-aso): App Store Optimization with Claude, ChatGPT and Cursor through the AppGoat MCP server.
- [Google Play scraper API](https://appgoat.ai/developers/google-play-api): Hosted alternative to google-play-scraper: apps, reviews, charts, keywords.
- [App Store scraper API](https://appgoat.ai/developers/app-store-api): Hosted alternative to app-store-scraper and the iTunes Search API.
- [App ranking API](https://appgoat.ai/developers/app-ranking-api): Daily top charts with rank changes, app chart positions and keyword ranks.
- [Sensor Tower alternative](https://appgoat.ai/alternatives/sensor-tower): AppGoat compared with Sensor Tower.
- [AppTweak alternative](https://appgoat.ai/alternatives/apptweak): AppGoat compared with AppTweak.
- [Appfigures alternative](https://appgoat.ai/alternatives/appfigures): AppGoat compared with Appfigures.
- [data.ai (App Annie) alternative](https://appgoat.ai/alternatives/data-ai): AppGoat compared with data.ai (App Annie).

## Pricing

- Free ($0): 250 credits/month, first App Audit free, 25 tracked keywords, 3 watched apps, 1 request/second, no credit packs
- Indie ($27/month, $267/year): 10,000 credits/month, 2,500 tracked keywords, 25 watched apps, 10 requests/second, credit packs available
- Studio ($147/month, $1,467/year): 75,000 credits/month, 10,000 tracked keywords, 250 watched apps, 25 requests/second, credit packs available
- Credit packs (Indie and Studio only; never expire, used after the monthly credits): 2,000 credits for $17, 7,000 credits for $47, 17,000 credits for $97
- Enterprise: custom credits, limits and SLA (support@appgoat.ai)
- [Pricing page](https://appgoat.ai/pricing)

## Account

- [Sign up](https://dash.appgoat.ai/auth/sign-up): free plan, no credit card
- Support: support@appgoat.ai
- [Status](https://status.appgoat.ai): uptime and incidents