appstore-intel

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

App Store Intelligence

应用商店信息检索

Look up app details, ratings, reviews, and search the iOS App Store and Mac App Store using Apple's free iTunes Search & Lookup APIs. No API key required.

For Google Play, use web scraping via

web_search

and

web_fetch

可通过苹果免费的iTunes Search & Lookup APIs查询应用详情、评分、评论，以及搜索iOS App Store和Mac App Store。无需API密钥。

对于Google Play，可通过

web_search

和

web_fetch

进行网页抓取。

When to Use

适用场景

User asks about an app's ratings or reviews
User wants to compare apps in a category
User wants to find apps by keyword
User asks about a competitor's app store presence
User wants app metadata (price, size, version, release notes)

用户询问应用的评分或评论
用户想要对比某一分类下的应用
用户想要通过关键词查找应用
用户想要调研竞品在应用商店的布局
用户需要应用元数据（价格、大小、版本、更新说明）

API Overview — Apple iTunes Search API

API概览 — Apple iTunes Search API

Free. No authentication. No API key.

Two endpoints:

Search:
```
https://itunes.apple.com/search
```
Lookup:
```
https://itunes.apple.com/lookup
```

Rate Limit: ~20 calls per minute. Cache results for heavy usage.

免费，无需认证，无需API密钥。

两个端点：

搜索：
```
https://itunes.apple.com/search
```
查询：
```
https://itunes.apple.com/lookup
```

调用限制： 约每分钟20次调用。高频使用时请缓存结果。

Searching for Apps

搜索应用

Basic Search

基础搜索

https://itunes.apple.com/search?term=QUERY&country=COUNTRY&entity=software&limit=N

Use

web_fetch

to call this URL. Response is JSON.

https://itunes.apple.com/search?term=QUERY&country=COUNTRY&entity=software&limit=N

使用

web_fetch

调用该URL，返回结果为JSON格式。

Parameters

参数说明

Parameter	Description	Required	Values
`term`	Search query (URL-encoded, `+` for spaces)	Yes	Any text
`country`	Two-letter country code	Yes	`us` , `gb` , `de` , etc.
`entity`	App type	No	`software` (iPhone), `iPadSoftware` , `macSoftware`
`media`	Media type	No	`software` (default for apps)
`limit`	Max results	No	1–200 (default 50)
`lang`	Language	No	`en_us` , `ja_jp`

参数	描述	是否必填	可选值
`term`	搜索关键词（需URL编码，空格用 `+` 代替）	是	任意文本
`country`	两位字母国家代码	是	`us` , `gb` , `de` 等
`entity`	应用类型	否	`software` （iPhone应用）、 `iPadSoftware` 、 `macSoftware`
`media`	媒体类型	否	`software` （应用默认值）
`limit`	最大返回结果数	否	1–200（默认50）
`lang`	语言	否	`en_us` , `ja_jp`

Example

示例

https://itunes.apple.com/search?term=fitness+tracker&country=us&entity=software&limit=10

https://itunes.apple.com/search?term=fitness+tracker&country=us&entity=software&limit=10

Looking Up Specific Apps

查询特定应用

By App ID (Track ID)

通过应用ID（Track ID）

https://itunes.apple.com/lookup?id=APP_ID&country=us

https://itunes.apple.com/lookup?id=APP_ID&country=us

By Bundle ID

通过Bundle ID

https://itunes.apple.com/lookup?bundleId=com.example.app&country=us

https://itunes.apple.com/lookup?bundleId=com.example.app&country=us

Multiple Apps at Once

批量查询多个应用

https://itunes.apple.com/lookup?id=ID1,ID2,ID3&country=us

https://itunes.apple.com/lookup?id=ID1,ID2,ID3&country=us

Response Format

返回格式

Each result contains:

json

{
  "trackId": 553834731,
  "trackName": "App Name",
  "bundleId": "com.example.app",
  "sellerName": "Company Name",
  "artistName": "Developer Name",
  "price": 0.00,
  "formattedPrice": "Free",
  "currency": "USD",
  "averageUserRating": 4.5,
  "userRatingCount": 125000,
  "averageUserRatingForCurrentVersion": 4.3,
  "userRatingCountForCurrentVersion": 5000,
  "contentAdvisoryRating": "4+",
  "trackContentRating": "4+",
  "primaryGenreName": "Health & Fitness",
  "genres": ["Health & Fitness", "Lifestyle"],
  "description": "Full app description...",
  "releaseNotes": "What's new in this version...",
  "version": "3.2.1",
  "currentVersionReleaseDate": "2024-01-10T00:00:00Z",
  "releaseDate": "2020-06-15T00:00:00Z",
  "fileSizeBytes": "52428800",
  "minimumOsVersion": "15.0",
  "trackViewUrl": "https://apps.apple.com/us/app/...",
  "artworkUrl512": "https://is1-ssl.mzstatic.com/...",
  "screenshotUrls": ["url1", "url2"],  // ⚠️ Can be 10+ URLs — summarize count, don't dump all
  "supportedDevices": ["iPhone15,2", "iPad14,1"],  // ⚠️ Can be 100+ items — omit from output to save context
  "languageCodesISO2A": ["EN", "FR", "DE"]
}

The response wrapper:

json

{
  "resultCount": 10,
  "results": [...]
}

每个结果包含以下字段：

json

{
  "trackId": 553834731,
  "trackName": "App Name",
  "bundleId": "com.example.app",
  "sellerName": "Company Name",
  "artistName": "Developer Name",
  "price": 0.00,
  "formattedPrice": "Free",
  "currency": "USD",
  "averageUserRating": 4.5,
  "userRatingCount": 125000,
  "averageUserRatingForCurrentVersion": 4.3,
  "userRatingCountForCurrentVersion": 5000,
  "contentAdvisoryRating": "4+",
  "trackContentRating": "4+",
  "primaryGenreName": "Health & Fitness",
  "genres": ["Health & Fitness", "Lifestyle"],
  "description": "Full app description...",
  "releaseNotes": "What's new in this version...",
  "version": "3.2.1",
  "currentVersionReleaseDate": "2024-01-10T00:00:00Z",
  "releaseDate": "2020-06-15T00:00:00Z",
  "fileSizeBytes": "52428800",
  "minimumOsVersion": "15.0",
  "trackViewUrl": "https://apps.apple.com/us/app/...",
  "artworkUrl512": "https://is1-ssl.mzstatic.com/...",
  "screenshotUrls": ["url1", "url2"],  // ⚠️ 可能包含10个以上链接——请汇总数量，不要全部输出
  "supportedDevices": ["iPhone15,2", "iPad14,1"],  // ⚠️ 可能包含100多个设备——为节省上下文，请勿在输出中包含
  "languageCodesISO2A": ["EN", "FR", "DE"]
}

响应包装结构：

json

{
  "resultCount": 10,
  "results": [...]
}

Google Play Lookup

Google Play查询

There's no free public Google Play API. Use these approaches:

目前没有免费的公开Google Play API，可采用以下方法：

Web Search

网页搜索

web_search: "site:play.google.com/store/apps QUERY"

web_search: "site:play.google.com/store/apps QUERY"

Direct App Page Scraping

直接抓取应用页面

web_fetch: https://play.google.com/store/apps/details?id=PACKAGE_ID&hl=en&gl=us

⚠️ Google Play pages may return limited content or block automated requests. If

web_fetch

returns incomplete data, fall back to

web_search

results which typically include rating, download count, and developer info in the snippet.

Extract from the fetched HTML (when available):

Title, developer, rating, review count, downloads
Description, what's new, screenshots

web_fetch: https://play.google.com/store/apps/details?id=PACKAGE_ID&hl=en&gl=us

⚠️ Google Play页面可能返回有限内容或阻止自动化请求。 如果

web_fetch

返回的数据不完整，可退而使用

web_search

结果，通常搜索结果摘要中会包含评分、下载量和开发者信息。

从抓取的HTML中提取信息（如果可用）：

标题、开发者、评分、评论数、下载量
描述、更新内容、截图

Google Play Package ID

Google Play包名ID

The package ID is in the URL:

play.google.com/store/apps/details?id=com.example.app

包名ID位于URL中：

play.google.com/store/apps/details?id=com.example.app

Step-by-Step Instructions

分步操作指南

Search for Apps by Keyword

通过关键词搜索应用

URL-encode the search term

Fetch:

https://itunes.apple.com/search?term=ENCODED_QUERY&country=us&entity=software&limit=10

Parse JSON response
For each result, present: name, developer, rating, review count, price, and App Store link

对搜索关键词进行URL编码

请求：

https://itunes.apple.com/search?term=ENCODED_QUERY&country=us&entity=software&limit=10

解析JSON响应
为每个结果展示：名称、开发者、评分、评论数、价格和应用商店链接

Get Detailed Info for a Specific App

获取特定应用的详细信息

Find the app's Track ID (from a search, or from the App Store URL — the number after
```
/id
```
)

Fetch:

https://itunes.apple.com/lookup?id=TRACK_ID&country=us

Present full details: rating, reviews, version, release notes, price, size, description

找到应用的Track ID（可来自搜索结果，或应用商店URL中
```
/id
```
后的数字）

请求：

https://itunes.apple.com/lookup?id=TRACK_ID&country=us

展示完整详情：评分、评论、版本、更新说明、价格、大小、描述

Compare Two Apps

对比两个应用

Look up both apps:

https://itunes.apple.com/lookup?id=ID1,ID2&country=us

Present side-by-side comparison of key metrics

批量查询两个应用：

https://itunes.apple.com/lookup?id=ID1,ID2&country=us

以对比表格形式展示关键指标

Check an App's Rating Across Countries

查看应用在不同国家的评分

Look up the same ID with different country codes:

https://itunes.apple.com/lookup?id=APP_ID&country=us

https://itunes.apple.com/lookup?id=APP_ID&country=gb

https://itunes.apple.com/lookup?id=APP_ID&country=de

Compare ratings and review counts by region

使用不同国家代码查询同一应用ID：

https://itunes.apple.com/lookup?id=APP_ID&country=us

https://itunes.apple.com/lookup?id=APP_ID&country=gb

https://itunes.apple.com/lookup?id=APP_ID&country=de

对比各地区的评分和评论数

Find Both iOS and Android Versions

查找iOS和Android版本的应用

Search iOS: iTunes Search API with the app name

Search Android:

web_search "site:play.google.com/store/apps APP_NAME"

Fetch the Google Play page with
```
web_fetch
```
for details
Present both platforms' data

搜索iOS应用：使用iTunes Search API查询应用名称

搜索Android应用：

web_search "site:play.google.com/store/apps APP_NAME"

使用
```
web_fetch
```
请求Google Play页面获取详情
展示两个平台的数据

Finding App IDs

查找应用ID的方法

From App Store URL:

apps.apple.com/us/app/app-name/id553834731

→ ID is

553834731

From search results: The
```
trackId
```
field
From bundle ID lookup: If you know the bundle ID (e.g.,
```
com.spotify.client
```
)

从应用商店URL获取：

apps.apple.com/us/app/app-name/id553834731

→ ID为

553834731

从搜索结果获取： 结果中的
```
trackId
```
字段
通过Bundle ID查询： 如果已知Bundle ID（例如
```
com.spotify.client
```
）

Output Format

输出格式

Single App

单个应用信息

undefined

undefined

App Name

应用名称

⭐ 4.5/5 (125K ratings) · Free By Developer Name · Health & Fitness Version 3.2.1 (Jan 10, 2024)

📝 What's New: Latest release notes summary...

📱 iOS: https://apps.apple.com/... 🤖 Android: https://play.google.com/...

undefined

⭐ 4.5/5（12.5万条评分）· 免费开发者：Developer Name · 分类：Health & Fitness 📱 iOS：https://apps.apple.com/... 🤖 Android：https://play.google.com/...

undefined

Search Results

搜索结果

undefined

undefined

App Store Results for "query" (N found)

"关键词"的应用商店搜索结果（共找到N个）

App Name ⭐ 4.5 (125K) · Free By Developer · Category 📱 https://apps.apple.com/...
App Name ⭐ 4.2 (50K) · $4.99 By Developer · Category 📱 https://apps.apple.com/...

undefined

应用名称 ⭐ 4.5（12.5万条）· 免费开发者：Developer · 分类：Category 📱 https://apps.apple.com/...
应用名称 ⭐ 4.2（5万条）· 4.99美元开发者：Developer · 分类：Category 📱 https://apps.apple.com/...

undefined

Comparison

对比表格

undefined

undefined

App Comparison

应用对比

Metric	App A	App B
Rating	⭐ 4.5	⭐ 4.2
Reviews	125K	50K
Price	Free	$4.99
Size	50 MB	120 MB
Last Updated	Jan 10, 2024	Dec 5, 2023

undefined

指标	应用A	应用B
评分	⭐ 4.5	⭐ 4.2
评论数	12.5万	5万
价格	免费	4.99美元
大小	50 MB	120 MB
最后更新日期	2024-01-10	2023-12-05

undefined

Error Handling

错误处理

No results: The search term may be too specific. Try broader terms or check spelling.
API error / timeout: Retry once. The iTunes API is generally reliable.
Rate limited: Wait 60 seconds. Consider caching results for batch lookups.
Country not found: Verify the two-letter ISO country code.
App removed from store: The lookup will return
```
resultCount: 0
```
. Inform the user the app may have been removed.
Google Play scraping fails: The page structure may have changed. Fall back to
```
web_search
```
results.

无结果： 搜索关键词可能过于具体，尝试更宽泛的关键词或检查拼写。
API错误/超时： 重试一次。iTunes API通常可靠性较高。
触发调用限制： 等待60秒。批量查询时建议缓存结果。
国家代码无效： 验证两位字母ISO国家代码是否正确。
应用已从商店移除： 查询会返回
```
resultCount: 0
```
，告知用户该应用可能已被下架。
Google Play抓取失败： 页面结构可能已变更，退而使用
```
web_search
```
结果。

Examples

示例

Example 1: "How's the Spotify app rated?"

示例1："Spotify应用的评分如何？"

Fetch: https://itunes.apple.com/lookup?bundleId=com.spotify.client&country=us

请求：https://itunes.apple.com/lookup?bundleId=com.spotify.client&country=us

Example 2: "Find fitness apps with good ratings"

示例2："找评分高的健身应用"

Fetch: https://itunes.apple.com/search?term=fitness&country=us&entity=software&limit=20

Then filter results where

averageUserRating >= 4.5

and sort by

userRatingCount

请求：https://itunes.apple.com/search?term=fitness&country=us&entity=software&limit=20

然后筛选

averageUserRating >= 4.5

的结果，并按

userRatingCount

排序。

Example 3: "Compare Notion and Obsidian on the App Store"

示例3："对比Notion和Obsidian在应用商店的情况"

Look up both apps and present a comparison table.

查询两个应用的信息，并展示对比表格。

Data Sources

数据来源

iOS / Mac: iTunes Search API — Free, no auth
Android: Google Play Store web pages via
```
web_fetch
```
— Free, no auth, scraping

iOS / Mac： iTunes Search API — 免费，无需认证
Android： 通过
```
web_fetch
```
抓取Google Play商店网页 — 免费，无需认证，基于网页抓取