get_app
Look up one App Store or Google Play app: title, subtitle, developer, category, price, rating and histogram, installs (Play), version and dates, description, languages, and the same app in the other store. Accepts any id, bundle id, package, store URL or a name. Reads stored data (refreshed from the store only when older than max age, default 7 days) for one country (default us); add include sections for markets, versions, IAP, privacy, estimates and chart positions. Cost: 1 + 1 per country refreshed from the store (max 10) credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"wait": {
"type": "boolean",
"description": "Block up to ~25 s for a refresh (default). false = answer immediately from cache with a job id."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "ISO country code(s): `us` (default), a comma list (paid plans), or `all` (Studio). Example: us,de"
},
"include": {
"type": "array",
"items": {
"enum": [
"markets",
"iap",
"versions",
"privacy",
"estimates",
"charts"
],
"type": "string"
},
"description": "Extra sections: markets (every storefront), iap, versions (history with release notes), privacy (App Store labels), estimates (modelled downloads/revenue), charts (current top-chart positions)"
},
"max_age": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Refresh from the store when our data is older than this many seconds (0 = always). Default 604800 (7 days)."
},
"full_text": {
"type": "boolean",
"description": "Return long text (description, release notes, review bodies) in full instead of cut short"
}
}
}
get_reviews
Read an app's user reviews, newest first, up to 100 per page: rating, title, text, version, date, developer reply and AI tags (sentiment, intent, severity, topic) where tagged. Filter by stars (rating='1-2' for complaints), version, date range, text (q) or AI tags (intent='bug,crash'; tag filters skip untagged reviews). Page with cursor. Cost: 1 per page + 1 if the US reviews are refreshed credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"q": {
"type": "string",
"description": "Case-insensitive text search in the title and body. Example: crash"
},
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max items to return. Default: 50."
},
"since": {
"type": "string",
"description": "Only items at or after this ISO date / datetime. Example: 2026-10-01"
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"topic": {
"type": "string",
"description": "AI topic filter (comma list of topic labels, case-insensitive, or topic ids)."
},
"until": {
"type": "string",
"description": "Only reviews created before this ISO date / datetime."
},
"cursor": {
"type": "string",
"description": "`meta.next_cursor` from the previous page."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"intent": {
"type": "string",
"description": "AI intent filter (comma list): bug, crash, feature_request, pricing, ux, praise, spam, other. Example: bug,crash"
},
"rating": {
"type": "string",
"description": "Star rating filter, `1`, `1,2` or a range `1-3`. Example: 1-2"
},
"country": {
"type": "string",
"description": "ISO country code(s): `us` (default), a comma list (paid plans), or `all` (Studio). Example: us,de"
},
"max_age": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Refresh the latest US reviews when older than this many seconds. Default 86400 (1 day)."
},
"version": {
"type": "string",
"description": "Only reviews written for this app version."
},
"full_text": {
"type": "boolean",
"description": "Return long text (description, release notes, review bodies) in full instead of cut short"
},
"sentiment": {
"type": "string",
"description": "AI sentiment filter (comma list): positive, neutral, negative. Example: negative"
}
}
}
get_app_history
An app's daily metric history per country: rating, ratings count, reviews count, installs (Play), star histogram and price, one row per day a value changed (default the last 90 days), with the change over the period. Use it to chart growth or spot rating drops after a release. Cost: 1 + 1 per country refreshed (max 10) credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"to": {
"type": "string",
"description": "End date (ISO), default today."
},
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"from": {
"type": "string",
"description": "Start date (ISO), default 90 days before `to`."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "ISO country code(s): `us` (default), a comma list (paid plans), or `all` (Studio). Example: us,de"
}
}
}
get_app_changes
What changed in an app's store listing, newest first, with old and new values: version, release notes, title, subtitle, description, screenshots, icon, price, IAP, privacy, in-app events, badges, featuring, installs, content rating. Use it to monitor competitors ("what did X change this month?"). Cost: 1 + 1 if the US listing is refreshed credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"field": {
"type": "string",
"description": "Only these fields (comma list), e.g. `version,title,subtitle`."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max items to return. Default: 50."
},
"since": {
"type": "string",
"description": "Only items at or after this ISO date / datetime. Example: 2026-10-01"
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"cursor": {
"type": "string",
"description": "`meta.next_cursor` from the previous page."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "Only changes seen in these storefronts (comma list). Default all storefronts."
}
}
}
get_app_keywords
The search terms an app ranks for in a country, best rank first, with popularity (5–100) and difficulty (0–100): from the weekly keyword universe plus your tracked keywords. Call it for the app and a competitor to find keyword gaps. Cost: 1 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return. Default: 100."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"cursor": {
"type": "string",
"description": "`meta.next_cursor` from the previous page."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "Two-letter country code (default 'us')."
},
"max_rank": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Only terms where the app ranks at or above this position."
}
}
}
get_competitors
An app's competitors, best first, scored from search terms both apps rank for (shared keywords) plus the store's similar-apps list. Feed the app ids into get app or get app changes for a competitor digest. Cost: 1 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max items to return. Default: 20."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "Two-letter country code (default 'us')."
}
}
}
search_apps
Find apps by name or id in AppGoat's catalog of both stores (~5M apps): exact title matches first, then prefix, then substring, most-rated first. Returns store, app id, title, developer, category, rating, ratings and price; pass the app id to the other tools. Cost: 1 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "App name (≥ 2 characters) or exact id. Example: photo editor"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max items to return. Default: 20."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Limit to one store: 'apple' or 'play'. Omit for both."
},
"cursor": {
"type": "string",
"description": "`meta.next_cursor` from the previous page."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"category": {
"type": "string",
"description": "Store category name, e.g. `Photo & Video` (App Store) or `PHOTOGRAPHY` (Play)."
}
}
}
get_charts
A top free, paid or grossing chart for a store, country and category, today or on a past date: rank, app, developer, rating and the move since the previous capture (new entries marked), plus apps that dropped out. Charts are captured daily for every country and category. Cost: 1 credits.
Показать схему аргументов
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "The chart as of this date (ISO). Default the latest capture."
},
"chart": {
"enum": [
"free",
"paid",
"grossing"
],
"type": "string",
"description": "'free' (default), 'paid' or 'grossing'."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "How many ranks to return (default 100, max 200)."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "'apple' (default) or 'play'."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "Two-letter country code (default 'us')."
},
"category": {
"type": "string",
"description": "App Store genre id (`36` or `all` = all apps, `6014` = games, …) or Play category (`GAME_PUZZLE`; `APPLICATION` = all apps)."
}
}
}
keyword_research
Keyword metrics and research for App Store / Google Play search terms: popularity (5–100), difficulty (0–100), result count and the 1 result's estimated daily downloads. include adds related terms with metrics, the store's autocomplete and the current top 10 apps; app adds that app's rank and metadata relevance per term (the core of an ASO keyword audit). Unmeasured terms are measured live (a few per call) or come back pending. Keyword ideas: pass only app (no terms) to get the terms worth targeting for that app, best opportunity first: AI-checked for relevance (other apps' brand names and off
Показать схему аргументов
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Any app identifier (as in `{app}`); adds `app.rank` and `app.relevance` per term. Alone (no `q` / `qs`) it returns keyword ideas for the app."
},
"wait": {
"type": "boolean",
"description": "Block up to ~25 s for a refresh (default). false = answer immediately from cache with a job id."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Keyword ideas only. Default: 20."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Required unless `app` is given."
},
"terms": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 25,
"description": "Search terms, 1–25 (at most 5 with include related or suggestions). Omit, with app, for keyword ideas for that app"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "Two-letter ISO country code (storefront), e.g. us, gb, de. Default: us."
},
"include": {
"type": "array",
"items": {
"enum": [
"related",
"suggestions",
"top_apps"
],
"type": "string"
},
"description": "related (~10 related terms with metrics), suggestions (store autocomplete), top_apps (current top 10). related/suggestions cost 5 credits per term"
}
}
}
get_keyword_ranks
Ranking history of a watched keyword: per capture the top 10 app ids, or with app, that app's rank over time (best, worst, latest). Default the last 90 days. The id is a keyword slot of a keyword watch (list watches and watch show the slot ids). Cost: 1 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Keyword slot id (from a keyword watch)"
},
"to": {
"type": "string",
"description": "End date or datetime (ISO), default now."
},
"app": {
"type": "string",
"description": "Store app id; returns `rank` per point instead of the full id list."
},
"from": {
"type": "string",
"description": "Start, ISO date or datetime (default 90 days ago)"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
}
}
}
watch
Watch an app, a set of competitors or a set of keywords; significant changes become events (get events, webhooks, daily email). kind app {app}: new versions, metadata and price changes, featuring, rating drops, review and ratings spikes, chart entries. kind competitor set {competitors, app?}: the same for every competitor. kind keyword {terms, store or app}: the app's rank moves per term and new apps in the top N. Watched apps count against the plan's watch limit, keyword watches use one keyword slot per term × store × country; over a limit nothing changes (plan limit). With id, changes that w
Показать схему аргументов
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Watch id to change (from list_watches). Omit to create a watch",
"exclusiveMinimum": 0
},
"app": {
"type": "string",
"description": "Any app id, bundle id, package, store URL or name. kind app: the app (required); competitor_set: your own app (optional); keyword: the app whose ranks to report (optional)"
},
"kind": {
"enum": [
"app",
"keyword",
"competitor_set"
],
"type": "string",
"description": "'app' (one app), 'competitor_set' (several apps) or 'keyword' (search terms). Required when creating"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "A label for the watch"
},
"store": {
"enum": [
"apple",
"play",
"both"
],
"type": "string",
"description": "'apple', 'play' or 'both' (keyword watches without app; default both). Also disambiguates app inputs"
},
"terms": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"description": "kind keyword: search terms, e.g. ['habit tracker', 'streaks']"
},
"active": {
"type": "boolean",
"description": "false pauses the watch, true resumes it"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"settings": {
"type": "object",
"properties": {
"depth": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Keyword watches: results kept per ranking (Apple ≤ 250, Play ≤ 30)."
},
"rank_move": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"chart_top_n": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"rating_drop": {
"type": "number",
"description": "Stars over 7 days. Default: 0.1."
},
"email_digest": {
"type": "boolean",
"description": "Include in the daily email digest. Default: true."
},
"significance": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum significance for an event: Jev's probability that an analyst would want the alert (AI on), or a fixed per-type score. Default: 0.5."
},
"spike_factor": {
"type": "number"
},
"keyword_top_n": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"cadence_minutes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Keyword watches: minutes between re-ranks (360…10080)."
}
},
"description": "Thresholds: significance (0–1, default 0.5, minimum for an event), rank_move (default 5), keyword_top_n (10), chart_top_n (100), rating_drop (stars over 7 days, 0.1), spike_factor (3), email_digest (true), depth and cadence_minutes (keyword watches)"
},
"countries": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"maxItems": 50,
"minItems": 1,
"description": "Two-letter country codes to watch in (default ['us'])"
},
"competitors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "kind competitor_set: the apps to watch (any identifiers), up to 50"
},
"event_types": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"new_version",
"metadata_change",
"price_change",
"featured",
"in_app_event",
"installs_milestone",
"rating_drop",
"ratings_spike",
"review_spike",
"negative_review_spike",
"chart_enter",
"chart_leave",
"rank_change",
"keyword_entrant"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Only these event types (default: every type of the kind)"
}
}
}
unwatch
Stop watches by id (from list watches or watch): no new events, and their watched apps and keyword slots are freed. Past events are kept. To pause instead, call watch with id and active=false. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"minItems": 1,
"description": "Watch ids"
}
}
}
list_watches
Your watches (apps, competitor sets, keyword sets), newest first, with id, apps, terms, countries, event types and whether they are paused, plus watched apps and keyword slots used vs the plan's limits. Filter by kind or by an app they include. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only watches that include this app (any id, bundle id, package, URL or name)."
},
"kind": {
"enum": [
"app",
"keyword",
"competitor_set"
],
"type": "string",
"description": "Only this kind: 'app', 'competitor_set' or 'keyword'."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
}
}
}
get_events
Significant changes on your watched apps and keywords, newest first: type, one-line title, AI summary, significance (0–1), app, country and the key payload fields (version, changes old → new, rating drop, rank move, chart rank…). Filter by type, app, watch, since and min significance. To check for news, pass since = the created at of the newest event already handled. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only events of this app (any id, bundle id, package, URL or name)."
},
"type": {
"type": "string",
"description": "Comma list of event types, e.g. 'new_version,rating_drop'. Types: new_version, metadata_change, price_change, featured, in_app_event, installs_milestone, rating_drop, ratings_spike, review_spike, negative_review_spike, chart_enter, chart_leave, rank_change, keyword_entrant."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max items to return. Default: 50."
},
"since": {
"type": "string",
"description": "Only items at or after this ISO date / datetime. Example: 2026-10-01"
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"watch": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only events of this watch id."
},
"cursor": {
"type": "string",
"description": "`meta.next_cursor` from the previous page."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"min_significance": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Only events at least this significant (0–1)."
}
}
}
get_developer
A developer's profile: name, website, country, app count, total ratings and installs, all their apps (most-rated first) and the same company in the other store. get app shows the developer id as dev : . Cost: 1 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"dev"
],
"properties": {
"dev": {
"type": "string",
"description": "`apple:<artist id>`, `play:<developer id>`, a numeric Apple artist id, a Play developer id (often the name), or the website domain (`spotify.com`). Example: apple:324684583"
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
}
}
}
get_job
Poll a background store fetch that another call started (its output said refreshing or still being fetched, with a job id): status, per-country progress. When it is done, repeat the original call. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "`meta.freshness.job_id`, e.g. `fetch_123`."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
}
}
}
list_connections
The user's connected App Store Connect, Play Console and Apple Ads accounts: connection id, provider, mode (actions or read only), status and the linked apps. Start here before read connection or propose action; secrets are never returned. No connections yet: the user adds them at https://dash.appgoat.ai/connections. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"properties": {
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"provider": {
"enum": [
"asc",
"play_console",
"apple_ads"
],
"type": "string",
"description": "Only this provider: 'asc' (App Store Connect), 'play_console' or 'apple_ads'."
}
}
}
read_connection
Read live data from one of the user's connected accounts. what='reviews' (asc, play console): the app's own reviews with reply status, unanswered=true for those without a developer reply; their review id feeds propose action review.reply (Play only returns reviews from the last 7 days). what='listing' (asc, play console): the current listing text for one locale with lengths and which fields are editable right now (App Store name, subtitle, description, keywords and what's new need a version in Prepare for Submission). what='ads' (apple ads): view=campaigns → ad groups (campaign id) → keywords
Показать схему аргументов
{
"type": "object",
"required": [
"id",
"what"
],
"properties": {
"id": {
"type": "string",
"description": "Connection id (con_…) from list_connections"
},
"app": {
"type": "string",
"description": "A linked app (App Store id or package name); required for reviews, listing and ads view=suggestions"
},
"end": {
"type": "string",
"description": "ads report: end date YYYY-MM-DD (default yesterday, UTC)"
},
"view": {
"enum": [
"campaigns",
"ad_groups",
"keywords",
"negatives",
"report",
"suggestions",
"popularity"
],
"type": "string",
"description": "ads: 'campaigns' (default), 'ad_groups', 'keywords', 'negatives', 'report', 'suggestions' or 'popularity'"
},
"what": {
"enum": [
"reviews",
"listing",
"ads"
],
"type": "string",
"description": "'reviews', 'listing' or 'ads' (Apple Ads)"
},
"level": {
"enum": [
"campaigns",
"adgroups",
"keywords",
"searchterms"
],
"type": "string",
"description": "ads report: 'campaigns' (default), 'adgroups', 'keywords' or 'searchterms'"
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Max rows: reviews up to 200 (default 100), ads up to 1000 (default 200)"
},
"start": {
"type": "string",
"description": "ads report: start date YYYY-MM-DD (default 7 days before end)"
},
"terms": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "ads suggestions (seed terms) / popularity (required): up to 100 search terms, list or 'a,b'"
},
"cursor": {
"type": "string",
"description": "reviews: next_cursor from the previous page"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"locale": {
"type": "string",
"description": "listing: locale such as en-US, de-DE (default en-US)"
},
"rating": {
"type": "string",
"description": "reviews: star filter, '1', '1,2' or '1-3'"
},
"country": {
"type": "string",
"description": "reviews: App Store territory filter (two-letter code)"
},
"countries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "ads suggestions / popularity: two-letter country codes (popularity default us)"
},
"full_text": {
"type": "boolean",
"description": "Return long text (description, release notes, review bodies) in full instead of cut short"
},
"unanswered": {
"type": "boolean",
"description": "reviews: only reviews without a developer reply"
},
"ad_group_id": {
"type": "string",
"description": "ads: ad group id (needed for keywords; optional for negatives)"
},
"campaign_id": {
"type": "string",
"description": "ads: campaign id (needed for ad_groups, keywords, negatives and every report level except campaigns)"
},
"granularity": {
"enum": [
"DAILY",
"WEEKLY",
"MONTHLY"
],
"type": "string",
"description": "ads report: add a series per row (DAILY ≤ 90 days, WEEKLY ≥ 14 days, MONTHLY ≥ 90 days)"
}
}
}
propose_action
Prepare a change to the user's connected account as a DRY RUN: nothing is written. AppGoat reads the live account and returns the before → after diff, guardrail results (AI probabilities for store policy, tone and risky claims, plus checks such as character limits and bid jumps) and an action id. ALWAYS show the diff and any guardrail flags to the user and get their go-ahead before calling apply action. Types and params (app = a linked App Store id or package name, locale like en-US): review.reply {app, review id, text} (review ids from read connection what=reviews; Play replies ≤ 350 chars);
Показать схему аргументов
{
"type": "object",
"required": [
"type",
"params"
],
"properties": {
"type": {
"enum": [
"review.reply",
"listing.update",
"keywords.set",
"screenshots.upload",
"apple_ads.keyword.bid",
"apple_ads.keyword.add",
"apple_ads.negative.add",
"apple_ads.campaign.create",
"apple_ads.campaign.update",
"apple_ads.adgroup.create",
"apple_ads.adgroup.update"
],
"type": "string",
"description": "What to change: review.reply, listing.update, keywords.set, screenshots.upload, apple_ads.keyword.bid, apple_ads.keyword.add, apple_ads.negative.add, apple_ads.campaign.create, apple_ads.campaign.update, apple_ads.adgroup.create or apple_ads.adgroup.update"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"params": {
"type": "object",
"description": "Params for the type (see the tool description)",
"propertyNames": {
"type": "string"
},
"additionalProperties": []
},
"playbook": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "The playbook proposing this, e.g. 'reply-to-every-review' (shown to approvers); omit outside a playbook"
},
"connection": {
"type": "string",
"description": "Connection id from list_connections; optional when exactly one active connection fits the type and app"
}
}
}
apply_action
Go ahead with an action from propose action, after the user has seen its diff and agreed. Outcomes: applied (written to the store / Apple Ads account, 1 credit; when the org has an auto-apply rule the guardrail score clears, or allows agents to approve); pending approval (a person must approve it in the AppGoat dashboard: give the user the approve link, nothing is written until then); needs a person (it was already pending and agents may not approve: hand over the link, do not retry); changed (the account changed since the dry run: the new diff is shown; show it to the user and call again with
Показать схему аргументов
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Action id (act_…) from propose_action"
},
"force": {
"type": "boolean",
"description": "Apply the recomputed diff even though the account changed since the dry run. Only after the user has seen the new diff"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
}
}
}
get_action
One action from propose action: its status (draft, pending approval, approved, applied, failed, rejected), diff, guardrail scores, the provider result or error, the approve link and the audit trail. Use it to check whether a pending action was approved and applied. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Action id (act_…)"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
}
}
}
reject_action
Discard a draft or pending action the user does not want; nothing is written to the account. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Action id (act_…)"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"reason": {
"type": "string",
"description": "Why (shown in the audit log)"
}
}
}
audit_app
Run an App Audit of one app in one country: a 0–100 score, prioritised ASO actions with evidence, title / subtitle / keyword rewrites within the store character limits, and findings from listing, ratings, reviews, keywords and competitors, plus a shareable report page. Takes 1–3 minutes: waits about 25 s, then returns the audit id to pass to get audit. An audit of the same app, country and mode from the last 24 h is returned again for free unless fresh=true; failed audits are not charged. The first audit of an organization is free (free only=true runs only that one). Cost: 100 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"mode": {
"enum": [
"full",
"lite"
],
"type": "string",
"description": "lite = cached data, fewer reviews and keywords (cheaper and faster for us; same price). Default: full."
},
"fresh": {
"type": "boolean",
"description": "Run again even if a recent audit exists. Default: false."
},
"label": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
],
"description": "Your label for the audit list, e.g. the client or prospect name."
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "Two-letter country code, one storefront (default 'us')."
},
"free_only": {
"type": "boolean",
"description": "Only run when it is the free first audit (402 free_audit_used otherwise). Default: false."
},
"white_label": {
"type": "boolean",
"description": "Studio: the shareable report shows the organization's branding (set in the dashboard under Settings → Report branding) instead of AppGoat's, e.g. for client or prospect reports."
}
}
}
get_audit
Check on an App Audit that audit app started (by its id, e.g. aud 3fK9aQ2mXc81LpRt): waits up to about 25 s for it to finish, then returns the report (score, actions, metadata rewrites, findings, report page) or its status. Cost: 0 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Audit id from audit_app, e.g. aud_3fK9aQ2mXc81LpRt"
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
}
}
}
get_insights
What an app's users praise and complain about, from the AI tags on its reviews: top issues (topics behind negative, bug, crash, UX and pricing reviews) with last-30-days vs previous-30-days counts and sample reviews, topics, what each recent version changed in rating, sentiment and topics, and weekly sentiment. Use it for "what do users complain about since v2.3?" before reading individual reviews with get reviews. Cost: 25 credits.
Показать схему аргументов
{
"type": "object",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Any app identifier: App Store id (`284882215`, `id284882215`), Play package (`com.spotify.music`), Apple bundle id (`com.spotify.client`), store URL (URL-encoded), `apple:<id>` / `play:<id>`, or a name (`spotify`). Example: com.spotify.music"
},
"store": {
"enum": [
"apple",
"play"
],
"type": "string",
"description": "Disambiguates `{app}` (a bundle id vs a Play package, or a name)."
},
"format": {
"enum": [
"markdown",
"json"
],
"type": "string",
"description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
},
"country": {
"type": "string",
"description": "One storefront; omit for every storefront we hold reviews for."
},
"versions": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "How many of the latest versions to break down. Default: 6."
},
"since_days": {
"type": "integer",
"maximum": 730,
"minimum": 7,
"description": "How many days of reviews to analyse, 7–730 (default 180)."
}
}
}
list_playbooks
AppGoat playbooks: step-by-step recipes (which tools to call, credit budget, decision rules, output format) for app audits, app idea research, ASO metadata rewrites, weekly competitor digests, turning reviews into GitHub issues, and, on connected accounts, replying to every review, launching and optimizing Apple Ads and pushing localized listings. Without name, lists them; with name, returns the full playbook to follow. Also offered as MCP prompts. Free.
Показать схему аргументов
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "A playbook name from the list, e.g. 'app-audit-lite'"
}
}
}