# 商品评论 查询已收录的 Amazon 商品评论，可按日期、单个星级和购买验证筛选。评论可能属于同一 Listing 的其他变体，不触发实时采集。 ID: task:amazon_product_reviews_v1 · Region: cn · Status: available catalog_version: 5c920c774a55e44d7e8c709143b88a18b8b2afcef91a5d19a8c9ae5d565d9077 updated_at: 2026-10-21T12:06:16.523771+00:00 Amazon 历史数据以数据集发布版本定义覆盖周期；实时读取反映请求时资料，不保证覆盖全部记录。 Docs: https://docs.asklear.cn/capabilities/task%3Aamazon_product_reviews_v1 ## GET /v1/collections/tasks/amazon_product_reviews_v1 legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 执行遵循现有计价；读取公开说明不扣 Credits。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "properties": { "task_code": { "const": "amazon_product_reviews_v1" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "task_code" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" } ], "input_schema": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string", "ui_default": "" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" } } ``` - input_schema (object): 暂无字段说明 - examples (array): 暂无字段说明 ## describe_collection_task legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 执行遵循现有计价；读取公开说明不扣 Credits。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "properties": { "task_code": { "const": "amazon_product_reviews_v1" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "task_code" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" } ], "input_schema": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string", "ui_default": "" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" } } ``` - input_schema (object): 暂无字段说明 - examples (array): 暂无字段说明 ## asklear collection describe legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 执行遵循现有计价；读取公开说明不扣 Credits。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "properties": { "task_code": { "const": "amazon_product_reviews_v1" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "task_code" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" } ], "input_schema": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string", "ui_default": "" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" } } ``` - input_schema (object): 暂无字段说明 - examples (array): 暂无字段说明 ## POST /v1/collections/estimate legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 每个成功任务 49 Credits；启动前先估价。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "description": "Outer transport contract; each registered task validates its own input.", "properties": { "input": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" }, "task_code": { "const": "amazon_product_reviews_v1" } }, "required": [ "task_code", "input" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "input": { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" }, "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 49 } ``` - quote_token (string): 暂无字段说明 - upper_bound_credits (integer): 暂无字段说明 ## estimate_collection legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 每个成功任务 49 Credits；启动前先估价。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "description": "Outer transport contract; each registered task validates its own input.", "properties": { "input": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" }, "task_code": { "const": "amazon_product_reviews_v1" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "task_code", "input" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "input": { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" }, "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 49 } ``` - quote_token (string): 暂无字段说明 - upper_bound_credits (integer): 暂无字段说明 ## asklear collection estimate legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 每个成功任务 49 Credits；启动前先估价。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "description": "Outer transport contract; each registered task validates its own input.", "properties": { "input": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" }, "task_code": { "const": "amazon_product_reviews_v1" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "task_code", "input" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "input": { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" }, "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 49 } ``` - quote_token (string): 暂无字段说明 - upper_bound_credits (integer): 暂无字段说明 ## POST /v1/collections/jobs legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 每个成功任务 49 Credits；启动前先估价。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "properties": { "idempotency_key": { "maxLength": 128, "minLength": 1, "type": "string" }, "input": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" }, "max_credits": { "anyOf": [ { "exclusiveMinimum": 0, "type": "integer" }, { "type": "null" } ], "default": null }, "quote_token": { "maxLength": 4096, "minLength": 16, "type": "string" }, "task_code": { "const": "amazon_product_reviews_v1" } }, "required": [ "task_code", "input", "quote_token", "idempotency_key" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "idempotency_key": "directory-example", "input": { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" }, "quote_token": "quote-token-from-estimate", "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "job_id": "collection-example", "status": "queued" } ``` - job_id (string): 暂无字段说明 - status (string): 暂无字段说明 Follow up: GET /v1/collections/jobs/{job_id} Read job status and its saved public result. ## start_collection legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 每个成功任务 49 Credits；启动前先估价。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "properties": { "idempotency_key": { "maxLength": 128, "minLength": 1, "type": "string" }, "input": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" }, "max_credits": { "anyOf": [ { "exclusiveMinimum": 0, "type": "integer" }, { "type": "null" } ], "default": null }, "quote_token": { "maxLength": 4096, "minLength": 16, "type": "string" }, "task_code": { "const": "amazon_product_reviews_v1" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "task_code", "input", "quote_token", "idempotency_key" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "idempotency_key": "directory-example", "input": { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" }, "quote_token": "quote-token-from-estimate", "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "job_id": "collection-example", "status": "queued" } ``` - job_id (string): 暂无字段说明 - status (string): 暂无字段说明 Follow up: GET /v1/collections/jobs/{job_id} Read job status and its saved public result. ## asklear collection start legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 每个成功任务 49 Credits；启动前先估价。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "properties": { "idempotency_key": { "maxLength": 128, "minLength": 1, "type": "string" }, "input": { "additionalProperties": false, "properties": { "country": { "default": "US", "enum": [ "US", "GB", "DE", "FR", "IN", "CA", "JP", "ES", "IT", "MX", "AE", "AU", "BR", "SA" ], "type": "string" }, "page": { "default": 1, "maximum": 10000, "minimum": 1, "type": "integer" }, "product": { "maxLength": 2048, "minLength": 10, "type": "string" }, "since": { "default": "", "maxLength": 10, "type": "string" }, "star": { "default": "all", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string" }, "verified_purchase_only": { "default": "false", "enum": [ "false", "true" ], "type": "string" } }, "required": [ "product" ], "type": "object" }, "max_credits": { "anyOf": [ { "exclusiveMinimum": 0, "type": "integer" }, { "type": "null" } ], "default": null }, "quote_token": { "maxLength": 4096, "minLength": 16, "type": "string" }, "task_code": { "const": "amazon_product_reviews_v1" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "task_code", "input", "quote_token", "idempotency_key" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "idempotency_key": "directory-example", "input": { "country": "US", "page": 1, "product": "B08LYNQ8LC", "since": "2021-01-21", "star": "5" }, "quote_token": "quote-token-from-estimate", "task_code": "amazon_product_reviews_v1" } ``` ### Synthetic response / 合成响应 ```json { "job_id": "collection-example", "status": "queued" } ``` - job_id (string): 暂无字段说明 - status (string): 暂无字段说明 Follow up: GET /v1/collections/jobs/{job_id} Read job status and its saved public result. ## GET /v1/collections/jobs/{job_id} legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 执行遵循现有计价；读取公开说明不扣 Credits。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "properties": { "job_id": { "type": "string" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "job_id" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "job_id": "collection-example" } ``` ### Response schema / 响应契约 ```json { "$defs": { "Schema1": { "additionalProperties": false, "description": "The limited metadata safe to store and expose with a collection result.", "properties": { "api_name": { "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7e]+$", "type": "string" }, "credits_charged": { "maximum": 1000000, "minimum": 0, "type": "integer" }, "latency_ms": { "maximum": 120000, "minimum": 0, "type": "integer" }, "request_id": { "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7e]+$", "type": "string" } }, "required": [ "request_id", "api_name", "latency_ms", "credits_charged" ], "type": "object" } }, "additionalProperties": true, "properties": { "result": { "additionalProperties": false, "properties": { "data": { "additionalProperties": true, "type": "object" }, "meta": { "$ref": "#/$defs/Schema1" } }, "required": [ "data", "meta" ], "type": "object" } }, "type": "object" } ``` ### Synthetic response / 合成响应 ```json { "result": { "data": {}, "meta": { "api_name": "https://www.linkedin.com/in/example", "credits_charged": 0, "latency_ms": 0, "request_id": "https://www.linkedin.com/in/example" } }, "status": "succeeded" } ``` - result.meta.request_id (string): 用于追踪的 Asklear 请求 ID。 - result.meta.api_name (string): 实际执行的采集操作名称。 - result.meta.latency_ms (integer): 采集执行耗时（毫秒）。 - result.meta.credits_charged (integer): 任务完成后 Asklear 用户侧实际结算的 Credits。 - result.data.country (string): 国家站点：US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA，默认 US。接口声明支持不等于各国已完成实测。 - result.data.page (integer): 本次请求的页码，从 1 开始，一次调用只获取一页。 - result.data.next_page (integer|null): 保持国家和筛选条件，将此值作为 page 继续查询。搜索满页仅表示可尝试下一页，不保证还有结果；每个成功页独立计费，包括成功空页。 - result.data.max_page (integer|null): 已知时返回总页数，搜索无总数时为 null；总页数未知时 Playground 不启用下一页按钮。 - result.data.total (integer|null): 原始分页元数据中的评论总数；搜索返回 null。 - result.data.requested_asin (string): 请求的 ASIN；单条评论可能属于同一 Listing 下的其他变体。 - result.data.items (array): 本页最多 100 条已收录评论，review_id 可能在不同 ASIN 间重复，应保留变体关系。评论不保证实时；collection_no_data 表示该条件下暂无已收录评论且不扣用户 Credits。 - result.data.items[].review_id (string): 公开评论 ID，需与 asin 一起识别评论变体记录。 - result.data.items[].asin (string): 评论实际关联的变体 ASIN，可能与 requested_asin 不同。 - result.data.items[].title (string|null): 评论标题。 - result.data.items[].content (string|null): 评论正文。 - result.data.items[].star (integer|null): 1–5 星评分，未知为 null。 - result.data.items[].date (string|null): 用户留评日期（YYYY-MM-DD）。 - result.data.items[].verified_purchase (boolean|null): 是否带 Amazon 已验证购买标记。 - result.data.items[].collected_at (string|null): 来源报告的收录更新时间，不擅自补时区，与用户留评日期不同。 - result.data.items[].url (string|null): 标准公开评论链接，不包含跟踪或凭证参数。 ## get_collection_job legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 执行遵循现有计价；读取公开说明不扣 Credits。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "properties": { "job_id": { "type": "string" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "job_id" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "job_id": "collection-example" } ``` ### Response schema / 响应契约 ```json { "$defs": { "Schema1": { "additionalProperties": false, "description": "The limited metadata safe to store and expose with a collection result.", "properties": { "api_name": { "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7e]+$", "type": "string" }, "credits_charged": { "maximum": 1000000, "minimum": 0, "type": "integer" }, "latency_ms": { "maximum": 120000, "minimum": 0, "type": "integer" }, "request_id": { "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7e]+$", "type": "string" } }, "required": [ "request_id", "api_name", "latency_ms", "credits_charged" ], "type": "object" } }, "additionalProperties": true, "properties": { "result": { "additionalProperties": false, "properties": { "data": { "additionalProperties": true, "type": "object" }, "meta": { "$ref": "#/$defs/Schema1" } }, "required": [ "data", "meta" ], "type": "object" } }, "type": "object" } ``` ### Synthetic response / 合成响应 ```json { "result": { "data": {}, "meta": { "api_name": "https://www.linkedin.com/in/example", "credits_charged": 0, "latency_ms": 0, "request_id": "https://www.linkedin.com/in/example" } }, "status": "succeeded" } ``` - result.meta.request_id (string): 用于追踪的 Asklear 请求 ID。 - result.meta.api_name (string): 实际执行的采集操作名称。 - result.meta.latency_ms (integer): 采集执行耗时（毫秒）。 - result.meta.credits_charged (integer): 任务完成后 Asklear 用户侧实际结算的 Credits。 - result.data.country (string): 国家站点：US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA，默认 US。接口声明支持不等于各国已完成实测。 - result.data.page (integer): 本次请求的页码，从 1 开始，一次调用只获取一页。 - result.data.next_page (integer|null): 保持国家和筛选条件，将此值作为 page 继续查询。搜索满页仅表示可尝试下一页，不保证还有结果；每个成功页独立计费，包括成功空页。 - result.data.max_page (integer|null): 已知时返回总页数，搜索无总数时为 null；总页数未知时 Playground 不启用下一页按钮。 - result.data.total (integer|null): 原始分页元数据中的评论总数；搜索返回 null。 - result.data.requested_asin (string): 请求的 ASIN；单条评论可能属于同一 Listing 下的其他变体。 - result.data.items (array): 本页最多 100 条已收录评论，review_id 可能在不同 ASIN 间重复，应保留变体关系。评论不保证实时；collection_no_data 表示该条件下暂无已收录评论且不扣用户 Credits。 - result.data.items[].review_id (string): 公开评论 ID，需与 asin 一起识别评论变体记录。 - result.data.items[].asin (string): 评论实际关联的变体 ASIN，可能与 requested_asin 不同。 - result.data.items[].title (string|null): 评论标题。 - result.data.items[].content (string|null): 评论正文。 - result.data.items[].star (integer|null): 1–5 星评分，未知为 null。 - result.data.items[].date (string|null): 用户留评日期（YYYY-MM-DD）。 - result.data.items[].verified_purchase (boolean|null): 是否带 Amazon 已验证购买标记。 - result.data.items[].collected_at (string|null): 来源报告的收录更新时间，不擅自补时区，与用户留评日期不同。 - result.data.items[].url (string|null): 标准公开评论链接，不包含跟踪或凭证参数。 ## asklear collection get-job legacy · available · api_key, oauth REST 需要客户 API Key；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。 One product or one page per request. Each successful request, including an empty page, is charged independently. Listing sales are estimates and may cover multiple variants. Published ASIN sales are not exact real-time sales. Amounts use the currency's minor unit; JPY has no fractional unit. Missing data is null, not zero. Stored reviews may be delayed and refer to other variants. No live review collection is started. 14 marketplaces are supported by the source contract; live verification is recorded separately. 执行遵循现有计价；读取公开说明不扣 Credits。 请求声明 idempotency_key 时，同一次操作复用原键；元数据 GET 只读。 等待态响应提供结果/状态引用。先读取原结果；超时或结果不明时禁止自动重新提交付费执行。401/403/422 应先修正鉴权、权限或输入。 ### Input schema / 输入契约 ```json { "properties": { "job_id": { "type": "string" }, "task_query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.", "maxLength": 300 } }, "required": [ "job_id" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "job_id": "collection-example" } ``` ### Response schema / 响应契约 ```json { "$defs": { "Schema1": { "additionalProperties": false, "description": "The limited metadata safe to store and expose with a collection result.", "properties": { "api_name": { "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7e]+$", "type": "string" }, "credits_charged": { "maximum": 1000000, "minimum": 0, "type": "integer" }, "latency_ms": { "maximum": 120000, "minimum": 0, "type": "integer" }, "request_id": { "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7e]+$", "type": "string" } }, "required": [ "request_id", "api_name", "latency_ms", "credits_charged" ], "type": "object" } }, "additionalProperties": true, "properties": { "result": { "additionalProperties": false, "properties": { "data": { "additionalProperties": true, "type": "object" }, "meta": { "$ref": "#/$defs/Schema1" } }, "required": [ "data", "meta" ], "type": "object" } }, "type": "object" } ``` ### Synthetic response / 合成响应 ```json { "result": { "data": {}, "meta": { "api_name": "https://www.linkedin.com/in/example", "credits_charged": 0, "latency_ms": 0, "request_id": "https://www.linkedin.com/in/example" } }, "status": "succeeded" } ``` - result.meta.request_id (string): 用于追踪的 Asklear 请求 ID。 - result.meta.api_name (string): 实际执行的采集操作名称。 - result.meta.latency_ms (integer): 采集执行耗时（毫秒）。 - result.meta.credits_charged (integer): 任务完成后 Asklear 用户侧实际结算的 Credits。 - result.data.country (string): 国家站点：US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA，默认 US。接口声明支持不等于各国已完成实测。 - result.data.page (integer): 本次请求的页码，从 1 开始，一次调用只获取一页。 - result.data.next_page (integer|null): 保持国家和筛选条件，将此值作为 page 继续查询。搜索满页仅表示可尝试下一页，不保证还有结果；每个成功页独立计费，包括成功空页。 - result.data.max_page (integer|null): 已知时返回总页数，搜索无总数时为 null；总页数未知时 Playground 不启用下一页按钮。 - result.data.total (integer|null): 原始分页元数据中的评论总数；搜索返回 null。 - result.data.requested_asin (string): 请求的 ASIN；单条评论可能属于同一 Listing 下的其他变体。 - result.data.items (array): 本页最多 100 条已收录评论，review_id 可能在不同 ASIN 间重复，应保留变体关系。评论不保证实时；collection_no_data 表示该条件下暂无已收录评论且不扣用户 Credits。 - result.data.items[].review_id (string): 公开评论 ID，需与 asin 一起识别评论变体记录。 - result.data.items[].asin (string): 评论实际关联的变体 ASIN，可能与 requested_asin 不同。 - result.data.items[].title (string|null): 评论标题。 - result.data.items[].content (string|null): 评论正文。 - result.data.items[].star (integer|null): 1–5 星评分，未知为 null。 - result.data.items[].date (string|null): 用户留评日期（YYYY-MM-DD）。 - result.data.items[].verified_purchase (boolean|null): 是否带 Amazon 已验证购买标记。 - result.data.items[].collected_at (string|null): 来源报告的收录更新时间，不擅自补时区，与用户留评日期不同。 - result.data.items[].url (string|null): 标准公开评论链接，不包含跟踪或凭证参数。