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

# How to Use Aptoide app search in dots

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, with a Spiral API key |

## Prompts to try with Aptoide app search in dots

- Every Monday, use Aptoide app search for VLC and report package names that were absent from the previous check.
- Every Monday at 9am: 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.
- Pull the newest data from Aptoide app search and give me the result as a table.

## How to set up Aptoide app search in dots

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

### Use the Spiral skill

1. **Send dots 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 your dot. Copy it.

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

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

3. **Give your dot the key**: When your dot asks for the key, add it where your dot 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 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: dots finds Aptoide app search on Spiral, shows the price and runs it.

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

## 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 dots?

Get a recurring brief on changes to Android app listings and available builds on Aptoide. A scheduled agent can compare repeated observations to flag newly seen packages, versions, or listing changes.

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

## 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)
- [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](https://spiral.ai/integrations/grok/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 dots guides

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

## Questions about Aptoide app search in dots

**Can dots use Aptoide app search?**

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

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

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

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

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

**How long does it take to set up Aptoide app search in dots?**

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

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

Aptoide app search runs in the background. dots 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.

