ASO Skill

App Store research for your favourite AI agent.

Give Claude Code, Codex, ChatGPT, Claude, or another compatible agent current App Store search results, difficulty, popularity, and app metadata.

$npx skills add aso-skill/aso-skill
Install the skillConnect with MCP
CodexExample conversation

Find me popular App Store keywords that are relatively easy to rank for in the workout planning niche in the US using ASO Skill.

Worked for 6m 8s

The strongest opportunity is “workout tracker”: high popularity with lower difficulty than the obvious head terms.

Best demand and competition balance
KeywordPopularityDifficulty
workout tracker5924
gym tracker4531
gym workout4636

Avoid prioritizing “fitness”: its higher popularity comes with substantially higher difficulty.

A small interface to useful App Store data.

Skill, MCP, or CLI

Install the skill, connect the hosted MCP server, or use the CLI.

No pasted secrets

Browser approval, OAuth, and system credential stores keep API keys out of conversations.

One credit per data call

New accounts receive 20 promotional credits. Balance checks and authentication are free.

Choose how to connect.

Install a skill, connect over MCP, use the CLI, or call the HTTP API.

Agent SkillOne-command instructions for Claude Code, Codex, and compatible agents.ChatGPTConnect the hosted MCP tools with secure account authorization.ClaudeAdd ASO Skill as a remote connector in Claude and Claude Desktop.CLIRun browser-assisted login and ASO research from any supported terminal.MCP serverConnect any compatible remote MCP client to the production endpoint.HTTP APIBuild your own ASO tool with typed JSON endpoints and the OpenAPI contract.

Call the HTTP API directly.

For complete request, response, authentication, and error schemas, read the public OpenAPI specification.

POST/v1/search

Search the App Store and calculate keyword difficulty.

Dark-mode iPhone App Store search results for workout tracker
App Store results for “workout tracker”, captured below the first result.
curl https://api.asoskill.com/v1/search \
  -H "Authorization: Bearer $ASO_SKILL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"term":"workout tracker","storefront":"US","platform":"iphone"}'
{
  "term": "workout tracker",
  "storefront": "US",
  "platform": "iphone",
  "difficulty": 64,
  "resultCount": 50,
  "results": [
    {
      "position": 1,
      "appId": "464254577",
      "name": "Strong Workout Tracker Gym Log"
    },
    {
      "position": 2,
      "appId": "1458862350",
      "name": "Hevy - Gym Tracker Workout Log"
    },
    {
      "position": 3,
      "appId": "1438388363",
      "name": "Habit Tracker"
    }
  ],
  "cache": "hit",
  "fetchedAt": "2026-08-21T08:45:00.000Z",
  "requestId": "CTK0Vg_Ogi0EMOw="
}
POST/v1/autocomplete

Get up to 10 ordered App Store keyword suggestions for a seed term.

Dark-mode iPhone App Store autocomplete suggestions for Hab in Sweden
App Store suggestions for “Hab” in the Swedish storefront.
curl https://api.asoskill.com/v1/autocomplete \
  -H "Authorization: Bearer $ASO_SKILL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"term":"Hab","storefront":"SE","platform":"iphone"}'
{
  "term": "Hab",
  "storefront": "SE",
  "platform": "iphone",
  "resultCount": 8,
  "suggestions": [
    { "position": 1, "term": "habit tracker" },
    { "position": 2, "term": "habitica" },
    { "position": 3, "term": "habbo" },
    { "position": 4, "term": "habit" },
    { "position": 5, "term": "habitify" },
    { "position": 6, "term": "habbie" },
    { "position": 7, "term": "habit tracker free" },
    { "position": 8, "term": "habitshare" }
  ],
  "cache": "refresh",
  "fetchedAt": "2026-09-14T10:09:14.032Z",
  "requestId": "CTK0Vg_Ogi0EMOw="
}
POST/v1/popularity

Get a 1–100 popularity score from monthly report data and direct or related signals.

curl https://api.asoskill.com/v1/popularity \
  -H "Authorization: Bearer $ASO_SKILL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"term":"workout planner","storefront":"US"}'
{
  "term": "workout planner",
  "storefront": "US",
  "score": 42,
  "source": "direct",
  "cache": "refresh",
  "fetchedAt": "2026-08-18T12:00:00.000Z",
  "requestId": "CTK0VhCtgi0EJ3Q="
}
POST/v1/apps/lookup

Look up detailed App Store metadata for up to 10 app IDs in one call.

curl https://api.asoskill.com/v1/apps/lookup \
  -H "Authorization: Bearer $ASO_SKILL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appIds":["6446901002","284882215"],"storefront":"US","platform":"iphone"}'
{
  "storefront": "US",
  "platform": "iphone",
  "apps": [{
    "appId": "6446901002",
    "name": "Example App",
    "developer": "Example Developer",
    "iconUrl": "https://example.com/icon.png",
    "subtitle": "Plan your day",
    "categories": ["6007"],
    "rating": {
      "average": 4.8, "count": 12500,
      "one": 100, "two": 120, "three": 380,
      "four": 1700, "five": 10200
    },
    "categoryRanking": null,
    "currentVersionNumber": "4.2.0",
    "currentVersionReleasedAt": "2026-08-01T09:00:00.000Z",
    "versionHistory": [{
      "versionDisplay": "4.2.0",
      "releaseTimestamp": "2026-08-01T09:00:00.000Z"
    }],
    "screenshots": ["https://example.com/screenshot.png"],
    "description": "Plan workouts and track your progress.",
    "paid": false
  }],
  "missingAppIds": [],
  "cache": "hit",
  "fetchedAt": "2026-08-18T12:00:00.000Z",
  "requestId": "CTK0ViMxgi0EOQQ="
}

Start with free credits.

Create an account, name your API key, and make your first request.

Sign in or create an account