# 商品搜索 按关键词搜索 Amazon 商品，返回单页商品与可用的 Listing 销售估算。获取单个商品详情请使用产品详情任务。 ID: task:amazon_search_products_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_search_products_v1 ## GET /v1/collections/tasks/amazon_search_products_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_search_products_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_search_products_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "country": "US", "page": 1, "query": "chair slipcover" } ], "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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string", "ui_default": "" } }, "required": [ "query" ], "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_search_products_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_search_products_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "country": "US", "page": 1, "query": "chair slipcover" } ], "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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string", "ui_default": "" } }, "required": [ "query" ], "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_search_products_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_search_products_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "country": "US", "page": 1, "query": "chair slipcover" } ], "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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string", "ui_default": "" } }, "required": [ "query" ], "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. 每个成功任务 20 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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "query" ], "type": "object" }, "task_code": { "const": "amazon_search_products_v1" } }, "required": [ "task_code", "input" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "input": { "country": "US", "page": 1, "query": "chair slipcover" }, "task_code": "amazon_search_products_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 20 } ``` - 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. 每个成功任务 20 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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "query" ], "type": "object" }, "task_code": { "const": "amazon_search_products_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, "query": "chair slipcover" }, "task_code": "amazon_search_products_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 20 } ``` - 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. 每个成功任务 20 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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "query" ], "type": "object" }, "task_code": { "const": "amazon_search_products_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, "query": "chair slipcover" }, "task_code": "amazon_search_products_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 20 } ``` - 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. 每个成功任务 20 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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "query" ], "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_search_products_v1" } }, "required": [ "task_code", "input", "quote_token", "idempotency_key" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "idempotency_key": "directory-example", "input": { "country": "US", "page": 1, "query": "chair slipcover" }, "quote_token": "quote-token-from-estimate", "task_code": "amazon_search_products_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. 每个成功任务 20 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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "query" ], "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_search_products_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, "query": "chair slipcover" }, "quote_token": "quote-token-from-estimate", "task_code": "amazon_search_products_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. 每个成功任务 20 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" }, "query": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "query" ], "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_search_products_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, "query": "chair slipcover" }, "quote_token": "quote-token-from-estimate", "task_code": "amazon_search_products_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.items (array): 本页最多 100 个商品，不隐式追加详情或趋势查询。来源明确表示无已收录数据时返回 collection_no_data，不是服务故障。成功空页与此不同，仍按正常单页价格收费；失败任务仅在能核实实际结算时返回 credits_charged。 - result.data.items[].asin (string): 返回商品的 ASIN，可传给产品详情或商品评论任务。 - result.data.items[].parent_asin (string|null): 可用时返回父 Listing 的 ASIN。 - result.data.items[].title (string): 商品名称。 - result.data.items[].url (string): 所选国家站点的标准商品链接。 - result.data.items[].images (array): 商品公开图片链接。 - result.data.items[].brand (string|null): 商品品牌，未知为 null。 - result.data.items[].description (string|null): 已收录的商品说明，可能保留原文格式。 - result.data.items[].price (object|null): 收录时的销售价，不代表实时下单价格。 - result.data.items[].price.amount_minor (integer): 金额为币种最小单位：USD 4199 表示 41.99 美元，JPY 4199 表示 4199 日元，不能一律除以 100。 - result.data.items[].price.currency (string): 所选国家站点的 ISO 币种代码。 - result.data.items[].rating (number|null): 0–5 分评分，不可用时为 null。 - result.data.items[].ratings_count (integer|null): 评分数量，不等于可查询的已收录评论数量。 - result.data.items[].categories (array): 已收录的商品类目名称。 - result.data.items[].updated_at (string|null): 来源提供时返回商品快照更新日期（YYYY-MM-DD）。 - result.data.items[].variation_count (integer|null): Listing 的变体数量，未知为 null。 - result.data.items[].asin_published_sales (integer|null): Amazon 页面公布的 ASIN 级销量，通常为近期一个月的粗略数量，不是精确销量。未报告或表示未报告的 0 返回 null。 - result.data.items[].listing_sales.scope (string): 固定 listing：估算可能涵盖多个变体，不仅是输入的 ASIN。 - result.data.items[].listing_sales.estimated (boolean): 固定 true；销量和销售额均为估算。 - result.data.items[].listing_sales.daily.date (string|null): 单日估算对应日期（YYYY-MM-DD），来源未提供时为 null。 - result.data.items[].listing_sales.daily.units (integer|null): Listing 的单日估算销量，缺失为 null，不填 0。 - result.data.items[].listing_sales.daily.revenue (object|null): Listing 的单日估算销售额，不做汇率转换。 - result.data.items[].listing_sales.daily.revenue.amount_minor (integer): 销售额，单位为对应币种的最小单位。 - result.data.items[].listing_sales.daily.revenue.currency (string): 对应国家站点的 ISO 币种代码。 - result.data.items[].listing_sales.rolling_30d.date (string|null): 滚动 30 天估算对应日期（YYYY-MM-DD），来源未提供时为 null。 - result.data.items[].listing_sales.rolling_30d.units (integer|null): Listing 的滚动 30 天估算销量，缺失为 null，不填 0。 - result.data.items[].listing_sales.rolling_30d.revenue (object|null): Listing 的滚动 30 天估算销售额，不做汇率转换。 - result.data.items[].listing_sales.rolling_30d.revenue.amount_minor (integer): 销售额，单位为对应币种的最小单位。 - result.data.items[].listing_sales.rolling_30d.revenue.currency (string): 对应国家站点的 ISO 币种代码。 ## 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.items (array): 本页最多 100 个商品，不隐式追加详情或趋势查询。来源明确表示无已收录数据时返回 collection_no_data，不是服务故障。成功空页与此不同，仍按正常单页价格收费；失败任务仅在能核实实际结算时返回 credits_charged。 - result.data.items[].asin (string): 返回商品的 ASIN，可传给产品详情或商品评论任务。 - result.data.items[].parent_asin (string|null): 可用时返回父 Listing 的 ASIN。 - result.data.items[].title (string): 商品名称。 - result.data.items[].url (string): 所选国家站点的标准商品链接。 - result.data.items[].images (array): 商品公开图片链接。 - result.data.items[].brand (string|null): 商品品牌，未知为 null。 - result.data.items[].description (string|null): 已收录的商品说明，可能保留原文格式。 - result.data.items[].price (object|null): 收录时的销售价，不代表实时下单价格。 - result.data.items[].price.amount_minor (integer): 金额为币种最小单位：USD 4199 表示 41.99 美元，JPY 4199 表示 4199 日元，不能一律除以 100。 - result.data.items[].price.currency (string): 所选国家站点的 ISO 币种代码。 - result.data.items[].rating (number|null): 0–5 分评分，不可用时为 null。 - result.data.items[].ratings_count (integer|null): 评分数量，不等于可查询的已收录评论数量。 - result.data.items[].categories (array): 已收录的商品类目名称。 - result.data.items[].updated_at (string|null): 来源提供时返回商品快照更新日期（YYYY-MM-DD）。 - result.data.items[].variation_count (integer|null): Listing 的变体数量，未知为 null。 - result.data.items[].asin_published_sales (integer|null): Amazon 页面公布的 ASIN 级销量，通常为近期一个月的粗略数量，不是精确销量。未报告或表示未报告的 0 返回 null。 - result.data.items[].listing_sales.scope (string): 固定 listing：估算可能涵盖多个变体，不仅是输入的 ASIN。 - result.data.items[].listing_sales.estimated (boolean): 固定 true；销量和销售额均为估算。 - result.data.items[].listing_sales.daily.date (string|null): 单日估算对应日期（YYYY-MM-DD），来源未提供时为 null。 - result.data.items[].listing_sales.daily.units (integer|null): Listing 的单日估算销量，缺失为 null，不填 0。 - result.data.items[].listing_sales.daily.revenue (object|null): Listing 的单日估算销售额，不做汇率转换。 - result.data.items[].listing_sales.daily.revenue.amount_minor (integer): 销售额，单位为对应币种的最小单位。 - result.data.items[].listing_sales.daily.revenue.currency (string): 对应国家站点的 ISO 币种代码。 - result.data.items[].listing_sales.rolling_30d.date (string|null): 滚动 30 天估算对应日期（YYYY-MM-DD），来源未提供时为 null。 - result.data.items[].listing_sales.rolling_30d.units (integer|null): Listing 的滚动 30 天估算销量，缺失为 null，不填 0。 - result.data.items[].listing_sales.rolling_30d.revenue (object|null): Listing 的滚动 30 天估算销售额，不做汇率转换。 - result.data.items[].listing_sales.rolling_30d.revenue.amount_minor (integer): 销售额，单位为对应币种的最小单位。 - result.data.items[].listing_sales.rolling_30d.revenue.currency (string): 对应国家站点的 ISO 币种代码。 ## 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.items (array): 本页最多 100 个商品，不隐式追加详情或趋势查询。来源明确表示无已收录数据时返回 collection_no_data，不是服务故障。成功空页与此不同，仍按正常单页价格收费；失败任务仅在能核实实际结算时返回 credits_charged。 - result.data.items[].asin (string): 返回商品的 ASIN，可传给产品详情或商品评论任务。 - result.data.items[].parent_asin (string|null): 可用时返回父 Listing 的 ASIN。 - result.data.items[].title (string): 商品名称。 - result.data.items[].url (string): 所选国家站点的标准商品链接。 - result.data.items[].images (array): 商品公开图片链接。 - result.data.items[].brand (string|null): 商品品牌，未知为 null。 - result.data.items[].description (string|null): 已收录的商品说明，可能保留原文格式。 - result.data.items[].price (object|null): 收录时的销售价，不代表实时下单价格。 - result.data.items[].price.amount_minor (integer): 金额为币种最小单位：USD 4199 表示 41.99 美元，JPY 4199 表示 4199 日元，不能一律除以 100。 - result.data.items[].price.currency (string): 所选国家站点的 ISO 币种代码。 - result.data.items[].rating (number|null): 0–5 分评分，不可用时为 null。 - result.data.items[].ratings_count (integer|null): 评分数量，不等于可查询的已收录评论数量。 - result.data.items[].categories (array): 已收录的商品类目名称。 - result.data.items[].updated_at (string|null): 来源提供时返回商品快照更新日期（YYYY-MM-DD）。 - result.data.items[].variation_count (integer|null): Listing 的变体数量，未知为 null。 - result.data.items[].asin_published_sales (integer|null): Amazon 页面公布的 ASIN 级销量，通常为近期一个月的粗略数量，不是精确销量。未报告或表示未报告的 0 返回 null。 - result.data.items[].listing_sales.scope (string): 固定 listing：估算可能涵盖多个变体，不仅是输入的 ASIN。 - result.data.items[].listing_sales.estimated (boolean): 固定 true；销量和销售额均为估算。 - result.data.items[].listing_sales.daily.date (string|null): 单日估算对应日期（YYYY-MM-DD），来源未提供时为 null。 - result.data.items[].listing_sales.daily.units (integer|null): Listing 的单日估算销量，缺失为 null，不填 0。 - result.data.items[].listing_sales.daily.revenue (object|null): Listing 的单日估算销售额，不做汇率转换。 - result.data.items[].listing_sales.daily.revenue.amount_minor (integer): 销售额，单位为对应币种的最小单位。 - result.data.items[].listing_sales.daily.revenue.currency (string): 对应国家站点的 ISO 币种代码。 - result.data.items[].listing_sales.rolling_30d.date (string|null): 滚动 30 天估算对应日期（YYYY-MM-DD），来源未提供时为 null。 - result.data.items[].listing_sales.rolling_30d.units (integer|null): Listing 的滚动 30 天估算销量，缺失为 null，不填 0。 - result.data.items[].listing_sales.rolling_30d.revenue (object|null): Listing 的滚动 30 天估算销售额，不做汇率转换。 - result.data.items[].listing_sales.rolling_30d.revenue.amount_minor (integer): 销售额，单位为对应币种的最小单位。 - result.data.items[].listing_sales.rolling_30d.revenue.currency (string): 对应国家站点的 ISO 币种代码。