获取 TikTok 账号的地域标签
此接口可用于获取 TikTok 账号的可用地域标签列表。
你可以在发布视频或图片帖子时包含这些地域标签，这样你的帖子将显示地域。添加地域标签有助于当地受众以及搜索该地区的用户发现你的帖子。此外，这还能让你的内容与附近地区的用户更相关，进而提升互动率。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/business/publish/location/
方法 GET
Header
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌，需使用 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/obtain-a-short-term-access-token/v1.3) 接口。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|business_id {必填}|string|TikTok 账号的开发者应用唯一识别 ID。<br><br>需将 [/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs/obtain-a-short-term-access-token/v1.3) 接口返回的 `open_id` 字段值传入本字段。|
|search_query {必填}|string|你提供的查询内容，用于搜索可添加到 TikTok 账号帖子的地域。<br><br>长度限制：100 个字符。|
示例
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/business/publish/location/?business_id={{business_id}}&search_query=new' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|locations|object[]|地域列表。<br><br>最多可获取 20 个地域。|
##|location_name|string|地域名称。|
##|location_id|string|地域标签 ID。<br><br>你可以将此 ID 与 `location_name` 一同传入 [/business/video/publish/](https://business-api.tiktok.com/portal/docs/publish-a-public-video-post-to-an-owned-account/v1.3) 或 [/business/photo/publish/](https://business-api.tiktok.com/portal/docs/publish-a-photo-post-to-an-owned-account/v1.3) 接口，以在已发布的帖子中显示关联的地域。|
##|location_address|string|与地域相关的其他信息。<br><br>返回的内容因情况而异，可能包括但不限于：<ul><li>仅国家/地区：`United Kingdom`</li><li>区域/州/省 + 国家/地区：`Florida, United States`、`Illinois, United States`</li><li>城市 + 国家/地区：`Cairo, Egypt`</li><li>完整街道地址：`300 West 47th Street, New York, New York 10036, USA`</li></ul>|
示例
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"locations": [
{
"location_address": "United States",
"location_id": "22535865201205278",
"location_name": "New York"
},
{
"location_address": "Prince Edward Island, Canada",
"location_id": "22535796524027671",
"location_name": "New Zealand"
},
{
"location_address": "Doğanay, Ordu Cd. No:39, 35160 Karabağlar/İzmir, Türkiye",
"location_id": "22535865260174927",
"location_name": "New York City"
},
{
"location_address": "New York, United States",
"location_id": "22535865208931252",
"location_name": "New City"
},
{
"location_address": "Illinois, United States",
"location_id": "22535796508226811",
"location_name": "New Delhi"
},
{
"location_address": "1 MetLife Stadium Dr, East Rutherford, NJ 07073, United States",
"location_id": "22535865208474317",
"location_name": "New York New Jersey Stadium"
},
{
"location_address": "New Zealand",
"location_id": "22535865209865394",
"location_name": "Christchurch"
},
{
"location_address": "Tyne and Wear, United Kingdom",
"location_id": "22535796482468354",
"location_name": "Newcastle upon Tyne"
},
{
"location_address": "Sindh, Pakistan",
"location_id": "22535865259068940",
"location_name": "New Dumbaalo"
},
{
"location_address": "Toronto, Ontario, Canada",
"location_id": "20442395510492511",
"location_name": "New Toronto"
},
{
"location_address": "Sindh, Pakistan",
"location_id": "22535865257546646",
"location_name": "New Saeedabad"
},
{
"location_address": "California, United States",
"location_id": "22535865215152843",
"location_name": "Newport Beach"
},
{
"location_address": "New York, United States",
"location_id": "22535865257269890",
"location_name": "Florida"
},
{
"location_address": "New Brunswick, Canada",
"location_id": "22535796500168914",
"location_name": "New Jersey"
},
{
"location_address": "Louisiana, United States",
"location_id": "22535865208560798",
"location_name": "New Orleans"
},
{
"location_address": "Jazan, Saudi Arabia",
"location_id": "22535865208862255",
"location_name": "Abu Arish"
},
{
"location_address": "London NW2 3ET, UK",
"location_id": "20442395071858766",
"location_name": "Skardu Road"
},
{
"location_address": "Texas, United States",
"location_id": "22535865241581563",
"location_name": "New Braunfels"
},
{
"location_address": "بلقاس, الدقهلية, مصر",
"location_id": "21568226274489005",
"location_name": "جامعة المنصورة الجديدة - New Mansoura University"
},
{
"location_address": "Murree, Punjab, Pakistan",
"location_id": "22535865260673296",
"location_name": "New Murree Bazaar"
}
]
}
}
(/code)