> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Store listings & reviews with gps

> Read and update localized Google Play store listings and images, and read and reply to Play Store reviews.

## Store listings

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gps --package com.example.app listings list --json
gps --package com.example.app listings get en-US
```

Update one locale:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gps --package com.example.app listings update en-US \
  --title "My App" \
  --short-description "Short pitch under 80 chars" \
  --full-description "Longer description..." \
  --confirm
```

| Flag | Field |
| - | - |
| `--title <title>` | App name |
| `--short-description <text>` | Short description |
| `--full-description <text>` | Full description |
| `--video <url>` | Promo video URL |
| `--validate-only` | Validate without committing |

### Images

Image list, delete, and upload run through the operation registry. Image types follow the Publisher API (`icon`, `featureGraphic`, `phoneScreenshots`, …).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gps call gps_list_images '{
  "packageName": "com.example.app",
  "language": "en-US",
  "imageType": "phoneScreenshots"
}'
```

| Operation | What it does | Hosted |
| - | - | - |
| `gps_list_listings`, `gps_get_listing` | Read localized listings | Yes |
| `gps_update_listing` | Update title, descriptions, video | Yes (write) |
| `gps_delete_listing`, `gps_delete_all_listings` | Remove one or all locales | Yes (write) |
| `gps_list_images` | Images for a language and image type | Yes |
| `gps_delete_image`, `gps_delete_all_images` | Remove images | Yes (write) |
| `gps_upload_image` | Upload a local image file | CLI only |
| `gps_get_app_details`, `gps_patch_app_details` | App details from an edit | Yes |

## Reviews

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gps --package com.example.app reviews list --json
gps --package com.example.app reviews list --max-results 20 --translation-language en
gps --package com.example.app reviews get REVIEW_ID
```

| Flag | Description |
| - | - |
| `--max-results <n>` | Page size |
| `--token <token>` | Pagination token from the previous page |
| `--translation-language <lang>` | Translate review text into this language |

Reply:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gps --package com.example.app reviews reply REVIEW_ID "Thanks for the feedback!" --confirm
```

> [!NOTE]
>
> For review history, rating trends, and Android vitals in a dashboard, see [Reviews & Vitals](/docs/google-play-reviews-vitals.md) in Appeeky.

### Over MCP

| Tool | Arguments |
| - | - |
| `gps_list_reviews` | `packageName`, `maxResults`, `token`, `translationLanguage` |
| `gps_get_review` | `packageName`, `reviewId`, `translationLanguage` |
| `gps_reply_to_review` | `packageName`, `reviewId`, `replyText` (write) |

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "name": "gps_reply_to_review",
  "arguments": {
    "packageName": "com.example.app",
    "reviewId": "REVIEW_ID",
    "replyText": "Thanks for the feedback!"
  }
}
```

> [!TIP]
>
> Let the agent draft replies, then approve each one before it calls `gps_reply_to_review`. On the hosted server this tool only appears with `X-GPS-Allow-Writes: true`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.