[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [Google Play search suggestions](https://spiral.ai/integrations/instinct/google-play-search-suggestions)

# How to Use Google Play search suggestions in Instinct

Returns Google's suggested app searches for partial text. Use it to collect query ideas before searching for matching Android apps.

|  |  |
| --- | --- |
| Model | Google Play search suggestions |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Google Play search suggestions in Instinct

- Every Friday, use Google Play search suggestions for 'language' and report suggestions that appeared or disappeared since last week.
- Every Monday at 9am: use Google Play search suggestions to look this up and give me the result as a table.
- Pull the latest numbers from Google Play search suggestions and tell me what changed since last week.
- Check Google Play search suggestions and summarize what you find in three bullet points.
- Pull the newest data from Google Play search suggestions and give me the result as a table.

## How to set up Google Play search suggestions in Instinct

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Instinct this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Google Play search suggestions**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "play-google-com/media/app_suggest",
    "input": {
      "prefix": "<prefix>"
    }
  }'
```

Then paste one of the prompts above: Instinct finds Google Play search suggestions on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/instinct

## Google Play search suggestions tools and prices

- [Google Play apps, Books and Movies & TV · App suggest](https://spiral.ai/tools/alexandria/play-google-com/media/app_suggest) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| country |  | — | Storefront country (`gl`), ISO 3166-1 alpha-2. Default US. Selects availability, prices and which reviews the store shows. Pattern: ^[A-Za-z]{2}$. |
| language |  | — | UI language (`hl`), e.g. en_US, en, de. Default en_US. Selects the language of titles, descriptions and labels; app reviews come back in the storefront language only. Pattern: ^[A-Za-z]{2}([_-][A-Za-z]{2,4})?$. |

## What can you do with Google Play search suggestions in Instinct?

Produce a recurring Google Play research brief showing changes in the public records you follow. Compare each run with earlier observations to identify listing changes, catalog additions, or shifts in review themes.

### Compare competing Android apps

Build a comparison of language-learning apps: collect suggested searches, find candidates, inspect their listings and developer portfolios, and summarize recurring review complaints.

### Plan app store content

Use search suggestions and matching listings to develop an app comparison article. Check publisher catalogs and public reviews to support each recommendation with specific evidence.

### Monitor an Android category

Repeat selected searches and publisher checks each week, then compare app listings and review themes with earlier observations. Include changes in suggested searches in the research brief.

### Research a product opportunity

Start with app search suggestions, inspect existing products and their publishers, and read complaints about missing features. Turn the findings into a list of product questions to investigate.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Instinct guides](https://spiral.ai/integrations/instinct)

## Google Play search suggestions in other agents

- [Amp](https://spiral.ai/integrations/amp/google-play-search-suggestions)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/google-play-search-suggestions)
- [Claude](https://spiral.ai/integrations/claude-desktop/google-play-search-suggestions)
- [Claude Code](https://spiral.ai/integrations/claude-code/google-play-search-suggestions)
- [Cline](https://spiral.ai/integrations/cline/google-play-search-suggestions)
- [Codex](https://spiral.ai/integrations/codex/google-play-search-suggestions)
- [Cursor](https://spiral.ai/integrations/cursor/google-play-search-suggestions)
- [Devin](https://spiral.ai/integrations/devin/google-play-search-suggestions)
- [dots](https://spiral.ai/integrations/dots/google-play-search-suggestions)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/google-play-search-suggestions)
- [Gemini](https://spiral.ai/integrations/gemini/google-play-search-suggestions)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/google-play-search-suggestions)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/google-play-search-suggestions)
- [goose](https://spiral.ai/integrations/goose/google-play-search-suggestions)
- [Grok](https://spiral.ai/integrations/grok/google-play-search-suggestions)
- [Grok Build](https://spiral.ai/integrations/grok-build/google-play-search-suggestions)
- [Hermes](https://spiral.ai/integrations/hermes/google-play-search-suggestions)
- [Manus](https://spiral.ai/integrations/manus/google-play-search-suggestions)
- [Muse](https://spiral.ai/integrations/muse/google-play-search-suggestions)
- [Muse Code](https://spiral.ai/integrations/muse-code/google-play-search-suggestions)
- [n8n](https://spiral.ai/integrations/n8n/google-play-search-suggestions)
- [Notion](https://spiral.ai/integrations/notion/google-play-search-suggestions)
- [OpenClaw](https://spiral.ai/integrations/openclaw/google-play-search-suggestions)
- [opencode](https://spiral.ai/integrations/opencode/google-play-search-suggestions)
- [Perplexity](https://spiral.ai/integrations/perplexity/google-play-search-suggestions)
- [Raycast](https://spiral.ai/integrations/raycast/google-play-search-suggestions)
- [VS Code](https://spiral.ai/integrations/vscode/google-play-search-suggestions)
- [Windsurf](https://spiral.ai/integrations/windsurf/google-play-search-suggestions)
- [Zapier](https://spiral.ai/integrations/zapier/google-play-search-suggestions)

## More Instinct guides

- [Google Play movie details](https://spiral.ai/integrations/instinct/google-play-movie-details)
- [Hertz Car Sales inventory filters](https://spiral.ai/integrations/instinct/hertz-car-sales-inventory-filters)
- [Google Play media search](https://spiral.ai/integrations/instinct/google-play-media-search)
- [Hertz Car Sales inventory search](https://spiral.ai/integrations/instinct/hertz-car-sales-inventory-search)
- [Google Play media reviews](https://spiral.ai/integrations/instinct/google-play-media-reviews)
- [Hertz Car Sales vehicle availability](https://spiral.ai/integrations/instinct/hertz-car-sales-vehicle-availability)

## Questions about Google Play search suggestions in Instinct

**Can Instinct use Google Play search suggestions?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run Google Play search suggestions like any built-in tool.

**How much does Google Play search suggestions cost in Instinct?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Instinct plan is separate.

**Do I need an Alexandria account to use Google Play search suggestions in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs Google Play search suggestions on its own Alexandria account.

**How long does it take to set up Google Play search suggestions in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while Google Play search suggestions runs?**

Google Play search suggestions runs in the background. Instinct starts the run, checks on it and gives you the json when it's ready.

**Where does the Google Play data come from?**

The provider reads logged-out Google Play store pages and the store's batchexecute RPC. Book identity checks also use Google Books volume records.

**How quickly do new app reviews become public?**

Google generally holds new app ratings and reviews for around 24 hours before publishing them. A public store lookup therefore cannot show every review immediately after submission.

**Does a Google Play app rating represent its lifetime average?**

The displayed rating is weighted toward more recent ratings. That makes it different from a simple average of every rating received since launch.

**Are ebook and audiobook ratings interchangeable?**

Google Play maintains separate ebook and audiobook listings with their own ratings. Its ebook pages can link to the corresponding audiobook, so compare the actual editions rather than combining their scores.

**Is an ISBN the same as a Google Books volume ID?**

Google Books assigns a separate unique string to each volume it knows about. Use the ISBN lookup to identify the volume before researching that book's store record.

