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

# How to Use Google Play app search in Instinct

Returns Android apps matching a text query. Use it to find candidate apps before examining a particular store listing or its reviews.

|  |  |
| --- | --- |
| Model | Google Play app search |
| 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 app search in Instinct

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

## How to set up Google Play app search 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 app search**: 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_search",
    "input": {
      "query": "<query>"
    }
  }'
```

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

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

## Google Play app search tools and prices

- [Google Play apps, Books and Movies & TV · App search](https://spiral.ai/tools/alexandria/play-google-com/media/app_search) (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 app search 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 app search in other agents

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

## More Instinct guides

- [Google Play app reviews](https://spiral.ai/integrations/instinct/google-play-app-reviews)
- [Google Play audiobook details](https://spiral.ai/integrations/instinct/google-play-audiobook-details)
- [Google Play app details](https://spiral.ai/integrations/instinct/google-play-app-details)
- [Google Play author books](https://spiral.ai/integrations/instinct/google-play-author-books)
- [Google Play TV show details](https://spiral.ai/integrations/instinct/google-play-tv-show-details)
- [Google Play book series](https://spiral.ai/integrations/instinct/google-play-book-series)

## Questions about Google Play app search in Instinct

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

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

**How much does Google Play app search 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 app search in Instinct?**

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

**How long does it take to set up Google Play app search 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 app search runs?**

Google Play app search 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.

