Skip to main content

POST Creator Search Affiliate Trace Orders

Creator Search Affiliate Trace Orders Creator Required scope: creator.affiliate.share_link.read This API allows the partner to retrieve a list of affiliate orders generated by a creator, returning the order ID and the product ID. Using this, the partner can track their affiliate-conversions on behalf of a creator, using the order ID. Version 202505

POST/affiliate_creator/202505/orders/trace/search

Request

Header

PropertiesTypeDescription
content-type RequiredstringAllowed type: application/json
x-tts-access-token RequiredstringThe creator access_token value from Get Access Token, when user_type = 1. Follow this guide to get creator access_token.

Query

PropertiesTypeDescription
app_key RequiredstringEvery single app will have a unique key. Please use the specific key assigned to your app.
sign RequiredstringSignature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.
page_tokenstringAn 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.
page_size RequiredintThe number of results to be returned per page. Default: 20Valid Range: [1-100]

Body

PropertiesTypeDescription
time_ge RequiredintFilter orders to include only those with the specified time_type timestamp greater than or equal to time_ge and less than time_lt. Unix timestamp.Note:time_ge and time_lt together constitute the creation time filter condition.
time_lt RequiredintFilter orders to include only those with the specified time_type timestamp greater than or equal to time_ge and less than time_lt.Unix timestamp.
time_typestringSpecifies the type of timestamp to filter the orders by. The query time range (time_ge and time_lt) will be applied to the selected time type.Possible values:- PAY_TIME: Filter based on the order payment time.- DELIVERY_TIME: Filter based on the order delivery/shipment time.- SETTLE_TIME: Filter based on the order settlement time.- CREATE_TIME (default): Filter based on the order creation time.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintThe success or failure status code returned in API response.
messagestringThe success or failure messages returned in API response. Reasons of failure will be described in the message.
request_idstringRequest log
dataobjectSpecific return information

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |

Is this content helpful?Helpful

Not Helpful

PreviousNext