Developer docs / Music and locations
Search Business locations
Queries up to 20 live location tags without local storage or caching. Submit locationId and locationName together in tiktokBusiness.locationInfo or tiktokBusinessPhoto.locationInfo; a single field fails validation. Entries missing either field are omitted. The server resolves business_id from the account open_id; expired authorization returns “授权过期,请重新授权” (authorization expired, reauthorize).
GET
/v1/creator/tiktokBusiness/searchLocation- Authentication:
- Request header x-api-key: <YOUR_API_KEY>; keep the key on the server and never expose it in client code, logs or shared files.
- Success criteria:
- HTTP 2xx with code=0; for asynchronous tasks, also query the final status.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Creator account ID |
searchQuery | string | Yes | Location query, up to 100 characters |
Queries up to 20 live location tags without local storage or caching. Submit locationId and locationName together in tiktokBusiness.locationInfo or tiktokBusinessPhoto.locationInfo; a single field fails validation. Entries missing either field are omitted. The server resolves business_id from the account open_id; expired authorization returns “授权过期,请重新授权” (authorization expired, reauthorize).
Success response
{
"code": 0,
"message": "success",
"data": {
"locations": [
{
"locationId": "loc-1",
"locationName": "City of London, United Kingdom",
"locationAddress": "London, United Kingdom"
}
]
},
"timestamp": 1790640000000
}Response and errors
Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | Yes | — |
message | string | Yes | — |
data | object | Yes | — |
data.locations | object[] | Yes | — |
data.locations[].locationId | string | Yes | Passed as post_info.location_id when publishing |
data.locations[].locationName | string | Yes | Location name, submitted with the ID when publishing and used in lists |
data.locations[].locationAddress | string | No | Extra location detail: a country, state, city or full address. Display only |
timestamp | integer | Yes | — |
Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.
Last updated · 2026-11-16