# Xianyu product search Search Xianyu second-hand products by keyword and sort order. ID: task:xianyu_product_search_v1 · Region: global · Status: unavailable catalog_version: 938eb1e3bdb6476050bf2983e6e8db1edcf9f0942d16c7ebd2029dcd28295afe updated_at: 2026-10-21T10:40:52.196893+00:00 Xianyu Dataset releases define historical periods; live reads describe request-time data and do not guarantee completeness. Docs: https://docs.kleardata.ai/capabilities/task%3Axianyu_product_search_v1 ## GET /v1/collections/tasks/xianyu_product_search_v1 legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Existing pricing applies; metadata reads do not charge Credits. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "properties": { "task_code": { "const": "xianyu_product_search_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": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "keyword": "相机", "page": 1, "sort": "active" } ], "input_schema": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string", "ui_default": "" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" } } ``` - input_schema (object): No field description available - examples (array): No field description available ## describe_collection_task legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Existing pricing applies; metadata reads do not charge Credits. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "properties": { "task_code": { "const": "xianyu_product_search_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": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "keyword": "相机", "page": 1, "sort": "active" } ], "input_schema": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string", "ui_default": "" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" } } ``` - input_schema (object): No field description available - examples (array): No field description available ## asklear collection describe legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Existing pricing applies; metadata reads do not charge Credits. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "properties": { "task_code": { "const": "xianyu_product_search_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": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "examples": [ { "keyword": "相机", "page": 1, "sort": "active" } ], "input_schema": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string", "ui_default": "" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" } } ``` - input_schema (object): No field description available - examples (array): No field description available ## POST /v1/collections/estimate legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. 48 Credits per successful task; estimate before starting. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "description": "Outer transport contract; each registered task validates its own input.", "properties": { "input": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" }, "task_code": { "const": "xianyu_product_search_v1" } }, "required": [ "task_code", "input" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "input": { "keyword": "相机", "page": 1, "sort": "active" }, "task_code": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 48 } ``` - quote_token (string): No field description available - upper_bound_credits (integer): No field description available ## estimate_collection legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. 48 Credits per successful task; estimate before starting. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "description": "Outer transport contract; each registered task validates its own input.", "properties": { "input": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" }, "task_code": { "const": "xianyu_product_search_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": { "keyword": "相机", "page": 1, "sort": "active" }, "task_code": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 48 } ``` - quote_token (string): No field description available - upper_bound_credits (integer): No field description available ## asklear collection estimate legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. 48 Credits per successful task; estimate before starting. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "description": "Outer transport contract; each registered task validates its own input.", "properties": { "input": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" }, "task_code": { "const": "xianyu_product_search_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": { "keyword": "相机", "page": 1, "sort": "active" }, "task_code": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "quote_token": "quote-token-from-estimate", "upper_bound_credits": 48 } ``` - quote_token (string): No field description available - upper_bound_credits (integer): No field description available ## POST /v1/collections/jobs legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. 48 Credits per successful task; estimate before starting. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "properties": { "idempotency_key": { "maxLength": 128, "minLength": 1, "type": "string" }, "input": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" }, "max_credits": { "anyOf": [ { "exclusiveMinimum": 0, "type": "integer" }, { "type": "null" } ], "default": null }, "quote_token": { "maxLength": 4096, "minLength": 16, "type": "string" }, "task_code": { "const": "xianyu_product_search_v1" } }, "required": [ "task_code", "input", "quote_token", "idempotency_key" ], "type": "object" } ``` ### Synthetic request / 合成请求 ```json { "idempotency_key": "directory-example", "input": { "keyword": "相机", "page": 1, "sort": "active" }, "quote_token": "quote-token-from-estimate", "task_code": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "job_id": "collection-example", "status": "queued" } ``` - job_id (string): No field description available - status (string): No field description available Follow up: GET /v1/collections/jobs/{job_id} Read job status and its saved public result. ## start_collection legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. 48 Credits per successful task; estimate before starting. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "properties": { "idempotency_key": { "maxLength": 128, "minLength": 1, "type": "string" }, "input": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" }, "max_credits": { "anyOf": [ { "exclusiveMinimum": 0, "type": "integer" }, { "type": "null" } ], "default": null }, "quote_token": { "maxLength": 4096, "minLength": 16, "type": "string" }, "task_code": { "const": "xianyu_product_search_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": { "keyword": "相机", "page": 1, "sort": "active" }, "quote_token": "quote-token-from-estimate", "task_code": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "job_id": "collection-example", "status": "queued" } ``` - job_id (string): No field description available - status (string): No field description available Follow up: GET /v1/collections/jobs/{job_id} Read job status and its saved public result. ## asklear collection start legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. 48 Credits per successful task; estimate before starting. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### Input schema / 输入契约 ```json { "$defs": {}, "additionalProperties": false, "properties": { "idempotency_key": { "maxLength": 128, "minLength": 1, "type": "string" }, "input": { "additionalProperties": false, "properties": { "keyword": { "maxLength": 200, "minLength": 1, "type": "string" }, "page": { "default": 1, "maximum": 1000, "minimum": 1, "type": "integer" }, "sort": { "default": "active", "enum": [ "active", "recent", "credit", "price_asc", "price_desc", "price_drop", "newest" ], "type": "string" } }, "required": [ "keyword" ], "type": "object" }, "max_credits": { "anyOf": [ { "exclusiveMinimum": 0, "type": "integer" }, { "type": "null" } ], "default": null }, "quote_token": { "maxLength": 4096, "minLength": 16, "type": "string" }, "task_code": { "const": "xianyu_product_search_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": { "keyword": "相机", "page": 1, "sort": "active" }, "quote_token": "quote-token-from-estimate", "task_code": "xianyu_product_search_v1" } ``` ### Synthetic response / 合成响应 ```json { "job_id": "collection-example", "status": "queued" } ``` - job_id (string): No field description available - status (string): No field description available Follow up: GET /v1/collections/jobs/{job_id} Read job status and its saved public result. ## GET /v1/collections/jobs/{job_id} legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. Existing pricing applies; metadata reads do not charge Credits. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### 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 request identifier for tracing. - result.meta.api_name (string): Executed collection operation name. - result.meta.latency_ms (integer): Collection execution latency in milliseconds. - result.meta.credits_charged (integer): Asklear user-side Credits settled for this task after completion. - result.data.items (array): Projected public items for this task. - result.data.items[].item_id (scalar|null): Product identifier, when available. - result.data.items[].title (scalar|null): Title, when available. - result.data.items[].url (scalar|null): Public URL, when available. - result.data.items[].price (string|number|object|null): Price, when available. - result.data.items[].currency (scalar|null): Currency, when available. - result.data.items[].image (scalar|null): Image, when available. - result.data.items[].images (array|null): Product images, when available. - result.data.items[].sales (scalar|null): Sales information, when available. - result.data.items[].seller_id (string|null): Seller identifier when available, published as a string to preserve all digits. Saved business extensions can supply the identifier on readback. - result.data.items[].seller_name (scalar|null): Seller name, when available. - result.data.items[].shop_url (scalar|null): Shop URL, when available. - result.data.items[].rating (scalar|null): Rating, when available. - result.data.items[].description (scalar|null): Description, when available. - result.data.items[].view_count (integer|null): Exact nonnegative view count when supplied. Search cards may omit it; use product details. Missing or invalid values are omitted, never inferred as zero. - result.data.items[].want_count (integer|null): Exact nonnegative want count when supplied; interest, not sales. Missing, approximate or invalid values are omitted, never inferred as zero. - result.data.items[].extended_data (object): Sanitized business extensions; nested keys vary by product and source. - result.data.extended_data (object): Sanitized page-level business extensions, when available. - result.data.page (integer): Current page number. - result.data.max_page (integer|null): Last page hint when supplied. - result.data.next_page (integer|null): Next page, or null when finished. - result.data.total (integer|null): Total result count when supplied. - result.data.tpp_failover (boolean|null): Collection page marker: true when Xianyu reports a recommendation fallback; false when Xianyu explicitly reports no fallback; null when the signal is missing or unrecognized, including historical results without the marker. This flag does not verify individual item relevance. The development-only native source with the same legacy alias has separate canonical items and a page envelope; neither currently publishes this Collection marker. ## get_collection_job legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. Existing pricing applies; metadata reads do not charge Credits. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### 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 request identifier for tracing. - result.meta.api_name (string): Executed collection operation name. - result.meta.latency_ms (integer): Collection execution latency in milliseconds. - result.meta.credits_charged (integer): Asklear user-side Credits settled for this task after completion. - result.data.items (array): Projected public items for this task. - result.data.items[].item_id (scalar|null): Product identifier, when available. - result.data.items[].title (scalar|null): Title, when available. - result.data.items[].url (scalar|null): Public URL, when available. - result.data.items[].price (string|number|object|null): Price, when available. - result.data.items[].currency (scalar|null): Currency, when available. - result.data.items[].image (scalar|null): Image, when available. - result.data.items[].images (array|null): Product images, when available. - result.data.items[].sales (scalar|null): Sales information, when available. - result.data.items[].seller_id (string|null): Seller identifier when available, published as a string to preserve all digits. Saved business extensions can supply the identifier on readback. - result.data.items[].seller_name (scalar|null): Seller name, when available. - result.data.items[].shop_url (scalar|null): Shop URL, when available. - result.data.items[].rating (scalar|null): Rating, when available. - result.data.items[].description (scalar|null): Description, when available. - result.data.items[].view_count (integer|null): Exact nonnegative view count when supplied. Search cards may omit it; use product details. Missing or invalid values are omitted, never inferred as zero. - result.data.items[].want_count (integer|null): Exact nonnegative want count when supplied; interest, not sales. Missing, approximate or invalid values are omitted, never inferred as zero. - result.data.items[].extended_data (object): Sanitized business extensions; nested keys vary by product and source. - result.data.extended_data (object): Sanitized page-level business extensions, when available. - result.data.page (integer): Current page number. - result.data.max_page (integer|null): Last page hint when supplied. - result.data.next_page (integer|null): Next page, or null when finished. - result.data.total (integer|null): Total result count when supplied. - result.data.tpp_failover (boolean|null): Collection page marker: true when Xianyu reports a recommendation fallback; false when Xianyu explicitly reports no fallback; null when the signal is missing or unrecognized, including historical results without the marker. This flag does not verify individual item relevance. The development-only native source with the same legacy alias has separate canonical items and a page envelope; neither currently publishes this Collection marker. ## asklear collection get-job legacy · unavailable · api_key, oauth REST requires a customer API Key; MCP requires an enabled authenticated server; CLI requires its published artifact and command. Each task runs only the requested operation. Returned data is bounded and projected into task-specific public fields; missing fields are not inferred. Each successful request is charged once at the Asklear task price. When the keyword has no matches, Xianyu may return a recommendation feed; tpp_failover=true reports a recommendation fallback, false reports no fallback, and null means the signal is missing or unrecognized. This page-level flag does not verify individual item relevance. data.tpp_failover belongs to the Collection page result. The development-only native operation that retains the xianyu_product_search_v1 alias has a separate canonical item-level schema and source-owned page envelope; neither currently publishes this Collection marker. Availability depends on the current service release and this account's access. Existing pricing applies; metadata reads do not charge Credits. Where the request declares idempotency_key, reuse it for the same operation; metadata GET is read-only. A pending response supplies a result/status reference. Read it first; do not automatically resubmit paid execution after a timeout or ambiguous result. Correct 401/403/422 errors before retrying. ### 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 request identifier for tracing. - result.meta.api_name (string): Executed collection operation name. - result.meta.latency_ms (integer): Collection execution latency in milliseconds. - result.meta.credits_charged (integer): Asklear user-side Credits settled for this task after completion. - result.data.items (array): Projected public items for this task. - result.data.items[].item_id (scalar|null): Product identifier, when available. - result.data.items[].title (scalar|null): Title, when available. - result.data.items[].url (scalar|null): Public URL, when available. - result.data.items[].price (string|number|object|null): Price, when available. - result.data.items[].currency (scalar|null): Currency, when available. - result.data.items[].image (scalar|null): Image, when available. - result.data.items[].images (array|null): Product images, when available. - result.data.items[].sales (scalar|null): Sales information, when available. - result.data.items[].seller_id (string|null): Seller identifier when available, published as a string to preserve all digits. Saved business extensions can supply the identifier on readback. - result.data.items[].seller_name (scalar|null): Seller name, when available. - result.data.items[].shop_url (scalar|null): Shop URL, when available. - result.data.items[].rating (scalar|null): Rating, when available. - result.data.items[].description (scalar|null): Description, when available. - result.data.items[].view_count (integer|null): Exact nonnegative view count when supplied. Search cards may omit it; use product details. Missing or invalid values are omitted, never inferred as zero. - result.data.items[].want_count (integer|null): Exact nonnegative want count when supplied; interest, not sales. Missing, approximate or invalid values are omitted, never inferred as zero. - result.data.items[].extended_data (object): Sanitized business extensions; nested keys vary by product and source. - result.data.extended_data (object): Sanitized page-level business extensions, when available. - result.data.page (integer): Current page number. - result.data.max_page (integer|null): Last page hint when supplied. - result.data.next_page (integer|null): Next page, or null when finished. - result.data.total (integer|null): Total result count when supplied. - result.data.tpp_failover (boolean|null): Collection page marker: true when Xianyu reports a recommendation fallback; false when Xianyu explicitly reports no fallback; null when the signal is missing or unrecognized, including historical results without the marker. This flag does not verify individual item relevance. The development-only native source with the same legacy alias has separate canonical items and a page envelope; neither currently publishes this Collection marker.