Docs menu

TikTok API endpoint

Search TikTok places API

Returns TikTok's place (POI) search results for a keyword, unmodified: each row carries `poi_name`, `poi_id`, `poi_type`, `video_count`, `poi_rating`, `poi_distance`, `poi_location`, `lat`/`lng`, `img_url`, `opening_time`, `price_level` and `parent_poi`. Useful for mapping a location or category to the places TikTok knows about, and for seeing how many videos each place carries. `keyword` is required. The page is capped at 10 rows upstream and this route is first-page-only — the returned `cursor` is not a reusable page token.

GETapiKey8 credits/requestTikToktiktokmobile.searchPlaceResponseDoc/tiktok/mobile/search/place

Endpoint facts

Method: GET
API path: /tiktok/mobile/search/place
Auth: apiKey
Credits: 8 credits/request
Charged on: Successful 2xx responses only
Platform: TikTok
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/tiktokmobile.searchPlaceResponseDoc

TikTok scraping API Try Search TikTok places API in Playground TikTok API documentation

How this endpoint behaves

Measured device-free on the core edge/origin pair: keyword=pizza&count=10 → HTTP 200, 51,251 B, status_code: 0, poi_info.poi_info with 10 rows (first: Tasty Pizza).

Query parameters:

keyword: required. The place name or category to search for. The bare call returns a 150-byte empty envelope, so the keyword gates usefulness rather than whether the call succeeds.
count: optional. Honoured downward: count=3, 5 and 10 return exactly that many rows. The upstream caps the page at 10, so count=30 still returns 10 — there is no larger page.

Notes:

First-page-only. The envelope returns cursor: 10, has_more: 1, but that value is not a usable page token: feeding it back (cursor=10) returns an empty page, offset=10 returns an empty page, and page=2 is ignored and silently re-serves page 1. This endpoint therefore exposes no cursor. Do not build paging on it until a live capture shows the real paging parameter.
Rows are returned opaque ([]any) rather than coerced into a fixed struct, so a richer POI object never loses fields.
Place results are region-sensitive: the device's declared region shapes which places exist, so the same keyword can return different results from a different egress.

Request parameters

Parameter	Type	Required	Description	Example
x-api-key (header)	string	Yes	API key required
keyword	string	Yes	Place name or category to search for	pizza
count	integer	No	Rows to return; the upstream caps the page at 10 regardless

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/search/place?keyword=pizza&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "poi_info": {
      "poi_info": [
        {
          "poi_name": "Tasty Pizza",
          "poi_id": "20442395079921519",
          "poi_type": 2,
          "video_count": 12,
          "poi_rating": 4.5,
          "poi_distance": "example",
          "poi_location": {
            "city": "example",
            "address": "example"
          },
          "lat": 0,
          "lng": 0,
          "img_url": "https://example.invalid/poi.jpg",
          "opening_time": "example",
          "price_level": 2,
          "parent_poi": null
        }
      ]
    },
    "cursor": 10,
    "has_more": 1,
    "feedback_type": "",
    "status_code": 0,
    "status_msg": "",
    "extra": null,
    "log_pb": null
  }
}

Request schema

No body schema

Response schema

#/definitions/tiktokmobile.searchPlaceResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tiktokmobile.SearchPlaceResponse	No
data.cursor	integer	No
data.extra	unknown	No
data.feedback_type	string	No
data.has_more	boolean	No
data.log_pb	unknown	No
data.poi_info	tiktokmobile.PlacePOIContainer	No
data.poi_info.poi_info	array	No
data.status_code	integer	No
data.status_msg	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Invalid input	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/search/place?keyword=pizza&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More TikTok endpoint docs TikTok scraping API List TikTok explore categories API documentation Retrieve TikTok video comments API documentation TikTok Creative Center Filters API documentation TikTok Creative Center Hashtags API documentation TikTok Creative Center Top Content API documentation TikTok Creative Center Videos API documentation

Open in Playground Back to group

Docs menu

TikTok API endpoint

Search TikTok places API

GETapiKey8 credits/requestTikToktiktokmobile.searchPlaceResponseDoc/tiktok/mobile/search/place

Endpoint facts

Method: GET
API path: /tiktok/mobile/search/place
Auth: apiKey
Credits: 8 credits/request
Charged on: Successful 2xx responses only
Platform: TikTok
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/tiktokmobile.searchPlaceResponseDoc

TikTok scraping API Try Search TikTok places API in Playground TikTok API documentation

How this endpoint behaves

Measured device-free on the core edge/origin pair: keyword=pizza&count=10 → HTTP 200, 51,251 B, status_code: 0, poi_info.poi_info with 10 rows (first: Tasty Pizza).

Query parameters:

keyword: required. The place name or category to search for. The bare call returns a 150-byte empty envelope, so the keyword gates usefulness rather than whether the call succeeds.
count: optional. Honoured downward: count=3, 5 and 10 return exactly that many rows. The upstream caps the page at 10, so count=30 still returns 10 — there is no larger page.

Notes:

First-page-only. The envelope returns cursor: 10, has_more: 1, but that value is not a usable page token: feeding it back (cursor=10) returns an empty page, offset=10 returns an empty page, and page=2 is ignored and silently re-serves page 1. This endpoint therefore exposes no cursor. Do not build paging on it until a live capture shows the real paging parameter.
Rows are returned opaque ([]any) rather than coerced into a fixed struct, so a richer POI object never loses fields.
Place results are region-sensitive: the device's declared region shapes which places exist, so the same keyword can return different results from a different egress.

Request parameters

Parameter	Type	Required	Description	Example
x-api-key (header)	string	Yes	API key required
keyword	string	Yes	Place name or category to search for	pizza
count	integer	No	Rows to return; the upstream caps the page at 10 regardless

cURL example

curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/search/place?keyword=pizza&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "poi_info": {
      "poi_info": [
        {
          "poi_name": "Tasty Pizza",
          "poi_id": "20442395079921519",
          "poi_type": 2,
          "video_count": 12,
          "poi_rating": 4.5,
          "poi_distance": "example",
          "poi_location": {
            "city": "example",
            "address": "example"
          },
          "lat": 0,
          "lng": 0,
          "img_url": "https://example.invalid/poi.jpg",
          "opening_time": "example",
          "price_level": 2,
          "parent_poi": null
        }
      ]
    },
    "cursor": 10,
    "has_more": 1,
    "feedback_type": "",
    "status_code": 0,
    "status_msg": "",
    "extra": null,
    "log_pb": null
  }
}

Request schema

No body schema

Response schema

#/definitions/tiktokmobile.searchPlaceResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tiktokmobile.SearchPlaceResponse	No
data.cursor	integer	No
data.extra	unknown	No
data.feedback_type	string	No
data.has_more	boolean	No
data.log_pb	unknown	No
data.poi_info	tiktokmobile.PlacePOIContainer	No
data.poi_info.poi_info	array	No
data.status_code	integer	No
data.status_msg	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Invalid input	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/tiktok/mobile/search/place?keyword=pizza&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Search TikTok places API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Search TikTok places API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related