v2.principal.get_content_affiliate_performance

Queries affiliate performance data for the specified content items within the selected time range. Supports request granularity by day, week, month, quarter, year, or customize, and returns both overall summary metrics and content-level detailed metrics with placed-order and confirmed-order views.

Overview

Request parameters

Response parameters

Common parameters

Request samples

Payload

{
	"start_date": "2026-01-01",
	"end_date": "2026-01-01",
	"timezone": "GMT+8",
	"granularity": "day",
	"page_size": 100,
	"cursor": 0
}

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/principal/get_content_affiliate_performance?access_token=access_token&partner_id=partner_id&principal_id=principal_id&sign=sign&timestamp=timestamp")
.header("Content-Type","application/json")
.body("{
   \"content_list\": [
      {
         \"content_ids\": [
            1388859,
            1388860
         ],
         \"currency\": \"LOCAL\",
         \"shop_id\": 181050132
      }
   ],
   \"cursor\": 0,
   \"end_date\": \"2026-01-01\",
   \"granularity\": \"day\",
   \"page_size\": 100,
   \"start_date\": \"2026-01-01\",
   \"timezone\": \"GMT+8\"
}")
.asString();

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/principal/get_content_affiliate_performance?access_token=access_token&partner_id=partner_id&principal_id=principal_id&sign=sign&timestamp=timestamp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "content_list": [
        {
            "content_ids": [
                1388859,
                1388860
            ],
            "currency": "LOCAL",
            "shop_id": 181050132
        }
    ],
    "cursor": 0,
    "end_date": "2026-01-01",
    "granularity": "day",
    "page_size": 100,
    "start_date": "2026-01-01",
    "timezone": "GMT+8"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

cURL

curl --location --request POST 'https://partner.shopeemobile.com/api/v2/principal/get_content_affiliate_performance?access_token=access_token&partner_id=partner_id&principal_id=principal_id&sign=sign&timestamp=timestamp' \
--header 'Content-Type: application/json' \
--data-raw '{
   "content_list": [
      {
         "content_ids": [
            1388859,
            1388860
         ],
         "currency": "LOCAL",
         "shop_id": 181050132
      }
   ],
   "cursor": 0,
   "end_date": "2026-01-01",
   "granularity": "day",
   "page_size": 100,
   "start_date": "2026-01-01",
   "timezone": "GMT+8"
}'

Python

import requests
import json

url = "https://partner.shopeemobile.com/api/v2/principal/get_content_affiliate_performance?access_token=access_token&partner_id=partner_id&principal_id=principal_id&sign=sign&timestamp=timestamp"

payload=json.dumps({
  "content_list": [
    {
      "content_ids": [
        1388859,
        1388860
      ],
      "currency": "LOCAL",
      "shop_id": 181050132
    }
  ],
  "cursor": 0,
  "end_date": "2026-01-01",
  "granularity": "day",
  "page_size": 100,
  "start_date": "2026-01-01",
  "timezone": "GMT+8"
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.RPCRequest("POST",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)

Response sample

JSON

{
	"request_id": "f40a50aa-a1fe-466a-b1b4-0a145590db52",
	"error": "",
	"message": "",
	"response": {
		"summary": [
			{
				"currency": "LOCAL",
				"views": 57843,
				"likes": 10278,
				"comments": 459,
				"sales_placed": 6792.25,
				"sales_confirmed": 6792.25,
				"units_sold_placed": 24,
				"units_sold_confirmed": 24,
				"orders_placed": 26,
				"orders_confirmed": 24
			}
		],
		"details": [
			{
				"region": "SG",
				"currency": "LOCAL",
				"shop_id": 181050132,
				"shop_name": "Huawei Official Store",
				"content_id": 1388859,
				"content_name": "Huawei Brand Day sale!",
				"views": 57843,
				"likes": 10278,
				"comments": 459,
				"sales_placed": 6792.25,
				"sales_confirmed": 6792.25,
				"units_sold_placed": 24,
				"units_sold_confirmed": 24,
				"orders_placed": 26,
				"orders_confirmed": 24
			}
		],
		"next_cursor": 100
	}
}

Error example

JSON

{
    "request_id": "32156105-6502-42cd-bcbb-6472f1b31b02",
    "error": "error_param",
    "message": "page_size is only supported when content_list is empty.",
    "response": null
}

Errors

Common errors

Update log