# Search Business locations

- API version: 1.11.0
- Last updated: 2026-11-16
- Server: `https://api.ailingtu.com`
- Web document: [Search Business locations](/en/openapi/business-locations)
- Full schema: [JSON Schema](/en/openapi/operations/searchTikTokBusinessLocations.json)
- Discovery: [Operation index](/en/openapi/operations/index.json)

## GET /v1/creator/tiktokBusiness/searchLocation

Operation ID: `searchTikTokBusinessLocations`

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).

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.

### Request parameters

| Field | Location | Type | Required | Description |
|---|---|---|---|---|
| `id` | query | integer | Yes | Creator account ID |
| `searchQuery` | query | string | Yes | Location query, up to 100 characters |

### Success response

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "locations": [
      {
        "locationId": "loc-1",
        "locationName": "City of London, United Kingdom",
        "locationAddress": "London, United Kingdom"
      }
    ]
  },
  "timestamp": 1790640000000
}
```

### Response fields

Main levels are listed below. The endpoint JSON Schema is authoritative for the full structure, unions and validation rules; Required refers to 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 | — |

### Integration notes and limits

- 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).

### Related endpoints

- [Create a publishing task](/en/openapi/create-post) · [Markdown](/en/openapi/operations/createCreatorPost.md)
- [Update a publishing task](/en/openapi/update-post) · [Markdown](/en/openapi/operations/updateCreatorPost.md)
