How to Use Aptoide app search in Codex
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.
Prompts to try with Aptoide app search in Codex
Copy an example into Codex, or ask in your own words.
Use Aptoide app search to find VLC listings and add a package-selection table to this project's research screen.
Use Aptoide app search to look this up and give me the result as a table. Save the result in ./assets.
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 Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Aptoide app search
One request; the result comes back by polling or a webhook.
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: Codex finds Aptoide app search on Spiral, shows the price and runs it.
Aptoide app search providers and prices
Spiral runs Aptoide app search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Limit | 1 to 50 | 10 | limit |
| Offset | 0 to 1000 | 0 | offset |
Every API field of Aptoide · Search is on its tool page: open its card above.
What can you do with Aptoide app search in Codex?
Build an Android app review table in your project using Aptoide package, listing, and release data. A coding agent can turn retrieved records into comparison views and reports tied to specific packages.
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.
More on Aptoide app search and Codex
Overview
Aptoide app search in other agents
Questions about Aptoide app search in Codex
Can Codex use Aptoide app search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Aptoide app search like any built-in tool.
How much does Aptoide app search cost in Codex?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need an Alexandria account to use Aptoide app search in Codex?
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 Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Aptoide app search runs?
Aptoide app search runs in the background. Codex 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.
Start using Aptoide app search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


