{ "openapi": "3.1.0", "info": { "title": "APK API", "version": "1.0.0", "description": "Google Play data API: 4 million apps (live and removed), developers, new releases, removals and title keywords. JSON, UTF-8, CORS enabled.\n\nEvery call costs 0–3 tokens regardless of the number of rows (up to 100); /apps costs 1 token per app. Monthly free tokens are used first, then the purchased balance; if a request fails on our side, the tokens are returned. Remaining tokens are in the `_tokens` field of every response; `_credits` is a deprecated alias.\n\nDocumentation: https://apkapi.com/api-docs.php", "contact": { "url": "https://apkapi.com/api-docs.php" }, "termsOfService": "https://apkapi.com/legal/terms.php" }, "servers": [ { "url": "https://apkapi.com/api/v1" } ], "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "tags": [ { "name": "应用" }, { "name": "开发者" }, { "name": "商店变动" }, { "name": "市场" } ], "paths": { "/account": { "get": { "operationId": "account", "tags": [ "Account" ], "summary": "Your plan, token balance, the monthly reset date and the per-minute limit.", "description": "Free: no tokens are charged.", "responses": { "200": { "$ref": "#/components/responses/Ok" }, "401": { "$ref": "#/components/responses/Error" } } } }, "/app": { "get": { "operationId": "app", "tags": [ "应用" ], "summary": "完整的应用详情：标题、描述、“新功能”、安装量（档位与确切数值）、评分、评分与评论数量、星级分布、价格、应用内购买、广告、类别、内容分级、版本、最低 Android 版本、发布与更新日期、图标、截图、视频、开发者及其网站。对于已下架应用：最后保存的数据和下架日期。", "description": "完整的应用详情：标题、描述、“新功能”、安装量（档位与确切数值）、评分、评分与评论数量、星级分布、价格、应用内购买、广告、类别、内容分级、版本、最低 Android 版本、发布与更新日期、图标、截图、视频、开发者及其网站。对于已下架应用：最后保存的数据和下架日期。\n\nCost: 1 token per call.", "x-tokens": 1, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "应用包名", "schema": { "type": "string" }, "example": "com.whatsapp" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/apps": { "get": { "operationId": "apps", "tags": [ "应用" ], "summary": "一次请求最多 100 个应用：GET ?ids=a,b,c，或在请求体中以列表 POST（每行一个，或 JSON {\"ids\": […]}）。每个应用 1 个令牌；未找到的 ID 会在 not_found 中返回。", "description": "一次请求最多 100 个应用：GET ?ids=a,b,c，或在请求体中以列表 POST（每行一个，或 JSON {\"ids\": […]}）。每个应用 1 个令牌；未找到的 ID 会在 not_found 中返回。\n\nCost: 1 token per app.", "x-tokens": 1, "parameters": [ { "name": "ids", "in": "query", "required": true, "description": "包名，以逗号分隔，最多 100 个", "schema": { "type": "string" }, "example": "com.whatsapp,org.telegram.messenger" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "apps_post", "tags": [ "应用" ], "summary": "Same as GET, with package names in the request body (one per line, or JSON {\"ids\": [...]}).", "description": "一次请求最多 100 个应用：GET ?ids=a,b,c，或在请求体中以列表 POST（每行一个，或 JSON {\"ids\": […]}）。每个应用 1 个令牌；未找到的 ID 会在 not_found 中返回。\n\nCost: 1 token per app.", "x-tokens": 1, "parameters": [], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } }, "requestBody": { "required": true, "content": { "text/plain": { "schema": { "type": "string" }, "example": "com.whatsapp\norg.telegram.messenger" } } } } }, "/search": { "get": { "operationId": "search", "tags": [ "应用" ], "summary": "在整个数据库中搜索和筛选。至少需要一个筛选条件。不带 q 时按安装量排序。", "description": "在整个数据库中搜索和筛选。至少需要一个筛选条件。不带 q 时按安装量排序。\n\nCost: 2 tokens per call.", "x-tokens": 2, "parameters": [ { "name": "q", "in": "query", "required": false, "description": "在标题、描述和开发者名称中搜索的词语", "schema": { "type": "string" }, "example": "photo editor" }, { "name": "category", "in": "query", "required": false, "description": "类别 ID，例如 GAME_PUZZLE（见 /v1/categories）", "schema": { "type": "string" } }, { "name": "developer_id", "in": "query", "required": false, "description": "Google Play 开发者 ID", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "最低安装量（Google Play 档位：1000、10000…）", "schema": { "type": "integer", "minimum": 0 } }, { "name": "max_installs", "in": "query", "required": false, "description": "最大安装量", "schema": { "type": "integer", "minimum": 0 } }, { "name": "min_score", "in": "query", "required": false, "description": "最低评分，0–5", "schema": { "type": "string" } }, { "name": "min_ratings", "in": "query", "required": false, "description": "最少评分数", "schema": { "type": "integer", "minimum": 0 } }, { "name": "free", "in": "query", "required": false, "description": "true — 仅免费，false — 仅付费", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "ads", "in": "query", "required": false, "description": "true — 含广告，false — 无广告", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "iap", "in": "query", "required": false, "description": "true — 含应用内购买", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "lang", "in": "query", "required": false, "description": "标题语言，ISO 代码：en、de、pt…", "schema": { "type": "string" } }, { "name": "released_from", "in": "query", "required": false, "description": "发布于该日期起，YYYY-MM-DD", "schema": { "type": "string" } }, { "name": "released_to", "in": "query", "required": false, "description": "发布于该日期（含）之前", "schema": { "type": "string" } }, { "name": "updated_from", "in": "query", "required": false, "description": "更新于该日期起", "schema": { "type": "string" } }, { "name": "updated_to", "in": "query", "required": false, "description": "更新于该日期（含）之前", "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "description": "live（在商店中，默认）、removed 或 all", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "desc | asc", "schema": { "type": "string", "enum": [ "desc", "asc" ] } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/suggest": { "get": { "operationId": "suggest", "tags": [ "应用" ], "summary": "按标题开头联想：10 个最热门的匹配项。免费。", "description": "按标题开头联想：10 个最热门的匹配项。免费。\n\nCost: 0 tokens per call.", "x-tokens": 0, "parameters": [ { "name": "q", "in": "query", "required": true, "description": "标题开头，至少 2 个字符", "schema": { "type": "string" }, "example": "whats" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/developer": { "get": { "operationId": "developer", "tags": [ "开发者" ], "summary": "开发者及其全部应用：数量（在架与已下架）、总安装量、平均评分、首次发布、类别、网站。Business 套餐还包含邮箱、电话、地址和法定名称。", "description": "开发者及其全部应用：数量（在架与已下架）、总安装量、平均评分、首次发布、类别、网站。Business 套餐还包含邮箱、电话、地址和法定名称。\n\nCost: 2 tokens per call.", "x-tokens": 2, "parameters": [ { "name": "id", "in": "query", "required": false, "description": "开发者 ID（来自应用详情：developer.id）", "schema": { "type": "string" }, "example": "5191370068110375942" }, { "name": "name", "in": "query", "required": false, "description": "或开发者的确切名称", "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "description": "all（默认）、live 或 removed", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/new": { "get": { "operationId": "new", "tags": [ "商店变动" ], "summary": "按首次发布日期排列的新应用，最新的在前。", "description": "按首次发布日期排列的新应用，最新的在前。\n\nCost: 2 tokens per call.", "x-tokens": 2, "parameters": [ { "name": "since", "in": "query", "required": false, "description": "起始日期，YYYY-MM-DD（默认 7 天前）", "schema": { "type": "string" } }, { "name": "until", "in": "query", "required": false, "description": "截至该日期（含）", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "类别 ID，例如 GAME_PUZZLE（见 /v1/categories）", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "最低安装量（Google Play 档位：1000、10000…）", "schema": { "type": "integer", "minimum": 0 } }, { "name": "lang", "in": "query", "required": false, "description": "标题语言，ISO 代码：en、de、pt…", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/removed": { "get": { "operationId": "removed", "tags": [ "商店变动" ], "summary": "已从 Google Play 下架的应用（在我们检查的 19 个国家中均不存在），按下架日期排序。应用详情保留最后的数据。", "description": "已从 Google Play 下架的应用（在我们检查的 19 个国家中均不存在），按下架日期排序。应用详情保留最后的数据。\n\nCost: 2 tokens per call.", "x-tokens": 2, "parameters": [ { "name": "since", "in": "query", "required": false, "description": "起始日期，YYYY-MM-DD（默认 7 天前）", "schema": { "type": "string" } }, { "name": "until", "in": "query", "required": false, "description": "截至该日期（含）", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "类别 ID，例如 GAME_PUZZLE（见 /v1/categories）", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "最低安装量（Google Play 档位：1000、10000…）", "schema": { "type": "integer", "minimum": 0 } }, { "name": "sort", "in": "query", "required": false, "description": "removed_at | installs | score", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/keywords": { "get": { "operationId": "keywords", "tags": [ "市场" ], "summary": "按语言分别统计的应用标题词语和短语：使用它们的应用数和开发者数、其中强势应用（10 万+ 安装量）的数量、总安装量、头部应用占比以及机会评分（opportunity）。", "description": "按语言分别统计的应用标题词语和短语：使用它们的应用数和开发者数、其中强势应用（10 万+ 安装量）的数量、总安装量、头部应用占比以及机会评分（opportunity）。\n\nCost: 2 tokens per call.", "x-tokens": 2, "parameters": [ { "name": "lang", "in": "query", "required": false, "description": "语言，默认 en", "schema": { "type": "string" }, "example": "en" }, { "name": "q", "in": "query", "required": false, "description": "词语或短语", "schema": { "type": "string" }, "example": "vpn" }, { "name": "phrase", "in": "query", "required": false, "description": "true — 仅两个词的短语，false — 仅单个词", "schema": { "type": "string", "enum": [ "true", "false" ] } }, { "name": "min_apps", "in": "query", "required": false, "description": "最少应用数", "schema": { "type": "integer", "minimum": 0 } }, { "name": "max_apps", "in": "query", "required": false, "description": "最大应用数", "schema": { "type": "integer", "minimum": 0 } }, { "name": "sort", "in": "query", "required": false, "description": "opportunity | apps | installs | strong | devs | max_installs", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "desc | asc", "schema": { "type": "string", "enum": [ "desc", "asc" ] } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/categories": { "get": { "operationId": "categories", "tags": [ "市场" ], "summary": "全部类别，含应用数量和总安装量。免费。", "description": "全部类别，含应用数量和总安装量。免费。\n\nCost: 0 tokens per call.", "x-tokens": 0, "parameters": [ { "name": "status", "in": "query", "required": false, "description": "live（在商店中，默认）、removed 或 all", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/free_domains": { "get": { "operationId": "free_domains", "tags": [ "市场" ], "summary": "开发者网站域名可注册的应用，附带应用热度。首次购买令牌后开放。", "description": "开发者网站域名可注册的应用，附带应用热度。首次购买令牌后开放。\n\nCost: 3 tokens per call. Opens after the first token purchase.", "x-tokens": 3, "parameters": [ { "name": "category", "in": "query", "required": false, "description": "类别 ID，例如 GAME_PUZZLE（见 /v1/categories）", "schema": { "type": "string" } }, { "name": "min_installs", "in": "query", "required": false, "description": "最低安装量（Google Play 档位：1000、10000…）", "schema": { "type": "integer", "minimum": 0 } }, { "name": "status", "in": "query", "required": false, "description": "live（在商店中，默认）、removed 或 all", "schema": { "type": "string", "enum": [ "live", "removed", "all" ] } }, { "name": "tld", "in": "query", "required": false, "description": "域名后缀，例如 com", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "description": "relevance | installs | real_installs | score | ratings | reviews | released | updated | price", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/charts": { "get": { "operationId": "charts", "tags": [ "市场" ], "summary": "Google Play 某一国家和类别的热门榜单：最多 200 个名次，相对上一次快照的名次变化（change：上升的名次数，\"new\" 表示新上榜）、图标和安装量。", "description": "Google Play 某一国家和类别的热门榜单：最多 200 个名次，相对上一次快照的名次变化（change：上升的名次数，\"new\" 表示新上榜）、图标和安装量。\n\nCost: 2 tokens per call.", "x-tokens": 2, "parameters": [ { "name": "country", "in": "query", "required": true, "description": "国家，ISO 代码：US、DE、BR…", "schema": { "type": "string" }, "example": "US" }, { "name": "category", "in": "query", "required": true, "description": "类别，例如 GAME_PUZZLE", "schema": { "type": "string" }, "example": "GAME_PUZZLE" }, { "name": "collection", "in": "query", "required": false, "description": "free | paid | grossing", "schema": { "type": "string", "enum": [ "free", "paid", "grossing" ] } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/rankings": { "get": { "operationId": "rankings", "tags": [ "市场" ], "summary": "应用在最新快照中所在的全部榜单：国家、类别、榜单类型、名次；以及榜单数量、国家数量和最佳名次。", "description": "应用在最新快照中所在的全部榜单：国家、类别、榜单类型、名次；以及榜单数量、国家数量和最佳名次。\n\nCost: 1 token per call.", "x-tokens": 1, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "应用包名", "schema": { "type": "string" }, "example": "com.whatsapp" }, { "name": "country", "in": "query", "required": false, "description": "仅限一个国家", "schema": { "type": "string" } }, { "name": "collection", "in": "query", "required": false, "description": "free | paid | grossing", "schema": { "type": "string", "enum": [ "free", "paid", "grossing" ] } } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/availability": { "get": { "operationId": "availability", "tags": [ "市场" ], "summary": "应用在 Google Play 中可用的国家（依据商店 sitemap 中的 hreflang）。如果超过 190 个国家，则返回 worldwide = true 而不附列表。", "description": "应用在 Google Play 中可用的国家（依据商店 sitemap 中的 hreflang）。如果超过 190 个国家，则返回 worldwide = true 而不附列表。\n\nCost: 1 token per call.", "x-tokens": 1, "parameters": [ { "name": "id", "in": "query", "required": true, "description": "应用包名", "schema": { "type": "string" }, "example": "com.whatsapp" } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/markets": { "get": { "operationId": "markets", "tags": [ "市场" ], "summary": "基于免费榜单的市场竞争度：进入前 100 名和前 200 名的门槛（该名次应用的安装量）、榜单中新应用（近 12 个月）和本地应用（≤3 个国家）的占比，以及本地市场规模。不带参数：所有国家；country：单个国家的各类别；category：所有国家中的单个类别。", "description": "基于免费榜单的市场竞争度：进入前 100 名和前 200 名的门槛（该名次应用的安装量）、榜单中新应用（近 12 个月）和本地应用（≤3 个国家）的占比，以及本地市场规模。不带参数：所有国家；country：单个国家的各类别；category：所有国家中的单个类别。\n\nCost: 1 token per call.", "x-tokens": 1, "parameters": [ { "name": "country", "in": "query", "required": false, "description": "国家，ISO 代码", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "类别 ID，例如 GAME_PUZZLE（见 /v1/categories）", "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "description": "entry100 | entry200 | new_share | local_share | local_apps | local_installs | local_new", "schema": { "type": "string" } }, { "name": "order", "in": "query", "required": false, "description": "desc | asc", "schema": { "type": "string", "enum": [ "desc", "asc" ] } }, { "name": "page", "in": "query", "required": false, "description": "页码，从 1 开始", "schema": { "type": "integer", "minimum": 1 } }, { "name": "per", "in": "query", "required": false, "description": "每页行数，1–100（默认 20）", "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "example": 20 } ], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/stats": { "get": { "operationId": "stats", "tags": [ "市场" ], "summary": "数据库规模：商店中的应用和已下架应用、开发者、7 天内新上架和已下架的数量、最近更新时间。免费。", "description": "数据库规模：商店中的应用和已下架应用、开发者、7 天内新上架和已下架的数量、最近更新时间。免费。\n\nCost: 0 tokens per call.", "x-tokens": 0, "parameters": [], "responses": { "200": { "$ref": "#/components/responses/Ok" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "402": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" }, "502": { "$ref": "#/components/responses/Error" }, "503": { "$ref": "#/components/responses/Error" } } } }, "/health": { "get": { "operationId": "health", "tags": [ "Account" ], "summary": "Service status. No key required.", "security": [], "responses": { "200": { "$ref": "#/components/responses/Ok" } } } } }, "components": { "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key" }, "BearerAuth": { "type": "http", "scheme": "bearer" } }, "schemas": { "Tokens": { "type": "object", "properties": { "cost": { "type": "integer", "description": "tokens this request cost" }, "remaining": { "type": "integer", "description": "tokens left (monthly + purchased)" } } }, "Ok": { "type": "object", "required": [ "ok" ], "additionalProperties": true, "properties": { "ok": { "type": "boolean", "const": true }, "results": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "total": { "type": "integer" }, "page": { "type": "integer" }, "per": { "type": "integer" }, "pages": { "type": "integer" }, "_tokens": { "$ref": "#/components/schemas/Tokens" }, "_credits": { "$ref": "#/components/schemas/Tokens", "deprecated": true } } }, "Error": { "type": "object", "required": [ "ok", "error", "code" ], "properties": { "ok": { "type": "boolean", "const": false }, "error": { "type": "string" }, "code": { "type": "string", "examples": [ "missing_api_key", "invalid_api_key", "account_blocked", "insufficient_credits", "rate_limited", "invalid_param", "invalid_request", "not_found", "upstream_error", "service_unavailable" ] } } } }, "responses": { "Ok": { "description": "Success", "headers": { "X-Cache": { "description": "HIT — served from cache, MISS — fresh query to the database", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } } }, "Error": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }