Endpoint Playground
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.
curl 'https://api.crawlora.net/api/v1/tiktok/mobile/search/place?keyword=pizza' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| keyword | string | Yes | pizza | Place name or category to search for |
| count | integer | No | Rows to return; the upstream caps the page at 10 regardless |
{
"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
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.