POST Search Global Products
Search Global Products Seller Required scope: seller.global_product.info Retrieve a list of global products that meet the specified conditions. This API will only return the key product properties. You can pass a returned global product ID to the Get Global Product API
to obtain more details about the product. Version 202312
POST/product/202312/global_products/search
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| page_size Required | int | The number of results to be returned per page. Valid range: [1-100] |
| page_token | string | An opaque token used to retrieve the next page of a paginated result set. Retrieve this value from the result of the next_page_token from a previous response. It is not needed for the first page. |
Body
| Properties | Type | Description |
|---|---|---|
| status | string | Filter global products by their status.Possible values:- PUBLISHED- UNPUBLISHED- DRAFT- DELETED |
| seller_skus | []string | Filter global products by these seller SKU codes. |
| create_time_ge | int | Filter global products to show only those that are created on or after the specified date and time. Unix timestamp.Note:The "create_time_ge" and "create_time_le" together constitute the creation time filter condition.- If "create_time_ge" is filled but "create_time_le" is empty, "create_time_le" will default to the current time.- If "create_time_le" is filled but "create_time_ge" is empty, "create_time_ge" will default to the earliest shop time. |
| create_time_le | int | Filter global products to show only those that are created on or before the specified date and time. Unix timestamp.Refer to notes in "create_time_ge" for more usage information. |
| update_time_ge | int | Filter global products to show only those that are updated on or after the specified date and time. Unix timestamp.Note:The fields "update_time_ge" and "update_time_le" together define the update time filter condition.- If "update_time_ge" is filled but "update_time_le" is empty, "update_time_le" will default to the current time.- If "update_time_le" is filled but "update_time_ge" is empty, "update_time_ge" will default to the earliest shop time. |
| update_time_le | int | Filter global products to show only those that are updated on or before the specified date and time. Unix timestamp.Refer to notes in update_time_ge for more usage information. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 12019015 | The number of SKU exceed the limit | | 12019108 | page number is invalid | | 12019109 | page size is invalid | | 12019118 | search create time invalid | | 12019119 | search update time invalid | | 12052032 | The product does not exist | | 12052180 | The total number of search results can not exceed 10000. | | 12052700 | The seller is inactive. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12052901 | The product in its current status is not available for this operation. Change the product status and try again. | | 12052910 | Invalid input parameters. Refer to the API documentation for details. |
Is this content helpful?Helpful
Not Helpful
PreviousNext