获取应用列表
您可以使用本接口获取广告账号下的App列表。
重要提示
使用事件 API 接口代表您同意遵守TikTok 商业产品（数据）条款，并且不会与 TikTok 分享敏感数据。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/app/list/| /v1.3/app/list/|
|请求参数类型|advertiser_id: number <br>app_platform_ids: number[]|advertiser_id: string <br>app_platform_ids: string[]|
|返回参数名称|is_skan_allowed|skan_allowed|
|返回参数类型|advertiser_id: number <br>app_id: number<br>tiktok_app_id: number <br>partner_id: number |advertiser_id: string <br>app_id: string <br>tiktok_app_id: string <br>partner_id: string |
|新增返回参数|/|self_attribution_enabled<br>advanced_dedicated_campaign_allowed<br>is_attribution_flex_enable`|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/app/list/
**方法** GET
**Header**
```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告账号ID |
|app_platform_ids |string[]| 可传入 app platform ID 列表用于筛选|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/app/list/?advertiser_id={{advertiser_id}}&app_id={{app_id}}' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{35%}|类型{10%}|描述{55%}|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求的日志ID，唯一标识一个请求。|
|data|object|返回数据。|
#|apps |object[]|应用列表信息。 |
##|advertiser_id |string|广告账号 ID。 |
##|app_platform_id |string|应用平台ID。 |
##|app_name |string|应用名称。 |
##|self_attribution_enabled |boolean | 应用是否开启了自归因（即非第三方归因）。|
##|skan_allowed|string|该应用是否可用于创建iOS14专属推广系列。允许值：`ALLOWED`, `NOT_ALLOWED`。如果想将本应用用于创建iOS14专属推广系列，广告主需要到TikTok Ads Manager中的事件管理器中确认应用所有权。|
##| advanced_dedicated_campaign_allowed | boolean | 该应用能否用于高级专属推广系列中。 <br><br>若想了解如何创建此类推广系列，请查看[创建高级专属推广系列](1797011827608577.html)。 <br><br>支持的值：`true`，`false`。|
##|is_attribution_flex_enable|boolean|该移动应用在创建升级版 Smart+ 广告组时是否支持配置归因来源和数据源。<br><br>支持的值：`true`，`false`。|
##|download_url |string|应用下载链接。 |
##|icon |object|应用图标信息。 |
###|height |number|图标高度。 |
###|web_uri |string|图标的图片URI。 |
###|width |number|图标宽度。 |
##|app_id |string|应用ID。 |
##|package_name |string|应用包名。 |
##|tiktok_apps|object[]| TikTok App ID信息。|
###|tiktok_app_id|string|TikTok App ID。仅在第三方检测合作伙伴在支持列表中时返回。|
##|partner |object|第三方监测合作伙伴信息。 |
###|partner_id |string|合作伙伴ID。 |
###|partner_logo |string|合作伙伴logo URI。 |
###|partner_name |string|合作伙伴名称。 |
##|platform |string|应用平台，枚举值: `ANDROID`,`IOS`,`PC`,`UNKNOWN`,`UNLIMITED` |
##|enable_retargeting |string|是否启用再营销归因。<br>枚举值: `RETARGETING`，`NON_RETARGETING`。<br><p><span style="color:darkred"><b>注意</b></span>：目前无论本字段为何值，您的应用的“启用再营销归因”设置均不会实际生效。若想为应用启用再营销归因，需在事件管理平台打开对应开关。|
##|tracking_url |object|第三方监测合作伙伴监测链接。|
###|click_url |string|点击监测链接，由你的监测合作伙伴生成。通常你可以在他们的网站上获取并复制到这个链接。|
###|impression_url |string|默认展示监测链接，由你的监测合作伙伴生成。通常你可以在他们的网站上获取并复制到这个链接。|
###|retargeting_click_url|string|重定向点击监测链接，由你的监测合作伙伴生成。通常你可以在他们的网站上获取并复制到这个链接。|
###|retargeting_impression_url|string|重定向展示监测链接，由你的监测合作伙伴生成。通常你可以在他们的网站上获取并复制到这个链接。|
##|create_time |string|创建时间。 |
示例
(code Success-Response http)
{
"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);