Servers Playground How we check Add a server Log in

AppGoat

Working · 1.5 s

ai.appgoat/mcpv0.2.0 Domain verified

App Store and Google Play data: apps, reviews, keywords, charts, competitors, ASO playbooks.

Marketing & SEO

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.appgoat.ai/mcp

X-API-Key (optional)

Optional AppGoat API key from dash.appgoat.ai; omit to sign in with OAuth

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

apply_action Destructive

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 force=true only if they accept it, or propose_action again). Cost: 1 credit when applied, else 0 credits.

idstring, required

Action id (act_…) from propose_action

forceboolean

Apply the recomputed diff even though the account changed since the dry run. Only after the user has seen the new diff

formatstring

'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

AppGoat MCP server | mcptry

AppGoat

Working · 1.5 s

ai.appgoat/mcpv0.2.0 Domain verified

App Store and Google Play data: apps, reviews, keywords, charts, competitors, ASO playbooks.

Marketing & SEO

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.appgoat.ai/mcp

X-API-Key (optional)

Optional AppGoat API key from dash.appgoat.ai; omit to sign in with OAuth

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

apply_action Destructive

idstring, required

Action id (act_…) from propose_action

forceboolean

Apply the recomputed diff even though the account changed since the dry run. Only after the user has seen the new diff

formatstring

'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (29)

apply_action

destructive

Argument	Type	Description
id*	string	Action id (act_…) from propose_action
force	boolean	Apply the recomputed diff even though the account changed since the dry run. Only after the user has seen the new diff
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

Input schema (JSON)

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

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.

Argument	Type	Description
app*	string	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	string	lite = cached data, fewer reviews and keywords (cheaper and faster for us; same price). Default: full.
fresh	boolean	Run again even if a recent audit exists. Default: false.
label	any	Your label for the audit list, e.g. the client or prospect name.
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
format	string	'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.

read-only

Argument	Type	Description
id*	string	Action id (act_…)
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

Input schema (JSON)

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

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.

read-only

Argument	Type	Description
app*	string	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	boolean	Block up to ~25 s for a refresh (default). false = answer immediately from cache with a job id.
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	ISO country code(s): `us` (default), a comma list (paid plans), or `all` (Studio). Example: us,de
include	array	Extra sections: markets (every storefront), iap, versions (history with release notes), privacy (App Store labels), estimates (modelled downloads/revenue), charts (current top-chart positions)

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.

read-only

Argument	Type	Description
app*	string	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	string	Only these fields (comma list), e.g. `version,title,subtitle`.
limit	integer	Max items to return. Default: 50.
since	string	Only items at or after this ISO date / datetime. Example: 2026-10-01
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
cursor	string	`meta.next_cursor` from the previous page.
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

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.

read-only

Argument	Type	Description
to	string	End date (ISO), default today.
app*	string	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	string	Start date (ISO), default 90 days before `to`.
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	ISO country code(s): `us` (default), a comma list (paid plans), or `all` (Studio). Example: us,de

Input schema (JSON)

{
  "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_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.

read-only

Argument	Type	Description
app*	string	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	integer	Max items to return. Default: 100.
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
cursor	string	`meta.next_cursor` from the previous page.
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	Two-letter country code (default 'us').
max_rank	integer	Only terms where the app ranks at or above this position.

Input schema (JSON)

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.

read-only

Argument	Type	Description
id*	string	Audit id from audit_app, e.g. aud_3fK9aQ2mXc81LpRt
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

Input schema (JSON)

{
  "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_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.

read-only

Argument	Type	Description
date	string	The chart as of this date (ISO). Default the latest capture.
chart	string	'free' (default), 'paid' or 'grossing'.
limit	integer	How many ranks to return (default 100, max 200).
store	string	'apple' (default) or 'play'.
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	Two-letter country code (default 'us').
category	string	App Store genre id (`36` or `all` = all apps, `6014` = games, …) or Play category (`GAME_PUZZLE`; `APPLICATION` = all apps).

Input schema (JSON)

{
  "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)."
    }
  }
}

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.

read-only

Argument	Type	Description
app*	string	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	integer	Max items to return. Default: 20.
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	Two-letter country code (default 'us').

Input schema (JSON)

{
  "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')."
    }
  }
}

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 <store>:<id>. Cost: 1 credits.

read-only

Argument	Type	Description
dev*	string	`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	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

Input schema (JSON)

{
  "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_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.

read-only

Argument	Type	Description
app	string	Only events of this app (any id, bundle id, package, URL or name).
type	string	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	integer	Max items to return. Default: 50.
since	string	Only items at or after this ISO date / datetime. Example: 2026-10-01
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
watch	integer	Only events of this watch id.
cursor	string	`meta.next_cursor` from the previous page.

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.

read-only

Argument	Type	Description
app*	string	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	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	One storefront; omit for every storefront we hold reviews for.
versions	integer	How many of the latest versions to break down. Default: 6.
since_days	integer	How many days of reviews to analyse, 7–730 (default 180).

Input schema (JSON)

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.

read-only

Argument	Type	Description
id*	string	`meta.freshness.job_id`, e.g. `fetch_123`.
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

Input schema (JSON)

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

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) or a list_tracked_keywords id. Cost: 1 credits.

read-only

Argument	Type	Description
id*	integer	Keyword slot id (from a keyword watch, or list_tracked_keywords)
to	string	End date or datetime (ISO), default now.
app	string	Store app id; returns `rank` per point instead of the full id list.
from	string	Start, ISO date or datetime (default 90 days ago)
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Keyword slot id (from a keyword watch, or list_tracked_keywords)"
    },
    "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 }"
    }
  }
}

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.

read-only

Argument	Type	Description
q	string	Case-insensitive text search in the title and body. Example: crash
app*	string	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	integer	Max items to return. Default: 50.
since	string	Only items at or after this ISO date / datetime. Example: 2026-10-01
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
topic	string	AI topic filter (comma list of topic labels, case-insensitive, or topic ids).
until	string	Only reviews created before this ISO date / datetime.

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. Cost: 1 per keyword; 5 per seed with include=related or suggestions credits.

read-only

Argument	Type	Description
app	string	Any app identifier (as in `{app}`); adds `app.rank` and `app.relevance` per term.
wait	boolean	Block up to ~25 s for a refresh (default). false = answer immediately from cache with a job id.
store	string	Required unless `app` is given.
terms*	array	Search terms, 1–25 (at most 5 with include related or suggestions)
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	Two-letter ISO country code (storefront), e.g. us, gb, de. Default: us.
include	array

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.

read-only

Argument	Type	Description
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
provider	string	Only this provider: 'asc' (App Store Connect), 'play_console' or 'apple_ads'.

Input schema (JSON)

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

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, 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.

read-only

Argument	Type	Description
name	string	A playbook name from the list, e.g. 'app-audit-lite'

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "A playbook name from the list, e.g. 'app-audit-lite'"
    }
  }
}

list_tracked_keywords

Deprecated: use list_watches (keyword watches list their slots). Your tracked keywords with id, store, country, popularity, depth, cadence, last ranking and current top 3. Filter by store, country or a term substring. Cost: 0 credits.

read-only

Argument	Type	Description
q	string	Only terms containing this text.
store	string	'apple' = Apple App Store (iOS), 'play' = Google Play (Android).
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
country	string	Only this two-letter country code.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Only terms containing this text."
    },
    "store": {
      "enum": [
        "apple",
        "play"
      ],
      "type": "string",
      "description": "'apple' = Apple App Store (iOS), 'play' = Google Play (Android)."
    },
    "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 this two-letter country code."
    }
  }
}

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.

read-only

Argument	Type	Description
app	string	Only watches that include this app (any id, bundle id, package, URL or name).
kind	string	Only this kind: 'app', 'competitor_set' or 'keyword'.
store	string	Disambiguates `{app}` (a bundle id vs a Play package, or a name).
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }

Input schema (JSON)

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

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); listing.update {app, locale, fields: {name|title, subtitle, description, promotional_text, whats_new, marketing_url, support_url, privacy_policy_url}} (Play: title, short_description, full_description, video); keywords.set {app, locale, keywords: [..] or 'a,b,c', mode?: replace|add|remove} (App Store, 100 bytes comma-joined); screenshots.upload {app, locale, display_type: APP_IPHONE_67… (asc) or image_type: phoneScreenshots… (play), images: [{url}], replace?}; ads.keyword.bid {campaign_id, ad_group_id, keywords: [{id, bid?, status?: ENABLED|PAUSED}], max_increase?}; ads.keyword.add {campaign_id, ad_group_id, keywords: [{text, match_type?: EXACT|BROAD, bid?}]}; ads.negative.add {campaign_id, ad_group_id?, keywords: [{text, match_type?}]} (Apple Ads ids from read_connection what=ads). Cost: 0 credits.

Argument	Type	Description
type*	string	What to change: review.reply, listing.update, keywords.set, screenshots.upload, ads.keyword.bid, ads.keyword.add or ads.negative.add
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
params*	object	Params for the type (see the tool description)
playbook

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 (campaign_id, ad_group_id) gives the ids the ads.* actions take, view=negatives lists negative keywords, view=report with level=campaigns|adgroups|keywords|searchterms returns impressions, taps, installs, spend, CPT and CPA for start..end (default the last 7 days). Cost: 1 credits.

read-only

Argument	Type	Description
id*	string	Connection id (con_…) from list_connections
app	string	A linked app (App Store id or package name); required for reviews and listing
end	string	ads report: end date YYYY-MM-DD (default yesterday, UTC)
view	string	ads: 'campaigns' (default), 'ad_groups', 'keywords', 'negatives' or 'report'
what*	string	'reviews', 'listing' or 'ads' (Apple Ads)
level

reject_action

Discard a draft or pending action the user does not want; nothing is written to the account. Cost: 0 credits.

Argument	Type	Description
id*	string	Action id (act_…)
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
reason	string	Why (shown in the audit log)

Input schema (JSON)

{
  "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)"
    }
  }
}

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.

read-only

Argument	Type	Description
q*	string	App name (≥ 2 characters) or exact id. Example: photo editor
limit	integer	Max items to return. Default: 20.
store	string	Limit to one store: 'apple' or 'play'. Omit for both.
cursor	string	`meta.next_cursor` from the previous page.
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
category	string	Store category name, e.g. `Photo & Video` (App Store) or `PHOTOGRAPHY` (Play).

Input schema (JSON)

{
  "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)."
    }
  }
}

track_keywords

Deprecated: use watch with kind keyword (also reports rank moves as events). Starts tracking the search ranking of terms in one or both stores and the given countries: ranked apps are captured daily from now on (idempotent; already tracked terms are reported as such). Each term × store × country uses one keyword slot of the plan; a request over the limit tracks nothing (plan_limit). Read history with get_keyword_ranks. Cost: 0 credits.

Argument	Type	Description
tags	array	Free-form labels.
depth	integer	How many results to keep per ranking (default 100 Apple / 50 Play).
store*	string	'apple', 'play' or 'both' (tracks each term in each store)
terms*	array	Search terms to track, e.g. ['habit tracker', 'streaks']
format	string	'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }
countries	array	Two-letter country codes to track in (default ['us'])

Input schema (JSON)

{
  "type": "object",
  "required": [
    "terms",
    "store"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Free-form labels."
    },
    "depth": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "How many results to keep per ranking (default 100 Apple / 50 Play)."
    },
    "store": {
      "enum": [
        "apple",
        "play",
        "both"
      ],
      "type": "string",
      "description": "'apple', 'play' or 'both' (tracks each term in each store)"
    },
    "terms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 500,
      "minItems": 1,
      "description": "Search terms to track, e.g. ['habit tracker', 'streaks']"
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "'markdown' (default): compact tables for reading. 'json': the API's raw { data, meta }"
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z]{2}$"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Two-letter country codes to track in (default ['us'])"
    }
  }
}

untrack_keywords

Deprecated: use unwatch for keyword watches. Stops tracking keywords by id (from list_tracked_keywords or track_keywords): no new rankings are recorded and their plan slots are freed. Cost: 0 credits.

destructive

Argument	Type	Description
ids*	array	Tracked keyword ids

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Tracked keyword ids"
    }
  }
}

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.

destructive

Argument	Type	Description
ids*	array	Watch ids

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Watch ids"
    }
  }
}

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 watch instead (send only what changes; settings are merged; active=false pauses it). Cost: 0 credits.

Argument	Type	Description
id	integer	Watch id to change (from list_watches). Omit to create a watch
app	string	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	string	'app' (one app), 'competitor_set' (several apps) or 'keyword' (search terms). Required when creating
name	any	A label for the watch
store	string	'apple', 'play' or 'both' (keyword watches without app; default both). Also disambiguates app inputs
terms	array	kind keyword: search terms, e.g. ['habit tracker', 'streaks']
active

Input schema (JSON)

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

{
  "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."
    }
  }
}

{
  "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)."
    }
  }
}

Input schema (JSON)

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

Input schema (JSON)

{
  "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 and listing"
    },
    "end": {
      "type": "string",
      "description": "ads report: end date YYYY-MM-DD (default yesterday, UTC)"
    },
    "view": {
      "enum": [
        "campaigns",
        "ad_groups",
        "keywords",
        "negatives",
        "report"
      ],
      "type": "string",
      "description": "ads: 'campaigns' (default), 'ad_groups', 'keywords', 'negatives' or 'report'"
    },
    "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)"
    },
    "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)"
    },
    "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)"
    }
  }
}

Input schema (JSON)

{
  "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)"
    }
  }
}