夜雨聆风
苹果官方 App Store RSS 接口完整说明(中国区可用)
以下为苹果公开、稳定、无需认证的 App Store RSS 榜单/数据接口，可直接用于抓取榜单、新上架、应用详情等 。
一、基础 URL 格式（通用）
plaintext
https://itunes.apple.com/{country}/rss/{feed_type}/limit={limit}/genre={genre}/json
– {country} ：国家/地区代码（中国区： cn ）
– {feed_type} ：榜单类型（见下文）
– {limit} ：返回数量（1–200，免费榜最多 200）
– {genre} ：分类代码（见下文）
– 后缀 /json ：返回 JSON（默认 XML）
二、核心榜单类型（feed_type）
1. 热门/免费/付费榜（你原来用的）
– topfreeapplications ：免费应用榜（你之前误用在“新上架”）
– toppaidapplications ：付费应用榜
– topgrossingapplications ：畅销应用榜
– topfreeipadapplications ：iPad 免费榜
– toppaidipadapplications ：iPad 付费榜
2. 新上架/新发布（你现在需要的）
– newapplications ：新上架应用（含免费+付费）
– newfreeapplications ：新上架免费应用（最常用）
– newpaidapplications ：新上架付费应用
3. 其他常用
– topmovies ：电影榜
– topmusicvideos ：音乐视频榜
– topalbums ：专辑榜
– topsongs ：歌曲榜
三、分类代码（genre）
中国区常用（对应 APP_STORE_CATEGORIES）
plaintext
全部: all
游戏: games
社交: social-networking
购物: shopping
教育: education
娱乐: entertainment
工具: utilities
生活: lifestyle
商务: business
财经: finance
健康: health-fitness
体育: sports
新闻: news
旅游: travel
音乐: music
摄影: photo-video
生产力: productivity
天气: weather
图书: books
导航: navigation
四、完整示例（可直接复制测试）
1. 中国区新上架免费应用（前100）
plaintext
https://itunes.apple.com/cn/rss/newfreeapplications/limit=100/genre=all/json
2. 中国区游戏分类新上架付费（前50）
plaintext
https://itunes.apple.com/cn/rss/newpaidapplications/limit=50/genre=games/json
3. 中国区免费总榜（前200）
plaintext
https://itunes.apple.com/cn/rss/topfreeapplications/limit=200/genre=all/json
4. 中国区畅销榜（前100）
plaintext
https://itunes.apple.com/cn/rss/topgrossingapplications/limit=100/genre=all/json
五、接口返回结构（JSON）
json
{
“feed”: {
“entry”: [
{
“im:name”: { “label”: “应用名称” },
“im:image”: [
{ “label”: “图标URL（不同尺寸）” }
],
“id”: {
“attributes”: { “im:id”: “App ID（如 123456789）” }
},
“im:artist”: { “label”: “开发者” },
“category”: { “attributes”: { “term”: “分类代码” } },
“im:price”: { “label”: “价格” },
“im:releaseDate”: { “label”: “发布时间” }
}
]
}
}
六、关键规则与限制
1. 数据范围：
– 新上架接口（ new* ）：返回最近7天左右上架的应用（苹果官方定义）
– 热门榜：返回当前实时热门
2. 数量限制： limit 最大 200（免费榜），付费/新上架通常 100 封顶
3. 频率限制：无官方明确限流，但建议间隔2–3秒，避免被封 IP
4. 格式：支持 json / xml ，JSON 更易解析
5. 无需认证：公开接口，无 API Key/Token 要求
七、应用详情查询（Lookup API）
接口（非 RSS，用于查单个 App 完整信息）
plaintext
https://itunes.apple.com/lookup?id={app_id}&country=cn
– {app_id} ：从 RSS 接口获取的 im:id
– 返回：完整应用信息（名称、开发者、版本、发布时间、评分、描述等）
八、应用评论接口
plaintext
https://itunes.apple.com/cn/rss/customerreviews/id={app_id}/json
– 按时间倒序返回评论（最多 500 条）
九、常见错误与排查
– 返回空：
– 分类代码错误（核对 genre）
– 国家代码错误（中国区必须 cn ）
– 新上架接口无数据（正常，苹果新上架数量有限）
– 403/被封：
– 增加请求间隔（≥2秒）
– 更换 User-Agent
– 避免短时间大量请求
十、官方工具（RSS Feed Generator）
苹果提供可视化生成工具，可直接生成 URL：
https://rss.itunes.apple.com/
