Get the app list
GET/app/list/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/app/list/
Description
Use this endpoint to obtain the list of apps under your account.
> Important
> By using Events API endpoints, you agree to the TikTok Business Products (Data) Terms and that you will not share sensitive data with TikTok.
Request
Endpoint
GET https://partner.quantri360.com/v1/tiktok_business/app/list/
Authentication & shop
| Name | In | Type | Sample | Description |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 7000000000000000001 | Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản. |
Request parameters
| Name | In | Type | Required | Sample | Description |
|---|---|---|---|---|---|
| app_platform_ids | query | string[] | No | List of app platform ID for filter purpose. |
Request examples
curl -s "https://partner.quantri360.com/v1/tiktok_business/app/list/" \ -H "Authorization: Bearer $KEY"
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.get(
"https://partner.quantri360.com/v1/tiktok_business/app/list/",
params={},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/app/list/');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'GET',
headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());PHP
<?php $key = 'q360_live_...'; // khóa API của brand $url = 'https://partner.quantri360.com/v1/tiktok_business/app/list/' . '?' . http_build_query([]); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]); $res = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); echo $status, "\n", $res;
Response
Response fields (as returned by TikTok Business)
| Name | Type | Sample | Description |
|---|---|---|---|
| code | number | Response code. For the complete list of response codes and descriptions, see Appendix - Return Codes. | |
| message | string | Response message. For details, see Appendix - Return Codes. | |
| request_id | string | The log id of a request, which uniquely identifies the request. | |
| data | object | Return data. | |
| apps | object[] | Details of a list of mobile apps. | |
| advertiser_id | string | Advertiser ID. | |
| app_platform_id | string | App platform ID. | |
| app_name | string | App name. | |
| self_attribution_enabled | boolean | Whether self-attribution, rather than third-party attribution, has been enabled for the App. | |
| skan_allowed | string | Whether the app can be used to create iOS 14 Dedicated Campaigns to target devices running iOS 14.5+ versions. Enum values: `ALLOWED`, `NOT_ALLOWED`. For an app to be used to create iOS 14 Dedicated Campaigns, the advertiser needs to verify the ownership of the app in Event Manager in TikTok Ads Manager. | |
| advanced_dedicated_campaign_allowed | boolean | Whether the App can be used in Advanced Dedicated Campaigns. To learn about how to create such campaigns, see Create Advanced Dedicated Campaigns. Supported values: `true`, `false`. | |
| is_attribution_flex_enable | boolean | Whether the mobile app is eligible for attribution source and data source configuration during Upgraded Smart+ Ad Group creation. Supported values: `true`, `false`. | |
| download_url | string | App download link. | |
| icon | object | App icon. | |
| height | number | Icon height. | |
| web_uri | string | Icon's picture URI. | |
| width | number | Icon width. | |
| app_id | string | App ID. | |
| package_name | string | App package name. | |
| tiktok_apps | object[] | TikTok App ID information. | |
| tiktok_app_id | string | TikTok App ID. Returned only if the Mobile Measurement Partner for tracking is supported. | |
| partner | object | Third-party tracking partner information. | |
| partner_id | string | Partner ID. | |
| partner_logo | string | Partner logo URI. | |
| partner_name | string | Partner name. | |
| platform | string | App platform. Enum values: `ANDROID`,`IOS`. | |
| enable_retargeting | string | Indicates whether you'd like to enable retargeting attribution. Enum values: `RETARGETING`, `NON_RETARGETING`. Note: Currently, regardless of the value specified for this field, the Enable Retargeting Attribution setting will not take effect on your App. To enable retargeting attribution for your App, go to Events Manager. | |
| tracking_url | object | Tracking links from third-party tracking partners. | |
| click_url | string | Tracking link for clicks. It is provided by your tracking partner. Normally you can get the link from their websites. | |
| impression_url | string | The default tracking link for impressions. It is generated by your tracking partner. Normally you can get the link from their websites. | |
| retargeting_click_url | string | Tracking link for retargeting clicks. It is generated by your tracking partner. Normally you can get the link from their websites. | |
| retargeting_impression_url | string | Tracking link for retargeting impressions. It is generated by your tracking partner. Normally you can get the link from their websites. | |
| create_time | string | Time created. |
Response sample
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"apps": [
{
"advanced_dedicated_campaign_allowed": false,
"advertiser_id": "{{advertiser_id}}",
"app_id": "{{app_id}}",
"app_name": "{{app_name}}",
"app_platform_id": "{{app_platform_id}}",
"create_time": "2026-07-09T15:30:08Z",
"download_url": "{{download_url}}",
"enable_retargeting": "RETARGETING",
"icon": {
"height": 512,
"web_uri": "{{web_uri}}",
"width": 512
},
"is_attribution_flex_enable": false,
"package_name": "{{package_name}}",
"partner": {
"partner_id": "{{partner_id}}",
"partner_logo": "{{partner_logo}}",
"partner_name": "{{partner_name}}",
"partner_token": ""
},
"platform": "IOS",
"self_attribution_enabled": true,
"skan_allowed": "ALLOWED",
"tiktok_apps": [
{
"tiktok_app_id": "{{tiktok_app_id}}"
}
],
"tracking_url": {
"click_url": "{{click_url}}",
"impression_url": "",
"retargeting_click_url": "",
"retargeting_impression_url": ""
}
},
{
"advanced_dedicated_campaign_allowed": false,
"advertiser_id": "{{advertiser_id}}",
"app_id": "{{app_id}}",
"app_name": "{{app_name}}",
"app_platform_id": "{{app_platform_id}}",
"create_time": "2024-02-22T21:43:27Z",
"download_url": "{{download_url}}",
"enable_retargeting": "RETARGETING",
"icon": {
"height": 240,
"web_uri": "{{web_uri}}",
"width": 240
},
"is_attribution_flex_enable": false,
"package_name": "{{package_name}}",
"partner": {
"partner_id": "{{partner_id}}",
"partner_logo": "{{partner_logo}}",
"partner_name": "{{partner_name}}",
"partner_token": ""
},
"platform": "ANDROID",
"self_attribution_enabled": true,
"skan_allowed": "ALLOWED",
"tiktok_apps": [
{
"tiktok_app_id": "{{tiktok_app_id}}"
}
],
"tracking_url": {
"click_url": "{{click_url}}",
"impression_url": "{{impression_url}}",
"retargeting_click_url": "",
"retargeting_impression_url": ""
}
}
]
}
}
(/code);
Get started
- Sign up for Partner
- Enable a data type of the Ads (Marketing API) group on the platform page
- Create an API key (tick the TikTok Business channel)
- Call it as in the examples above