Guide

Build a restaurant finder agent

This is the shortest public path from discovery to a useful places query in a supported metro.

1. Confirm city coverage

Make sure the metro is available before you do anything authenticated.

curl

curl https://smartapis.net/v1/coverage/regions

2. Read agent context

Location context helps an agent reason about density and supported modules.

curl

curl https://smartapis.net/v1/agent/context/new-york-city

Python

import urllib.request

with urllib.request.urlopen("https://smartapis.net/v1/agent/context/new-york-city", timeout=30) as resp:
    print(resp.read().decode("utf-8"))

JavaScript

const response = await fetch('https://smartapis.net/v1/agent/context/new-york-city');
console.log(await response.json());

3. Query places

Use a client key with `places:read` to retrieve restaurant-like results.

curl

curl -H "X-API-Key: $SMARTAPIS_API_KEY" \
  "https://smartapis.net/v1/places?region_id=new-york-city&q=pizza&limit=3"

Python

import os, urllib.parse, urllib.request

params = urllib.parse.urlencode({"region_id": "new-york-city", "q": "pizza", "limit": 3})
request = urllib.request.Request(
    f"https://smartapis.net/v1/places?{params}",
    headers={"X-API-Key": os.environ["SMARTAPIS_API_KEY"]},
)
with urllib.request.urlopen(request, timeout=30) as resp:
    print(resp.read().decode("utf-8"))

JavaScript

const response = await fetch(
  'https://smartapis.net/v1/places?region_id=new-york-city&q=pizza&limit=3',
  { headers: { 'X-API-Key': process.env.SMARTAPIS_API_KEY } }
);
console.log(await response.json());