Brave Search Place Search
Search for businesses and landmarks by name, category, or location. Enter a name or category in `q`, use `location` for a text location, or provide both `latitude` and `longitude` for a center point. Omit `q` to explore the specified area. `radius` (meters) biases results toward the center; it is not a strict distance filter. Results can include place IDs, names, coordinates, addresses, and available phone numbers, opening hours, ratings, and photos. Place IDs are valid for about eight hours and can be used to look up details or an AI-generated description.
Pricing
| Condition | Charge |
|---|---|
| Each call | 6 credits/call |
Each place search call has a fixed charge of 6 credits.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | No | 地点名称或类别,例如coffee shops;省略时探索指定区域。 | — |
count | integer | No | 最多返回的地点数。 | 20 |
units | enum (metric | imperial) | No | 距离单位制。 | metric |
radius | number | No | 中心附近的搜索偏向,单位米;不是严格的范围过滤。 | — |
country | string | No | 搜索市场的两字母国家代码,例如US。 | — |
ui_lang | string | No | 界面语言地区代码,例如en-US。 | — |
latitude | number | No | 中心纬度;与longitude一起提供。 | — |
location | string | No | 地点文字,替代经纬度,例如san francisco ca united states或tokyo japan。 | — |
longitude | number | No | 中心经度;与latitude一起提供。 | — |
safesearch | enum (off | moderate | strict) | No | 安全搜索级别。 | strict |
spellcheck | boolean | No | 是否纠正搜索词。 | true |
search_lang | string | No | 搜索语言代码,例如en、zh-hans或zh-hant;不是zh-CN。 | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_bravesearch_place_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"count": 3,
"latitude": 37.7749,
"longitude": -122.4194,
"q": "coffee shops",
"radius": 1000
}
}'{
"location": {
"coordinates": [
37.77493
],
"country": "US",
"name": "San Francisco"
},
"mixed": [
{
"all": false,
"index": 0,
"type": "results"
}
],
"results": [
{
"categories": [
"restaurant"
],
"contact": {
"telephone": "+16288677985"
},
"coordinates": [
37.7733151
],
"family_friendly": true,
"id": "loc4MEADZ7P34JBEAOEU5O34BGS6YB7UOV4FAAAAAAA=",
"title": "Doppio Coffee & Brunch"
}
],
"type": "locations"
}This example shows part of the response. Copied content is valid JSON.


