Check App Store Search Ranking
asc_search_rankingCheck an app's search ranking for a keyword on the App Store. Optionally provide a bundle ID to find the rank of a specific app in search results.
Instructions
Check an app's search ranking for a keyword on the App Store, using the public iTunes Search API. No App Store Connect authentication (JWT) is required for this tool.
Args:
keyword (string, required): The search keyword
country (string): ISO 3166-1 alpha-2 country code (default 'jp')
bundleId (string, optional): Bundle ID of the target app. If provided, its rank within the top 200 results is looked up.
topN (number): Number of top results to include (default 10, max 50)
Returns: { "keyword": string, "country": string, "totalResults": number, "targetRank": number | null, // bundleId指定時にランクが見つかった場合のみ数値、それ以外はnull "targetNote": string | undefined, // targetRankがnullの場合の理由 "target": { // bundleIdが上位200件内で見つかった場合のみ "trackName": string, "averageUserRating": number, "userRatingCount": number } | undefined, "topResults": [ { "rank": number, "trackName": string, "bundleId": string, "averageUserRating": number, "userRatingCount": number, "price": number, "genres": string[] // 先頭2件のみ } ] }
Error Handling:
iTunes Search APIはレート制限(目安: 約20リクエスト/分)があり、超過するとHTTP 403が返ることがある。その場合は時間をおいて再試行すること。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topN | No | Number of top-ranked results to include in the response (default 10, max 50). | |
| country | No | ISO 3166-1 alpha-2 country code (default 'jp'). | jp |
| keyword | Yes | The search keyword to check the ranking for. | |
| bundleId | No | Bundle ID of the target app. If provided, the tool looks up its rank within the search results (top 200). |