> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # 实时 Apple App 列表搜索结果 > 此端点将提供 App Store 上发布的应用列表及其他信息：其 ID、图标、评价数量、评分、价格以及... ## OpenAPI ````yaml openapi/zh/dataforseo.json POST /dataforseo/app_data/apple/app_listings/search/live openapi: 3.0.3 info: title: DataForSEO API version: 1.0.0 description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。 servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /dataforseo/app_data/apple/app_listings/search/live: post: summary: 实时 Apple App 列表搜索结果 description: >- 此端点将提供 App Store 中已发布应用的列表，以及应用 ID、图标、评论数、评分、价格及其他数据。结果取决于 API 请求中指定的 `title`、`description` 和 `categories` 参数。 operationId: post_dataforseo_app_data_apple_app_listings_search_live requestBody: required: false content: application/json: schema: type: object properties: categories: type: array items: type: string description: 应用类别；可选字段；指定的类别用于搜索应用列表；可通过此链接获取可用应用列表类别的完整清单；最多可指定 10 个类别 description: type: string description: 应用描述中的关键词，可选字段；指定应用描述中出现的关键词；最多可包含 200 个字符 title: type: string description: 应用标题中的关键词，可选字段；出现在应用标题中的关键词；最多可包含 200 个字符 filters: type: array items: type: string description: >- 结果过滤参数对象数组，可选字段。可以同时添加多个过滤器（最多 8 个）。应在条件之间设置逻辑运算符 and、or。支持以下运算符：regex、not_regex、 、 、>、>=、=、 、in、not_in、like、not_like。可以将 % 运算符与 like 和 not_like 配合使用，以匹配由零个或多个字符组成的任意字符串。示例：["rating.value",">",3]。可以通过向 https://api.dataforseo.com/v3/app_data/apple/app_listings/available_filters 单独发起请求来获取可用过滤器列表 order_by: type: array items: type: string description: >- 结果排序规则，可选字段。可以使用与 filters 数组中相同的值对结果进行排序。支持的排序类型：asc – 结果将按升序排列；desc – 结果将按降序排列。应使用逗号设置排序参数。示例：["item.rating.value,desc"]。请注意，单个请求最多可设置三条排序规则。多条排序规则应使用逗号分隔。示例：["item.rating.value,desc","item.rating.value,desc"] limit: type: integer description: 返回应用的最大数量，可选字段，默认值：100，最大值：1000 offset: type: integer description: >- 返回应用的结果数组偏移量；可选字段；默认值：0；如果指定值 10，结果数组中的前十个实体将被省略，并提供后续实体的数据；注意：我们建议仅在检索不超过 10,000 条结果时使用此参数；如需检索超过 10,000 条结果，请改用 offset_token。 offset_token: type: string description: >- 后续请求使用的 token 可选字段，在每次请求响应的相同字段中提供；尝试通过单次请求获取超过 100,000 条结果时，可使用此参数避免超时；通过指定响应数组中的唯一 offset_token 值，可以获取初始任务的后续结果；每个后续任务的 offset_token 值都是唯一的。注意：如果请求中指定了 offset_token，则所有其他参数都应与上一次请求相同。有关此参数的更多信息，请参阅我们的帮助中心 tag: type: string description: >- 用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值 responses: '200': description: 成功响应 content: application/json: schema: type: object properties: version: type: string description: API 的当前版本 status_code: type: integer description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况 status_message: type: string description: 常规信息消息；可在此处查看常规信息消息的完整列表 time: type: string description: 执行时间（秒） cost: type: number description: 任务总成本（美元） tasks_count: type: integer description: tasks 数组中的任务数量 tasks_error: type: integer description: tasks 数组中返回错误的任务数量 tasks: type: array items: type: string description: 任务数组 tasks.id: type: string description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符 tasks.status_code: type: integer description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看 tasks.status_message: type: string description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表 tasks.time: type: string description: 执行时间（秒） tasks.cost: type: number description: 任务成本（美元） tasks.result_count: type: integer description: 结果数组中的元素数量 tasks.path: type: array items: type: string description: URL 路径 tasks.data: type: object description: 包含您在 POST 请求中指定的相同参数 tasks.result: type: array items: type: string description: 结果数组 tasks.result.total_count: type: integer description: 数据库中相关结果的总数 tasks.result.count: type: integer description: results 数组中的项目数量 tasks.result.offset: type: integer description: 返回的应用结果数组中的偏移量 tasks.result.offset_token: type: string description: >- 用于后续请求的 token；您可以在 POST 请求中使用此参数，以避免尝试在单个请求中获取超过 100,000 条结果时发生超时 tasks.result.items: type: array items: type: string description: 应用及相关数据的数组 tasks.result.items.app_id: type: string description: 返回的应用 ID tasks.result.items.se_domain: type: string description: POST 数组中的搜索引擎域名 tasks.result.items.location_code: type: integer description: POST 数组中的位置代码 tasks.result.items.language_code: type: string description: POST 数组中的语言代码 tasks.result.items.check_url: type: string description: 搜索引擎结果的直接 URL，可用于确认我们提供的结果是否准确 tasks.result.items.time_update: type: string description: >- SERP 数据最后更新的日期和时间，采用 ISO 8601 格式：“YYYY-MM-DDThh:mm:ss.sssssssZ” 示例：2023-05-23 10:16:19 +00:00 tasks.result.items.item: type: object description: 应用的详细信息 tasks.result.items.item.type: type: string description: 项目类型，可能的项目类型："app_store_info_organic" tasks.result.items.item.rank_group: type: integer description: 在 type 值相同的元素组内的位置；type 值不同的元素位置不会计入 rank_group。 tasks.result.items.item.rank_absolute: type: integer description: 在所有列出应用中的绝对排名；在列表中所有应用中的绝对位置 tasks.result.items.item.position: type: string description: 元素在 SERP 中的对齐方式，可取以下值：left tasks.result.items.item.app_id: type: string description: 返回的应用 ID tasks.result.items.item.title: type: string description: 返回应用的标题 tasks.result.items.item.url: type: string description: App Store 上应用页面的 URL tasks.result.items.item.icon: type: string description: 应用图标的 URL tasks.result.items.item.description: type: string description: 返回应用的描述 tasks.result.items.item.reviews_count: type: integer description: 应用的评论总数 tasks.result.items.item.rating: type: object description: 应用的平均评分 tasks.result.items.item.rating.rating_type: type: string description: 评级类型可取以下值：Max5 tasks.result.items.item.rating.value: type: number description: 评级值 tasks.result.items.item.rating.votes_count: type: integer description: 在这种情况下，反馈数量的值将为 null tasks.result.items.item.rating.rating_max: type: integer description: rating_type 的最大值；Max5 的最大值为 5 tasks.result.items.item.price: type: object description: 应用价格 tasks.result.items.item.price.current: type: number description: 当前价格是指元素中所示的当前价格 tasks.result.items.item.price.regular: type: number description: 常规价格是指元素中标示的常规价格 tasks.result.items.item.price.max_value: type: number description: 最高价格是指元素中标示的最高价格 tasks.result.items.item.price.currency: type: string description: 所列价格的货币，即应用于该价格的货币 ISO 代码 tasks.result.items.item.price.is_price_range: type: boolean description: 价格以区间形式提供，指示价格是否以区间形式提供 tasks.result.items.item.price.displayed_price: type: string description: 结果中的价格字符串，即结果中提供的原始价格字符串 tasks.result.items.item.is_free: type: boolean description: 指示应用是否免费 tasks.result.items.item.main_category: type: string description: 应用类别，即与该应用最相关的 App Store 类别 tasks.result.items.item.categories: type: array items: type: string description: 与该应用相关的其他 App Store 应用类别列表 tasks.result.items.item.languages: type: array items: type: string description: 应用支持的语言 tasks.result.items.item.advisories: type: array items: type: string description: 应用建议分级和使用限制 tasks.result.items.item.developer: type: string description: 应用开发者的名称 tasks.result.items.item.developer_id: type: string description: App Store 上的开发者 ID tasks.result.items.item.developer_url: type: string description: App Store 开发者页面的 URL tasks.result.items.item.version: type: string description: 应用的当前版本 tasks.result.items.item.minimum_os_version: type: string description: 安装应用所需的最低 OS 版本 tasks.result.items.item.size: type: string description: 应用大小 tasks.result.items.item.released_date: type: string description: >- 应用发布的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：2019-11-15 12:57:46 +00:00 tasks.result.items.item.last_update_date: type: string description: >- 应用最后更新时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：2019-11-15 12:57:46 +00:00 tasks.result.items.item.update_notes: type: string description: update notes 包含开发者的最新更新说明 tasks.result.items.item.images: type: array items: type: string description: 应用图片，包含 App Store 应用页面上发布的图片 URL tasks.result.items.item.similar_apps: type: array items: type: string description: similar apps 显示 POST 请求中与指定应用相似的应用 tasks.result.items.item.similar_apps.app_id: type: string description: 应用 ID tasks.result.items.item.similar_apps.title: type: string description: 应用标题 tasks.result.items.item.similar_apps.url: type: string description: App Store 上应用页面的 URL tasks.result.items.item.more_apps_by_developer: type: array items: type: string description: similar apps 提供由同一开发者构建的应用信息 tasks.result.items.item.more_apps_by_developer.app_id: type: string description: 应用 ID tasks.result.items.item.more_apps_by_developer.title: type: string description: 应用标题 tasks.result.items.item.more_apps_by_developer.url: type: string description: App Store 上应用页面的 URL '400': description: 错误请求 '401': description: 未授权 '429': description: 超出速率限制 '500': description: 内部服务器错误 components: securitySchemes: BearerAuth: type: http scheme: bearer ````