Brave Search Place Search

6 credits/call
ae_bravesearch_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.

Maps
6 credits/call

Pricing

6 credits/call
ConditionCharge
Each call6 credits/call

Each place search call has a fixed charge of 6 credits.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
qstringNo地点名称或类别,例如coffee shops;省略时探索指定区域。—
countintegerNo最多返回的地点数。20
unitsenum (metric | imperial)No距离单位制。metric
radiusnumberNo中心附近的搜索偏向,单位米;不是严格的范围过滤。—
countrystringNo搜索市场的两字母国家代码,例如US。—
ui_langstringNo界面语言地区代码,例如en-US。—
latitudenumberNo中心纬度;与longitude一起提供。—
locationstringNo地点文字,替代经纬度,例如san francisco ca united states或tokyo japan。—
longitudenumberNo中心经度;与latitude一起提供。—
safesearchenum (off | moderate | strict)No安全搜索级别。strict
spellcheckbooleanNo是否纠正搜索词。true
search_langstringNo搜索语言代码,例如en、zh-hans或zh-hant;不是zh-CN。—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.