---
title: "Search TikTok location tags"
method: GET
path: "/api/v1/misc/tiktok/locations"
tags: ["misc"]
---

# Search TikTok location tags

`GET /api/v1/misc/tiktok/locations`

## Request

- Base URL: `https://api.bundle.social`
- URL: `https://api.bundle.social/api/v1/misc/tiktok/locations`
- Auth: API key in header `x-api-key`

Searches location tags available to the connected TikTok account (up to 20 results). Pass `locationId` and `name` as data.TIKTOK.locationId and data.TIKTOK.locationName to show the location on a video or photo post.

## Query parameters

- `teamId` string, required
- `q` string, required

## Response `200`

200

- object
  - `items` object[], required
    - `locationId` string, required: Location tag ID to pass as data.TIKTOK.locationId.
    - `name` string, required: Location name to pass as data.TIKTOK.locationName.
    - `address` string, nullable: Extra location details. Can be a country, a region, a city or a full street address.

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429
- `500`: 500
- `502`: 502
- `503`: 503
- `504`: 504

## Changes

- **2026-11-03** `18efa1cb93a4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bundle/apis/bundle-social-api/changes/api/v1/misc/tiktok/locations/get.md)

---

[API](https://skmtc.dev/bundle/apis/bundle-social-api.md) - [All operations](https://skmtc.dev/bundle/apis/bundle-social-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bundle/apis/bundle-social-api/revisions/18efa1cb93a4?raw)
