Example: Find Nearby Restaurants

Example • beginner • places

Find nearby restaurants

Start with a concrete places workflow that helps users discover restaurants quickly without reading a wall of docs first.

Public discovery Requires API key Paid route MCP-ready Not legal advice

Title

Find nearby restaurants

Problem solved

Find dining options in a covered metro using source-aware places data.

Required route or routes

GET /v1/coverage/regions, GET /v1/agent/context/{location_id}, GET /v1/places/search

Auth expectation

Coverage and context are public discovery. /v1/places/search requires X-API-Key with places:read.

Request snippet

curl

curl -H "X-API-Key: $SMARTAPIS_API_KEY" \
  "https://smartapis.net/v1/places/search?region_id=greater-montreal&q=restaurant&limit=5"

Response snippet

{
  "items": [{
    "place_id": "place_mtl_001",
    "display_name": "Cafe Demo",
    "region_id": "greater-montreal",
    "category": "restaurant",
    "source_dataset_id": "dataset_places_mtl_001"
  }],
  "count": 1
}

Next step

Add proximity ranking with GET /v1/places/nearby or move to the MCP usage example.

Caveats / legal posture

Informational only. Preserve attribution and legal-review fields in downstream summaries.