Tencent Maps Search
Search Tencent Maps for places in one city by name or type, including restaurants, cafes, shopping malls, and attractions. Results can include addresses, coordinates, map links, ratings, and opening hours. Some businesses have average spend and a Dianping shop ID. Optional Tencent Maps review samples include publication dates; their recency varies.
Pricing
A successful call costs 6 credits plus 3.99 per result returned. Round the total once: to two decimal places below 10 credits and to one decimal place at 10 credits or more. Zero results cost 6 credits and three results cost 18 credits.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
city | string | Yes | 要搜索的城市。一次搜索一个城市,例如「成都」或「景德镇」。 | — |
keyword | string | Yes | 输入地点名、地标名或品类,例如「陈麻婆豆腐」「川菜」「博物馆」。关键词匹配可能返回相近品类。 | — |
max_results | integer | No | 最多返回多少个地点。取值 1–10,默认 10。实际返回数可能少于上限,也可能为 0。按实际返回条数计费,成功返回空列表收取 6 积分。 | 10 |
max_reviews | integer | No | 每个地点最多返回多少条评价样本。取值 0–10,默认 5。设为 0 可跳过评价。可根据返回的发布日期判断评价时效。 | 5 |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tencent_maps_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"city": "xxx",
"keyword": "xxx"
}
}'No response example available yet.



