[Integrations](https://spiral.ai/integrations) › [Factory Droid](https://spiral.ai/integrations/factory-droid) › [Google Play app search](https://spiral.ai/integrations/factory-droid/google-play-app-search)

# How to Use Google Play app search in Factory Droid

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, no API key |

## Prompts to try with Google Play app search in Factory Droid

- Use Google Play app search for 'language learning' and create a candidate list for this project's Android app comparison.
- Use Google Play app search to look this up and give me the result as a table. Save the result in ./assets.
- 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 Factory Droid

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

### Use Spiral's MCP server

1. **Add the server**: Droid saves it to your user config, `~/.factory/mcp.json`, so it works in every project.

```bash
droid mcp add spiral https://api.spiral.ai/mcp --type http
```

2. **Sign in**: Start `droid`, type `/mcp`, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

3. **Check it**: Spiral shows as connected. needs authentication means the sign-in did not finish: run `/mcp` again.

```bash
droid mcp list
```

### Use the Spiral skill

1. **Send Factory Droid 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 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: Factory Droid finds Google Play app search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/factory-droid

## 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 Factory Droid?

Build a Google Play research view in your project using public app and media records. Turn returned listings, catalogs, or reviews into comparisons that link back to the source.

### 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 Factory Droid guides](https://spiral.ai/integrations/factory-droid)

## 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)
- [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)
- [Instinct](https://spiral.ai/integrations/instinct/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 Factory Droid guides

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

## Questions about Google Play app search in Factory Droid

**Can Factory Droid use Google Play app search?**

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

**How much does Google Play app search cost in Factory Droid?**

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

**Do I need an Alexandria account to use Google Play app search in Factory Droid?**

No. Spiral runs Google Play app search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Google Play app search in Factory Droid?**

About two minutes: add the server, then sign in, then check it.

**Does Factory Droid wait while Google Play app search runs?**

Google Play app search runs in the background. Factory Droid 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.

