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
Agent-native setup

Install an Agent Skill, connect the hosted MCP server, or use the secure 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.

Use the route that fits.

Every option reaches the same focused App Store data service.

Agent Skill

One-command instructions for Claude Code, Codex, and compatible agents.

Install the skill →ChatGPT

Connect the hosted MCP tools with secure account authorization.

Use with ChatGPT →Claude

Add ASO Skill as a remote connector in Claude and Claude Desktop.

Use with Claude →CLI

Run browser-assisted login and ASO research from any supported terminal.

Use the CLI →MCP server

Connect any compatible remote MCP client to the production endpoint.

Read the MCP guide →HTTP API

Build your own ASO tool with typed JSON endpoints and the OpenAPI contract.

Read the API guide →

Everything is an endpoint.

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
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/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.

Sign up, create a named secret key, and make your first request.

Sign in or create an account