Places Search — Find restaurants, shops & venues worldwide

Tools / Places Search

Search Places

Search for places by name, type, or category with optional location filtering

Returns: Array of places with name, address, coordinates, categories, rating, price level, and source

Parameters

query *stringWhat to search for — e.g. "sushi restaurants", "coffee shops", "hotels"

locationstringCity name like "London, UK" or coordinates like "51.5074,-0.1278"

radius_metersnumberSearch radius in meters (default: 10000)

limitnumberMax results to return (default: 10, max: 20)

open_nowbooleanOnly return places that are currently open

sortstringSort order for results

min_pricenumberMinimum price level (1-4)

max_pricenumberMaximum price level (1-4)

Example

Find sushi restaurants in London

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "places-search",
  "skill": "search_places",
  "input": {
    "query": "sushi restaurants",
    "location": "London, UK"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Nearby Places

Find places near specific coordinates with optional category filtering

Returns: Array of nearby places with name, address, coordinates, categories, rating, and distance

Parameters

latitude *numberLatitude of the center point

longitude *numberLongitude of the center point

radius_metersnumberSearch radius in meters (default: 1000)

categorystringCategory to filter by — e.g. "restaurant", "hotel", "cafe", "pharmacy"

limitnumberMax results to return (default: 10, max: 20)

Example

Find restaurants near Times Square

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "places-search",
  "skill": "nearby_places",
  "input": {
    "latitude": 40.758,
    "longitude": -73.9855,
    "category": "restaurant",
    "limit": 5
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Place Details

Get full details for a specific place including reviews, hours, and contact info

Returns: Full place details including name, address, hours, phone, website, reviews, and rating

Parameters

place_id *stringPlace ID from a previous search result (Foursquare fsq_id or Google place_id)

sourcestringWhich source the ID is from (auto-detected if omitted)

Example

Get details for a Foursquare place

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "places-search",
  "skill": "place_details",
  "input": {
    "place_id": "4b7b5ee0f964a52004432fe3"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"places-search","skill":"search_places","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

Can I search by city name, place type, or exact coordinates?

Yes. `search_places` supports text queries with an optional city or coordinate-based location, while `nearby_places` is for radius searches around exact latitude and longitude coordinates.

What details come back in search results?

Search results include the place name, address, coordinates, categories, rating, price level, and source. If you need deeper information like hours, phone, website, and reviews, open the place with `place_details`.

Can I filter for open places, price range, or distance?

Yes. The search flow supports open-now filtering, radius controls, sorting, and minimum or maximum price levels, which makes it practical for local discovery rather than just broad lookup.

Do I need a source-specific ID to get full place details?

Only for the final details lookup. Search results give you the place ID, and `place_details` can use that ID with auto-detection or an explicit source when you already know it comes from Foursquare or Google.