您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
Search Business locations
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

FieldTypeRequiredDescription
idintegerYesCreator account ID
searchQuerystringYesLocation 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.

FieldTypeRequiredDescription
codeintegerYes—
messagestringYes—
dataobjectYes—
data.locationsobject[]Yes—
data.locations[].locationIdstringYesPassed as post_info.location_id when publishing
data.locations[].locationNamestringYesLocation name, submitted with the ID when publishing and used in lists
data.locations[].locationAddressstringNoExtra location detail: a country, state, city or full address. Display only
timestampintegerYes—

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