@ appigits/ cli (英语)

Appgits CLI ——查询 App 度量衡,评论,并存储您终端的数据.

现在试试,不用安装 :

npx @appfigures/cli auth login
npx @appfigures/cli apps search "youtube"

QQ 使用 Appigits AI 的四种方法

将Appfigits带入你的代理中,不管它是建起来的——作为它调用的工具,它写的代码,一个CLI,或者超过MCP. 无论你挑哪一个,你都可以做同样的事情,得到同样的JSON回来.

• 🛠️ 代理工具 ——你的经纪人在Appgapts运行时称它为工具. AI SDK, OpenAI, LangChain. (原始内容存档于2018-09-21) (英语) 添加工具
• 📦 客户 – 您的代理写出代码, 用于查询 Appfigure 并获得打入后的数据 。 → 使用客户端
• 🖥️ 国 际 ——从终端或沙盒运行 Appigits. → @appfigures/cli
• 🔌 MCP 磁共振 ——连接 Appigits 到克洛德, ChatGPT, 或 Cursor 连接主机服务器

安装

npm install -g @appfigures/cli

需要节点.js 22+. 工作与pnpm和纱线.

快开始

appfigures auth login
appfigures --help

也可用 af 别名.

认证

• 自己登记. af auth login --interactive 在引导流中打开浏览器;批准并粘贴回代码.
• 或者让你的经纪人指导你. 默认, af auth login 打印授权 URL —— 打开、批准和完成 af auth login --code <code> 使用显示的代码。 一个特工可以推动这一端结束. 用于未处理的用途, 设置 APPFIGURES_API_KEY 相反: 在 appigits.com/开发者/钥匙 通过单击 创建新客户端,则 创建个人访问托肯。 。 。 .

任何登录都会保存令牌给您的OS证书管理器(macOS Keychain,Windows证书管理器,Linux Secret Service). 见 环境 页:1 APPFIGURES_API_KEY 还有其他的功能.

MCP 服务器

应用程序运行主机 示范背景协议 服务器在 https://mcp.appfigures.com/mcp。将其添加到任何支持远程服务器的MCP客户端中,并在客户端询问时与您的 Appfits 账户签名. 没有什么可以安装的,也没有可以管理的迹象.

克劳德代码. 添加一个命令, 然后运行 /mcp 以 :

claude mcp add --transport http appfigures https://mcp.appfigures.com/mcp

克洛德 (网络和桌面). 添加 URL 作为自定义连接符 。 见 添加目录中没有的连接符。 。 。 .

恰克格普特(英语:ChatGPT). 将 URL 添加为 OAuth 的自定义 MCP 服务器 。 见 连接配置到 ChatGPT。 。 。 .

其他客户. 添加一个具有相同URL的远程(Streamable HTTP)服务器. 看看你客户的MCP文档.

主机服务器与API和CLI共享公共数据访问和信用. 关于申请限额和信贷费用,见 配置 API、 CLI 和 MCP: 访问、限制和公共数据。 。 。 .

用于认证的脚本和无头代理 APPFIGURES_API_KEY运行 af 直接命令,或使用 @appfigures/agent-toolkit 从代码.

af mcp (折旧)

af mcp 运行与本地 stdio 服务器相同的工具 。 已堕取出后会取出下大出. 现有的设置一直工作到那时,但不会获得新的MCP功能. 移动到上面的主机服务器 .

图标

应用程序

找到应用程序并查查他们的身份 其他命令则使用应用程序标识这些返回.

浏览器

搜索与分析全应用程序目录:苹果、谷歌游戏、亚马逊等主要商店的上百万个产品.

计量

查询跨维度的数字数据集.

存储

App商店的存在:上市内容,类别排行,上图,并有特色地布置.

观众

应用程序的用户是谁,他们还使用什么. 覆盖了估计的年龄和性别,加上观众与其他应用程序的重叠.

审查

搜索,总结,并回复iOS和Google Play应用商店的评论.

关键词

关键字能见度,分级跟踪,以及跨越有机搜索(App Store,Google Play)和苹果Ads的发现.

苹果广告

管理您的 Apple Ads 活动, 广告组, 关键词和性能 .

垫子

看看我们追踪的SDK.

文档

具体行动和共同任务的参考文件和指南.

API 密码

MCP 磁共振

认证

运行 af <command> --help 用于论证、旗帜和实例.

环境

API 参考

每个命令都有完整的参数和旗帜列表. 一行概览见 图标 见上文.

全球旗帜. 所有命令接受 :

• -v, --verbose ——日志 HTTP 请求 stderr. 也通过 AF_VERBOSE=1。 。 。 .
• -V, --version ——打印CLI版本并退出.
• -h, --help 显示当前命令的用法 .

输出格式. 每个命令在 stdout 上发出一个 JSON 值—— 管道到 jq 用于过滤。 信息信息,提示, 和更新通知到 Stderr ,所以管道保持干净.

af 应用程序搜索

af apps search <q> [flags]

按名称或出版商查找应用软件. 每个统一应用程序返回一行。 默认返回 Apple 和 Google 列表; 通过 --all-stores 包括其他商店。 要通过估计值过滤应用程序( 如上个月下载了 > 100k的应用程序) explorer list-products用于按时间、国家或库存额分列的估计数 metrics query 包含数据集估计数。 销售或估计.

选项

• <q> 需要字符串。 搜索查询(应用名称或发布者).
• --all-stores 布尔, 默认值 false. 包含苹果和谷歌以外的商店前端:亚马逊,Windows,Steam,Roku,LG TV,三星TV等.
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Find every Electronic Arts app.
af apps search 'electronic arts'

# Page through long results.
af apps search 'electronic arts' --count=25 --page=2

# Find Minecraft on every storefront (e.g. Amazon, Steam, Windows, Roku; not common).
af apps search minecraft --all-stores

af 应用程序获得

af apps get <app-id> [flags]

获得一个app的纪录:基本的元数据(名称,开发者等),如果用户跟踪,他们可以访问哪些数据. 通过一个店面的产品ID;所有店面一起统一应用ID.

选项

• <app-id> 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.
• --all-stores 布尔, 默认值 false. 对于一个统一的app ID:包括跨所有商店前端(Amazon,Steam,Windows,Roku等)的成员产品. 当假的, member_products 仅限有应用智能覆盖(iOS + Google Play)的存储面. 产品ID被忽略.

实例

# Get Minecraft's unified-app record (iOS + Google Play by default).
af apps get ua_X7iNgb

# Get Minecraft's Google Play product record.
af apps get 6938219

af 跟踪应用程序

af apps tracked [flags]

列出您的 Appgits 账户轨迹 .

选项

• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.
• --q 绳子。 要过滤的 App 名称 .
• --filter-apps-by-id (整数或弦) [. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 filterAppsBy* 设置时键。 Storefront, source, 或type filters 更适合应用集.
• --filter-apps-by-storefront 字符串[]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
• --filter-apps-by-source 字符串[]. 通过跟踪关系来缩小账户的跟踪应用.
• --filter-apps-by-type 字符串[]. 将账户的跟踪应用 缩小到这些类型的产品.

实例

# List your apps with private-data access.
af apps tracked --filter-apps-by-source=own,shared

# List your tracked fitness apps.
af apps tracked --q=fitness

# List just your iOS apps.
af apps tracked --filter-apps-by-storefront=apple:ios

# Page through long results.
af apps tracked --filter-apps-by-source=own,shared --count=50 --page=2

# List tracked competitors.
af apps tracked --filter-apps-by-source=manual

# Find individual IAPs or subscriptions (not common).
af apps tracked --filter-apps-by-type=inapp,subscription

af 应用程序分解

af apps breakdown [flags]

按数据组(如销售量,使用量,排名,评论量,关键词),存储前置,货币化模型,和源(你的对被跟踪的竞争者)计算出你的有跟踪的应用,外加总和最早的发布日期.

选项

• --filter-apps-by-id (整数或弦) [. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 filterAppsBy* 设置时键。 Storefront, source, 或type filters 更适合应用集.
• --filter-apps-by-storefront 字符串[]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
• --filter-apps-by-source 字符串[]. 通过跟踪关系来缩小账户的跟踪应用.
• --filter-apps-by-type 字符串[]. 将账户的跟踪应用 缩小到这些类型的产品.

实例

# Check what data the whole account has.
af apps breakdown

# Limit to apps you own or that were shared with you.
af apps breakdown --filter-apps-by-source=own,shared

# Limit to your iOS apps.
af apps breakdown --filter-apps-by-storefront=apple:ios

af 探险家列表产品

af explorer list-products [flags]

为一个或许多应用程序读取目录字段 。 引用字段 query 或者说 sort 自动返回; 通过 --extra-fields 为了更多。 使用 ["match","product_id",<id>] 用于一个单一的应用程序,或者合并用于人口查询的过滤器(例如使用Firebase的iOS应用程序和1M+美国收入). 120+字段横跨排名、评级、下载和收入估计、SDK、人口统计等等;查询语法和字段列表 docs get catalog_playbook。 。 。 .

选项

• --query 数组, 默认值 []。以 JSON 数组格式进行探索查询,以选择匹配的目录产品。 活动产品默认值 。 包含不活动 : [“ match” “ mactive” , [“ or”, true, false]]]。 完整字段列表和查询语法在以下文件中记录: docs get catalog_playbook。 。 。 .
• --extra-fields 字符串[]. 包含在您的 query 或者说 sort 已经引用。 查找字段路径( 以及您可以读取的路径) explorer describe-fields。 。 。 .
• --sort 绳子。 探索者字段名称 。 完整字段清单载于 docs get catalog_playbook。 。 。 .
• --order 字符串, 默认 desc排序方向.
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.
• --allow-unscoped-nested 布尔, 默认值 false. 故意进行广泛查询的逃生舱。 绕过默认块于通常会膨胀结果的无镜巢上上游.

实例

# Find iOS apps that have Firebase installed.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["nested","all_sdks",["and",["match","all_sdks.id","firebase"],["match","all_sdks.active",true]]]]'

# Rank the biggest US iOS games by revenue.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014]]' --sort='custom_meta[country=us].revenue_estimates_sum_30_days' --order=desc --count=25

# Find US iOS apps in the $100k–$1M/month revenue tier.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["nested","custom_meta",["and",["match","custom_meta.country","us"],["match","custom_meta.revenue_estimates_sum_30_days",["number_range",100000,1000000]]]]]'

# Page through results.
af explorer list-products --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014]]' --count=50 --page=2

# Pass `--extra-fields` for columns the query doesn't already reference. Common for single-app reads.
af explorer list-products --query='["match","product_id",304004187384]' --extra-fields='custom_meta[country=zz].revenue_estimates_sum_365_days,all_sdks[id=firebase].active'

af 探险家总产品

af explorer aggregate-products <fields> [flags]

在苹果、Google Play、Amazon及其他主要商店的数百万产品全目录中, 使用与 explorer list-products;返回总量,而不是产品记录。 用于市场规模、基准和部门分析.

选项

• <fields> 需要字符串[]。 Field+聚合对(例如. all_rating/stats, (中文(简体) ), storefronts/terms合计数: stats, (中文(简体) ), terms, (中文(简体) ), histogram, (中文(简体) ), date_histogram, (中文(简体) ), cardinality。完整字段清单在 docs get catalog_playbook。 。 。 .
• --query 数组, 默认值 []。以 JSON 数组格式进行探索查询,以选择匹配的目录产品。 活动产品默认值 。 包含不活动 : [“ match” “ mactive” , [“ or”, true, false]]]。 完整字段列表和查询语法在以下文件中记录: docs get catalog_playbook。 。 。 .
• --allow-unscoped-nested 布尔, 默认值 false. 故意进行广泛查询的逃生舱。 绕过默认块于通常会膨胀结果的无镜巢上上游.
• --terms-count 整数, 默认 20返回最大桶数 terms 汇总。 其他聚合类型忽略了它.
• --date-histogram-interval 绳子。 每个小桶颗粒度 date_histogram 汇总。 其他聚合类型忽略了它.

实例

# How many monthly downloads does an average iOS app get in Japan?
af explorer aggregate-products 'custom_meta[country=jp].download_estimates_average_30_days/stats' --query='["and",["match","storefronts","apple:ios"],["match","countries","jp"]]'

# What's the rating, category mix, and developer concentration for US iOS apps in the $100k–$10M/mo net-revenue tier?
af explorer aggregate-products all_rating/stats,categories.all/terms,developer_id/cardinality --query='["and",["match","storefronts","apple:ios"],["nested","custom_meta",["and",["match","custom_meta.revenue_estimates_sum_30_days",["number_range",100000,10000000]],["match","custom_meta.country","us"]]]]'

# Are new iOS games still launching at the same rate as two years ago?
af explorer aggregate-products release_date/date_histogram --query='["and",["match","storefronts","apple:ios"],["match","categories.all",6014],["match","release_date",["range","2024-01-01","2025-12-31"]]]'

# What SDKs do apps commonly ship alongside OneSignal?
af explorer aggregate-products 'all_sdks[*].id/terms' --query='["nested","all_sdks",["and",["match","all_sdks.id","onesignal"],["match","all_sdks.active",true]]]'

# How do iOS app ratings distribute?
af explorer aggregate-products all_rating/histogram --query='["match","storefronts","apple:ios"]'

# How many apps are on each storefront?
af explorer aggregate-products storefronts/terms

af 探险家描述域

af explorer describe-fields [flags]

列出目录字段和当前用户的每个访问级别 。 以关键字搜索查找字段 。 同一个字段集 explorer list-products 财务报告和审定财务报表 explorer aggregate-products 接受 .

选项

• --count 整数, 默认 50。返回的结果数量.
• --page 整数, 默认 1。页码.
• --q 绳子。 过滤器由 path, (中文(简体) ), title, (中文(简体) ), description, (中文(简体) ), type。 。 。 .

实例

# Search for revenue-related fields.
af explorer describe-fields --q=revenue

# List every catalog field with the current user's access level.
af explorer describe-fields

af 度量衡查询

af metrics query <dataset> [flags]

查询一个或多个应用程序的任何数字数据集 。 可选分组最多可分出两个维度,返回后作为被嵌入的分区树,而不是应用记录. 可按国家、设备类型和日期范围独立过滤. filterAppsBy* 选项缩小应用程序集(通过ID, storefront, source, 或类型);没有选项,则查询覆盖每个应用程序的账户音轨.

选项

• <dataset> 需要字符串。 要查询的数据集( 如销售量 。 complex downloads) 。 见 metrics describe-datasets 用于完整列表,以及哪些数据集是私有数据(仅可观察到您拥有的或共享的应用程序).
• --group-by 字符串[]. 组的尺寸 Max 2: 第1个槽成为外实体类型,第二个是内相系列. 每个维相乘结果大小.
• --granularity 绳子。 按日期分组时的时间颗粒性
• --count 整数。 行盖. 与 --group-by,以数值表示的外部实体类型的上 N (在按日期分组时最早 N)。 无 --group-by,单页预览.
• --countries 字符串[]. 过滤到一个或多个 ISO 国家代码( 如 US, JP, GB)
• --device-type 绳子。 设备类型
• --all-time 布尔, 默认值 false进入整个历史 没有这个旗帜( 没有) start编号 :end),查询默认为最近30天。 相互独占 start 财务报告和审定财务报表 end。 。 。 .
• --filter-apps-by-id (整数或弦) [. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 filterAppsBy* 设置时键。 Storefront, source, 或type filters 更适合应用集.
• --filter-apps-by-storefront 字符串[]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
• --filter-apps-by-source 字符串[]. 通过跟踪关系来缩小账户的跟踪应用.
• --filter-apps-by-type 字符串[]. 将账户的跟踪应用 缩小到这些类型的产品.
• --start 绳子。 开始日期( YYYY- MM- DD)
• --end 绳子。 结束日期( YYYY- MM- DD, 默认为今天)

实例

# Get total downloads across your apps with private-data access.
af metrics query sales.combined_downloads --filter-apps-by-source=own,shared

# Get revenue split by storefront, plus a top-level total.
af metrics query sales.combined_revenue --filter-apps-by-source=own,shared --group-by=storefront

# Rank the top 5 tracked competitors by estimated monthly revenue.
af metrics query estimates.revenue --filter-apps-by-source=manual --group-by=product --count=5

# Track Candy Crush Saga's daily download estimates.
af metrics query estimates.sales --filter-apps-by-id=ua_V1Q1uX --group-by=date --granularity=daily

# Track net monthly recurring revenue per app, month over month.
af metrics query subscriptions.mrr --filter-apps-by-source=own,shared --group-by=product,date --granularity=monthly

# Get Minecraft's new ratings.
af metrics query ratings.new_total --filter-apps-by-id=ua_X7iNgb

# Track daily ad spend across your apps.
af metrics query adspend.cost --filter-apps-by-source=own,shared --group-by=date --granularity=daily

# Compare Candy Crush's December 2025 downloads across the US, Japan, and UK.
af metrics query estimates.sales --filter-apps-by-id=ua_V1Q1uX --countries=US,JP,GB --group-by=country --start=2025-12-01 --end=2025-12-31

# Track all-time monthly revenue across your apps with private-data access.
af metrics query sales.combined_revenue --filter-apps-by-source=own,shared --group-by=date --granularity=monthly --all-time

# Get Minecraft's review volume by country.
af metrics query reviews.total --filter-apps-by-id=ua_X7iNgb --group-by=country

af 度量衡描述数据集

af metrics describe-datasets [flags]

列出每个数字数据集 metrics query 接受,每个数据集一行带有其值类型,是否仅限于自己的应用程序.

选项

• --count 整数, 默认 50。返回的结果数量.
• --page 整数, 默认 1。页码.
• --q 绳子。 过滤器由 dataset, (中文(简体) ), value_type, (中文(简体) ), label, (中文(简体) ), description。 。 。 .

实例

# Search by keyword (matches name, label, or description).
af metrics describe-datasets --q='combined downloads'

# Look up one dataset by its exact name.
af metrics describe-datasets --q=sales.combined_downloads

# List every dataset with its value type and whether it's limited to your own apps.
af metrics describe-datasets

af 存储应用

af store app-ranks <app-ids> [flags]

追踪一国或多国应用程序的排名历史,设备类型,类别子类型,以及类别,作为时间序列位置并带有日复一日的三角洲.

选项

• <app-ids> 需要(整数或字符串)[。 App标识符(统一应用ID或产品ID)
• --countries 字符串[]. 国家代码查询. 对每个有级别覆盖的国家来说都是默认的.
• --granularity 字符串, 默认 hourly. 采样率。 小时给出最新数据; 通过 --granularity=daily 用于压缩多日历史.
• --device-types 字符串[],默认 ["handheld"]。将包含哪些设备类型;在自己的图表中,每个设备的排名。 添加更多内容以扩大响应范围.
• --subtypes 字符串[],默认 ["free","paid"]中,将包含哪些类别子类型;在自己的图表中,每个级别。 添加更多内容以扩大响应范围.
• --category-ids 整数[]. 过滤特定类别ID的响应行; 全部省略 。 类别ID来自 store categories。 。 。 .
• --start 绳子。 开始日期( YYYY- MM- DD)
• --end 绳子。 结束日期( YYYY- MM- DD, 默认为今天)
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Check ChatGPT's current ranks (unified app).
af store app-ranks ua_miTXv6 --countries=US

# Check ChatGPT's current ranks on one storefront.
af store app-ranks 336744124021 --countries=US

# Compare ChatGPT's ranks across the US, UK, and Japan.
af store app-ranks ua_miTXv6 --countries=US,GB,JP

# Check Procreate's paid iPad chart ranks.
af store app-ranks ua_CxA1MS --subtypes=paid --device-types=tablet --countries=US

# Trace ChatGPT's chart history through December 2025.
af store app-ranks ua_miTXv6 --granularity=daily --start=2025-12-01 --end=2025-12-31 --countries=US

# Check ChatGPT's rank in one category (US iOS Productivity).
af store app-ranks 336744124021 --category-ids=6007 --countries=US

af 存储上图

af store top-charts [flags]

在给定的国家和类别分类图中列出顶端应用程序,并列出当前位置和日常三角洲.

选项

• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)
• --category-id 需要的整数。 类别ID来自 store categories。 。 。 .
• --subtype 字符串, 默认 free. 类别子类型(类别内的图表变体).
• --date 绳子。 快照日期(YYY-MM-DD,默认为当前).
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Find the Games category, then pull its US chart.
af store categories --q=games
af store top-charts --country=US --category-id=6014

# List top paid apps on the US App Store.
af store top-charts --country=US --category-id=25204 --subtype=paid

# List top free apps on the Japan App Store.
af store top-charts --country=JP --category-id=25204

# List top free apps on Google Play in the US.
af store top-charts --country=US --category-id=100

# List top free apps on the US App Store in December 2025.
af store top-charts --country=US --category-id=25204 --date=2025-12-01

af 存储类别

af store categories [flags]

列出每个存储类别及其ID。 所需数字类ID store app-ranks --category-ids 财务报告和审定财务报表 store top-charts --category-id 这里有.

选项

• --count 整数, 默认 50。返回的结果数量.
• --page 整数, 默认 1。页码.
• --q 绳子。 过滤器由 name。 。 。 .
• --sort 绳子。 田地来排序。 何时按相关性排序 q 设置,否则列表顺序.
• --order 字符串, 默认 desc排序方向.
• --category-id 整数[]. 只返回这些类别ID.
• --parent-id 整数。 仅包括此父类的子类(由 id 来打倒).
• --storefront 字符串[]. 仅包括这些商店前端的类别(如:. apple:ios, (中文(简体) ), google_play) (中文(简体) ).
• --device-type 字符串[]. 只包括这些设备类型的类别(例如. handheld, (中文(简体) ), tablet) (中文(简体) ).
• --all 布尔, 默认值 false,包括非排名的商店(roku,vizio等). 这些有类别,但没有等级数据.

实例

# Find the Games category.
af store categories --q=games

# List every Apple iOS category.
af store categories --storefront=apple:ios

# List subcategories of a parent category (here, Apple Games).
af store categories --parent-id=6014

# Include categories from non-rank-supporting stores (e.g. Roku, Vizio) (not common).
af store categories --all

af 存储功能

af store featured <app-id> [flags]

应用程序或商店前期产品的专栏和编辑位置。 只请求摘要统计的0行.

选项

• <app-id> 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.
• --countries 字符串[]. 拟包括的国家。 仅询问美国,或通过多个来比较市场。 包括每个国家,设定 --all-countries 换句话说.
• --all-countries 布尔, 默认值 false包括每个国家。 无法结合 --countries。 。 。 .
• --include-rank-trend 布尔, 默认值 false。包括每个职位的每个间隔级别.
• --sort 字符串, 默认 relevance按相关性或日期排序位置.
• --order 字符串, 默认 desc排序方向.
• --start 绳子。 开始日期( YYYY- MM- DD)
• --end 绳子。 结束日期(YYY-MM-DD,默认为今天). 间谍最多31天.
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# List Minecraft's recent featured placements (unified app).
af store featured ua_X7iNgb

# List Minecraft's recent featured placements on one storefront.
af store featured 10157213

# Compare Minecraft's placement coverage across the US, UK, and Japan.
af store featured ua_X7iNgb --countries=US,GB,JP

# List Minecraft's placements during a specific month (December 2025).
af store featured ua_X7iNgb --start=2025-12-01 --end=2025-12-31

# List Minecraft's placements with rank history.
af store featured ua_X7iNgb --include-rank-trend

# List Minecraft's placements sorted by end date, newest run first.
af store featured ua_X7iNgb --sort=date --order=desc

# Get Minecraft's placement summary only.
af store featured ua_X7iNgb --count=0

af 存储应用程序列表

af store app-listing <product-id> [flags]

读取一个商店前端的完整商店列表:本地化文本(名称,字幕,描述,发行注释)外加截图,视频,分类,货币化,支持设备,国家可用性,价格,收视率,文件大小,以及年龄评级. 取一个数字产品ID(一次一个商店前门;一个统一的应用程序每个商店前门有一个产品). 每个请求一个地方.

选项

• <product-id> 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 apps get '<unified-app-id>'。 。 。 .
• --language 绳子。 地语(如en, ja,zh-Hans),用于名称,字幕,描述,放出注释和截图. 默认为 en; 当请求的地址没有元数据时, 返回到第一个可用的地址 。 反应与决心的语言一致.
• --device-type 字符串, 默认 handheld. 与苹果应用相关. 为iPhone特定元数据选择手持设备,为iPad选择平板电脑,为Mac选择桌面等.

实例

# Read Minecraft's store listing.
af store app-listing 10157213

# Read Minecraft's Japanese-localized listing.
af store app-listing 10157213 --language=ja

# Read Minecraft's iPad screenshots.
af store app-listing 10157213 --device-type=tablet

af 受众人口统计

af audience demographics <app-id>

阅读一个应用的受众人口统计:估计年龄和性别的分解.

选项

• <app-id> 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.

实例

# Read Minecraft's audience across all its storefronts (unified app ID).
af audience demographics ua_X7iNgb

# Read Minecraft's audience on Google Play only (product ID).
af audience demographics 6938219

af 观众交叉使用

af audience cross-usage <app-id> [flags]

查找应用程序用户也使用的应用程序 .

选项

• <app-id> 需要的整数或字符串。 该应用程序的统一应用ID或产品ID.
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Find the apps ChatGPT's users also use (unified app ID).
af audience cross-usage ua_miTXv6

# Find the apps ChatGPT's users also use on the App Store only (product ID).
af audience cross-usage 336744124021

af 审查清单

af reviews list [flags]

阅读一个或多个应用程序的个别评论. 返回审查文本、星标、国家、应用程序版本以及您的回复。 按恒星评级,日期范围,国家,版本,响应状态,以及跟踪关系可过滤.

选项

• --stars 编号[]。 按恒星评分过滤.
• --versions 字符串[]. 通过应用版本过滤. 传多相以合.
• --countries 字符串[]. 过滤到一个或多个ISO国家代码(如美国,JP,GB).
• --q 绳子。 搜索审查标题和正文. 传出多个关键字以匹配任意一个 。 对大小写不敏感;与其他过滤器结合.
• --response-status 绳子。 通过是否响应过滤 。 同意包括所有评论.
• --sort 绳子。 按审查日期或星等排序.
• --order 字符串, 默认 desc排序方向.
• --filter-apps-by-id (整数或弦) [. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 filterAppsBy* 设置时键。 Storefront, source, 或type filters 更适合应用集.
• --filter-apps-by-storefront 字符串[]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
• --filter-apps-by-source 字符串[]. 通过跟踪关系来缩小账户的跟踪应用.
• --filter-apps-by-type 字符串[]. 将账户的跟踪应用 缩小到这些类型的产品.
• --start 绳子。 开始日期( YYYY- MM- DD)
• --end 绳子。 结束日期( YYYY- MM- DD, 默认为今天)
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1号码是1 -500.

实例

# Read Minecraft's recent reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb

# Read Minecraft's 5-star reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb --stars=5

# Compare Minecraft's reviews across the US, Japan, and the UK.
af reviews list --filter-apps-by-id=ua_X7iNgb --countries=US,JP,GB

# Read Minecraft's December 2025 reviews.
af reviews list --filter-apps-by-id=ua_X7iNgb --start=2025-12-01 --end=2025-12-31

# Page through long results across your own apps.
af reviews list --filter-apps-by-source=own --count=50 --page=2

# Find your 1-2 star reviews without a response.
af reviews list --filter-apps-by-source=own --stars=1,2 --response-status=without_response

af 审查细目

af reviews breakdown [flags]

一个或数个应用软件的汇总审查按尺寸计算。 返回每维值一个计数,加上一组对应的全局总数.

选项

• --stars 编号[]。 按恒星评分过滤.
• --versions 字符串[]. 通过应用版本过滤. 传多相以合.
• --countries 字符串[]. 过滤到一个或多个ISO国家代码(如美国,JP,GB).
• --q 绳子。 搜索审查标题和正文. 传出多个关键字以匹配任意一个 。 对大小写不敏感;与其他过滤器结合.
• --response-status 绳子。 通过是否响应过滤 。 同意包括所有评论.
• --filter-apps-by-id (整数或弦) [. 只包括特定应用软件的数据,通过产品ID或统一应用ID. 以其他为准 filterAppsBy* 设置时键。 Storefront, source, 或type filters 更适合应用集.
• --filter-apps-by-storefront 字符串[]. 将账户的跟踪应用缩小到这些店面上的那些(如:苹果:ios,google play).
• --filter-apps-by-source 字符串[]. 通过跟踪关系来缩小账户的跟踪应用.
• --filter-apps-by-type 字符串[]. 将账户的跟踪应用 缩小到这些类型的产品.
• --start 绳子。 开始日期( YYYY- MM- DD)
• --end 绳子。 结束日期( YYYY- MM- DD, 默认为今天)
• --by 字符串[]. 限制这些维度的响应; 省略返回全部 .
• --top 整数, 默认 20。每个维度返回的最大值;其余值在 __other__。 。 。 .

实例

# Break down Minecraft's recent reviews.
af reviews breakdown --filter-apps-by-id=ua_X7iNgb

# Where are Minecraft's biggest fans writing from?
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --stars=5

# Count Minecraft's December 2025 5-star reviews.
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --stars=5 --start=2025-12-01 --end=2025-12-31

# How many Minecraft reviewers raved?
af reviews breakdown --filter-apps-by-id=ua_X7iNgb --q='love amazing fun great best'

# Compare review volume across your own apps.
af reviews breakdown --filter-apps-by-source=own

af 审查答复

af reviews reply <review-id> [flags]

发送或撤回特定审查的开发者回复. 过 content 调出; 通过 delete: true 撤回先前的回复.

选项

• <review-id> 需要字符串。 进行审查以采取行动。 使用 review_id 从 reviews list。 。 。 .
• --content 绳子。 开发者想要发布的响应文本 .
• --delete 布尔。 撤回先前就这次审查作出的答复。 相互独占 content。 。 。 .

实例

# Reply to a low-star review after shipping a fix.
af reviews reply rev123 --content='We just shipped a fix in v2.1. Let us know if you still see this.'

# Withdraw a previously-posted response.
af reviews reply rev123 --delete

af 有机关键词

af keywords organic [flags]

请检查access-date=中的日期值 (帮助) 有机关键词 一个或多个应用名列前茅 位置 受欢迎度 竞争力.

选项

• --product-ids 整数[]. 产品标识符(数字,各一库).
• --countries 需要字符串[]。 一个或多个ISO国家代码(例如美国,JP,GB). 传几回去比较市场.
• --device-type 绳子。 设备类型
• --count 整数, 默认 10. 返回的结果数量(分10分).
• --page 整数, 默认 1。页码.

实例

# Check ChatGPT's current US keyword rankings.
af keywords organic --product-ids=336744124021 --countries=US

# Check ChatGPT's iPad-only keyword rankings.
af keywords organic --product-ids=336744124021 --countries=US --device-type=tablet

# Compare ChatGPT and Gemini's US keyword rankings.
af keywords organic --product-ids=336744124021,337217072531 --countries=US

af 已支付的关键字

af keywords paid <product-ids> [flags]

列出付费关键字 一个或多个应用程序运行广告, 并带有印象共享和有机排序 .

选项

• <product-ids> 需要的整数。 产品标识符(数字,各一库).
• --days 整数, 默认 180数天的回顾期 常见值:7,14,30,90,180,365.
• --countries 需要字符串[]。 一个或多个ISO国家代码(例如美国,JP,GB). 传几回去比较市场.
• --device-types 字符串[]. 按设备类型过滤 。 默认为手持设备 .
• --count 整数, 默认 10. 返回的结果数量(分10分).
• --page 整数, 默认 1。页码.

实例

# Find Headspace's US paid keywords.
af keywords paid 15250929 --countries=US

# Compare Headspace's and Calm's US paid keywords.
af keywords paid 15250929,304554144 --countries=US

# Find Headspace's paid keywords across the US, UK, and Japan.
af keywords paid 15250929 --countries=US,GB,JP

# Find Headspace's US iPad paid keywords.
af keywords paid 15250929 --countries=US --device-types=tablet

# Check Headspace's US paid keywords over the last 30 days.
af keywords paid 15250929 --countries=US --days=30

af 关键词跟踪排名

af keywords tracked-ranks <product-id> [flags]

查看您所有履带关键词在单个app+country组合中的排名, 每个关键词的当前位置, 自上次改变以来的移动, 起始位置, 受欢迎度, 以及竞争力 .

选项

• <product-id> 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 apps get '<unified-app-id>'。 。 。 .
• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)
• --device-type 绳子。 读取顺序的设备 。 关闭使用商店默认值 .
• --count 整数, 默认 10. 返回的结果数量(分10分).
• --page 整数, 默认 1。页码.
• --sort 绳子。 现场命令结果由.
• --order 字符串, 默认 desc排序方向.
• --start 绳子。 窗口启动(YYY-MM-DD). 关闭最近7天的射程;起跑日期的军衔为起跑位置基线.
• --end 绳子。 窗口结束(YYY-MM-DD,默认为今天). 间谍最多31天.
• --keyword-term 绳子。 只包括含有此文本的有轨关键词.
• --min-position 整数。 最佳军衔包括(1=上等).
• --max-position 整数。 最差的军衔.
• --min-popularity 整数。 最低的受欢迎程度包括(0-100).
• --max-popularity 整数。 最受欢迎的包括(0-100).
• --min-competitiveness 整数。 竞争力最低,包括(0-100).
• --max-competitiveness 整数。 包括的竞争力最高(0-100).

实例

# Check how ChatGPT's tracked keywords are ranking.
af keywords tracked-ranks 336744124021 --country=US

# List ChatGPT's best-ranking keywords first.
af keywords tracked-ranks 336744124021 --country=US --sort=position --order=asc

# Show only the keywords ChatGPT ranks in the top 10.
af keywords tracked-ranks 336744124021 --country=US --max-position=10

# Find the most-searched keywords ChatGPT should prioritize.
af keywords tracked-ranks 336744124021 --country=US --sort=popularity --min-popularity=50

# Trace ChatGPT's keyword movement across a custom week.
af keywords tracked-ranks 336744124021 --country=US --start=2026-01-06 --end=2026-01-12

# Page through a long tracked keyword set.
af keywords tracked-ranks 336744124021 --country=US --page=2

af 跟踪趋势的关键词

af keywords tracked-trend <keyword-id> [flags]

追踪单个app+country组合中一个关键词的分级如何随时间变化. 每一点都给出了从前作起它所移动的级别和多少位置.

选项

• <keyword-id> 需要字符串。 关键词要追踪。 必须追踪这个应用程序和国家;其不透明的ID来自 keywords tracked-ranks 或者说 keywords tracked。 。 。 .
• --product-id 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 apps get '<unified-app-id>'。 。 。 .
• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)
• --device-type 绳子。 读取顺序的设备 。 关闭使用商店默认值 .
• --granularity 字符串, 默认 daily. 采样率.
• --start 绳子。 窗口启动(YYY-MM-DD). 过去7天的射程.
• --end 绳子。 窗口结束(YYY-MM-DD,默认为今天). 每小时颗粒量最多14天,每天31天.

实例

# Find a tracked keyword, then trace its rank day by day.
af keywords tracked-ranks 336744124021 --country=US
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US

# Trace a keyword's rank for ChatGPT across a specific week.
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US --start=2026-01-06 --end=2026-01-12

# Trace a keyword hour by hour.
af keywords tracked-trend 00f2b1ead3a0990b818517356cb40280 --product-id=336744124021 --country=US --granularity=hourly

af 关键词建议

af keywords suggestions <product-id> [flags]

发现关键词想法,以考虑锁定一个单一的app+country 组合,按照与该应用程序的关联性排序,并包括一些取自与您竞争的应用程序. 每个都伴随着它的受欢迎度,竞争力,以及应用的当前级别.

选项

• <product-id> 需要的整数。 一个店面的数字产品ID。 不是统一的应用ID。 成员产值 id值来自 apps get '<unified-app-id>'。 。 。 .
• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)
• --device-type 绳子。 读取顺序的设备 。 关闭使用商店默认值 .
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Discover keywords ChatGPT should consider targeting.
af keywords suggestions 336744124021 --country=US

# Find keyword ideas for ChatGPT in Japan.
af keywords suggestions 336744124021 --country=JP

# Pull a broader set of suggestions.
af keywords suggestions 336744124021 --country=US --count=50

af 关键词排序应用程序

af keywords ranking-apps <keyword-term> [flags]

列出应用程序在有机搜索中特定关键词的排名,并加上关键词本身的受欢迎度和竞争力分数.

选项

• <keyword-term> 需要字符串。 举起手来.
• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)
• --storefront 需要字符串。 App商店平台(如:苹果:ios,google play,amazon appstore,蒸汽,窗口10,苹果:mac,苹果:tv,苹果:imesage,或另一个被支持的商店前端).
• --device-type 绳子。 设备类型
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Find US iOS apps ranking for "fitness".
af keywords ranking-apps fitness --country=US --storefront=apple:ios

# Find Google Play apps ranking for "fitness".
af keywords ranking-apps fitness --country=US --storefront=google_play

# Find US iPad apps ranking for "meditation".
af keywords ranking-apps meditation --country=US --storefront=apple:ios --device-type=tablet

af 关键词广告商

af keywords advertisers <keyword-term> [flags]

列出特定关键字的应用广告,并列出每个广告商的印象分享,有机排名,以及他们投标的时间.

选项

• <keyword-term> 需要字符串。 寻找广告商的关键词
• --days 整数, 默认 180数天的回顾期 常见值:7,14,30,90,180,365.
• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)
• --device-type 绳子。 设备类型
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Find US apps advertising on the "notion" brand.
af keywords advertisers notion --country=US

# Find US iPad apps advertising on "meditation".
af keywords advertisers meditation --country=US --device-type=tablet

# Find US apps advertising on "fitness" over the last 30 days.
af keywords advertisers fitness --country=US --days=30

af 关键词

af keywords related <keyword-term> [flags]

查找与ASO研究的种子名词相關的关键词. 用于寻找具有类似受众的更受欢迎或竞争力更弱的替代品.

选项

• <keyword-term> 需要字符串。 有种子关键字可以找到相关的名词.
• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)
• --storefront 需要字符串。 App商店平台(如:苹果:ios,google play,amazon appstore,蒸汽,窗口10,苹果:mac,苹果:tv,苹果:imesage,或另一个被支持的商店前端).
• --device-type 绳子。 设备类型
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# Find US iOS keywords related to "fitness".
af keywords related fitness --country=US --storefront=apple:ios

# Find US Google Play keywords related to "fitness".
af keywords related fitness --country=US --storefront=google_play

# Find US iPad keywords related to "meditation".
af keywords related meditation --country=US --storefront=apple:ios --device-type=tablet

af 跟踪关键字

af keywords tracked [flags]

列出带有不透明身份的跟踪关键词.

选项

• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.
• --q 绳子。 过滤器由 keyword_term。 。 。 .
• --sort 绳子。 田地来排序。 何时按相关性排序 q 设置,否则列表顺序.
• --order 字符串, 默认 desc排序方向.
• --include-relationships 布尔, 默认值 false。包含每个行(产品、国家)的跟踪细节和同步状态。 默认关闭; 每对有轨电车( 产品, 国家) 添加一个嵌入区块 .

实例

# List every tracked keyword.
af keywords tracked

# Search tracked keywords for "fitness".
af keywords tracked --q=fitness

# List the most-recently-tracked keywords first.
af keywords tracked --sort=added_on

# Show each keyword's tracking and sync detail.
af keywords tracked --include-relationships

af 关键字跟踪

af keywords track <keyword-term> [flags]

追踪一个关键词,以监视您的应用程序的小时级别,并当其位置移动时获得自动警报.

选项

• <keyword-term> 需要字符串。 开始跟踪的关键字
• --product-id 需要的整数。 用于跟踪关键字的应用程序产品ID
• --country 需要字符串。 ISO 国家代码(例如美国,JP,GB)

实例

# Start tracking "meditation" for one of your apps in the US.
af keywords track meditation --product-id=336744124021 --country=US

# Track "workout" in Japan.
af keywords track workout --product-id=336744124021 --country=JP

af 关键字未跟踪

af keywords untrack <keyword-id>

停止跟踪关键字 .

选项

• <keyword-id> 需要字符串。 跟踪关键字行的标识符(由 keywords tracked) (中文(简体) ). 不是关键词文本.

实例

# Stop tracking a keyword.
af keywords untrack a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

af 苹果组织

af apple-ads organizations [flags]

列出您管理的 Apple Ads 组织, 以及每个人的货币和时区.

选项

• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# List all the Apple Ads organizations you manage.
af apple-ads organizations

苹果宣传运动

af apple-ads campaigns [flags]

列出您的 Apple Ads 活动, 包括每个人的状态、预算、目标国家以及时间表.

选项

• --display-status 绳子。 过滤到一个状态的运动 。 包括所有状态.
• --name 绳子。 过滤到名称包含此文本的活动 .
• --countries 字符串[]. 过滤针对其中任何一个国家的活动.
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# List all your Apple Ads campaigns.
af apple-ads campaigns

# List only your running campaigns.
af apple-ads campaigns --display-status=running

# Search your campaigns by name.
af apple-ads campaigns --name=Brand

# List campaigns targeting the US or UK.
af apple-ads campaigns --countries=US,GB

af-ads 广告组

af apple-ads ad-groups [campaign-id] [flags]

列出苹果 广告组 每人的默认出价,CPA上限,定价模式,和时间表.

选项

• [campaign-id] 绳子。 在一个运动中,广告团体的范围.
• --display-status 绳子。 过滤到一个状态的广告组 。 包括所有状态.
• --name 绳子。 过滤到名称包含此子字符串的广告组 .
• --count 整数, 默认 10。返回的结果数量.
• --page 整数, 默认 1。页码.

实例

# List all your ad groups across every campaign.
af apple-ads ad-groups

# List the ad groups in one campaign.
af apple-ads ad-groups aac_W9YthU

af apple-ads 关键词

af apple-ads keywords <campaign-id> [flags]

列出一个运动的竞价关键词,并列出每个关键词的性能(印象,相接,安装,花费,成本-每个安装)在一个日期范围内,加上它的匹配类型,出价,以及它是否是目标或负词.

选项

• <campaign-id> 需要字符串。 竞技队的竞技关键词.
• --ad-group-id 绳子。 过滤到一个广告组中的关键字 .
• --status 绳子。 过滤到一个状态的关键字 。 包括所有状态.
• --match-type 绳子。 过滤到一个匹配类型 。 把两者都包括在内.
• --name 绳子。 过滤到其文本包含此子字符串的关键字 .
• --sort 绳子。 按性能指标或出价顺序排列关键词. 先说最新消息.
• --order 字符串, 默认 desc。 。