Places for a post

Search places to tag on a post.

GETapi.tikultra.com/v1/account/upload/places15 credits

Upstream: /tiktok/poi/api/place/search
Access: Growth and up
Runs on: FullPool
Billing: Failed calls are free

Authorization

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Query parameters

account_idstringrequired

A connected account, from /dash/sessions or POST /v1/account/import. For example acc_7Hq2.

keywordstringrequired

What to search for. For example miami beach.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.

cURLPythonNode.js

curl -G https://api.tikultra.com/v1/account/upload/places \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "account_id=acc_7Hq2" \
  --data-urlencode "keyword=miami beach"

Try ituses 15 credits

Run this endpoint with your own key in the dashboard playground. Every response shows its cost.

Open in playground

200 · sample

{
  "keyword": "miami beach",
  "items": [
    {
      "poi_id": "22535865203049849",
      "name": "Wynwood Walls",
      "address": "2516 NW 2nd Ave, Miami, FL"
    },
    {
      "poi_id": "22535865203049850",
      "name": "South Pointe Park Pier",
      "address": "1 Washington Ave, Miami Beach, FL"
    }
  ]
}