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());