[Integrations](https://spiral.ai/integrations) › [Grok](https://spiral.ai/integrations/grok) › [Aptoide app search](https://spiral.ai/integrations/grok/aptoide-app-search)

# How to Use Aptoide app search in Grok

Find matching Android app packages in Aptoide's catalog. Use it to discover candidates by name or keyword before inspecting an individual app or its available builds.

|  |  |
| --- | --- |
| Model | Aptoide 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 Aptoide app search in Grok

- Use Aptoide app search to find five apps matching VLC and show their names and Android package names.
- Use Aptoide app search to find ten video player apps and compare the downloads and ratings returned for them.
- Use Aptoide app search to look this up and give me the result as a table.
- Pull the latest numbers from Aptoide app search and tell me what changed since last week.
- Check Aptoide app search and summarize what you find in three bullet points.

## How to set up Aptoide app search in Grok

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

### Use the Grok connector

1. **Add a custom connector**: In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

```text
https://api.spiral.ai/mcp
```

2. **Sign in to Spiral and approve**: Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

3. **Check that it is connected**: Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

### Use the Spiral skill

1. **Send Grok 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 Aptoide 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": "aptoide-com/apps/search",
    "input": {
      "query": "<query>"
    }
  }'
```

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

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

## Aptoide app search tools and prices

- [Aptoide · Search](https://spiral.ai/tools/alexandria/aptoide-com/apps/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 50 | 10 | limit |
| offset | 0 to 1000 | 0 | offset |

## What can you do with Aptoide app search in Grok?

Create a shortlist of Android apps to evaluate with Aptoide's public catalog data. A chat agent can explain matching packages, listing metrics, and available releases in a comparison you can read without inspecting raw records.

### Build a competitor research brief

Find competing Android apps by keyword, inspect their current listings, and compare the builds Aptoide holds. Use the results to choose which products deserve hands-on testing.

### Prepare a regression test queue

Find VLC or another target app, inspect its current package, and select available versions for regression testing. Keep the package identity and version code attached to each test candidate.

### Investigate an app update

Resolve an app name to matching packages, inspect the current listing, and compare available APK uploads. Produce a brief showing which package and build need further investigation.

### Review an Android app shortlist

Discover apps for a task such as video playback, compare listing ratings and downloads, and review available release history before choosing candidates for evaluation.

### Triage declared permissions

Find apps matching a product category and inspect each selected package's declared permissions. Prepare specific questions for a manual privacy or security review.

## Overview

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

## Aptoide app search in other agents

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

## More Grok guides

- [Aptoide app details](https://spiral.ai/integrations/grok/aptoide-app-details)
- [Aptoide app version history](https://spiral.ai/integrations/grok/aptoide-app-version-history)
- [Apple App Store top charts](https://spiral.ai/integrations/grok/apple-app-store-top-charts)
- [Arditi Collection categories](https://spiral.ai/integrations/grok/arditi-collection-categories)
- [Apple App Store developer apps](https://spiral.ai/integrations/grok/apple-app-store-developer-apps)
- [Arditi Collection category products](https://spiral.ai/integrations/grok/arditi-collection-category-products)

## Questions about Aptoide app search in Grok

**Can Grok use Aptoide app search?**

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

**How much does Aptoide app search cost in Grok?**

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

**Do I need an Alexandria account to use Aptoide app search in Grok?**

No. Spiral runs Aptoide 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 Aptoide app search in Grok?**

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

**Does Grok wait while Aptoide app search runs?**

Aptoide app search runs in the background. Grok starts the run, checks on it and gives you the json when it's ready.

**What kinds of apps does Aptoide cover?**

The catalog covers Android apps and games, including entertainment, productivity, utilities, and gaming. These endpoints research that Android catalog.

**What happens before an update appears on Aptoide?**

App updates go through automated security checks before Aptoide makes them available. A newly announced release can therefore still be outside the available catalog while that process runs.

**What does an Unknown security badge mean?**

Aptoide says Unknown can indicate that additional analysis is still in progress. It should not be read as a completed security review.

**Is Aptoide a permanent archive of downloadable releases?**

Aptoide Connect documents an Archived status in which a version is no longer available for download. Available version history should therefore not be treated as a permanent download archive.

**Does finding an app establish availability in every country?**

No. Aptoide documents geographic restrictions in its app details API based on the request's origin, so one listing does not establish worldwide availability.

