Read-only JSON over the live directory. No auth. Rate limit: 60/min per IP. AI agents: prefer the MCP server (structured tools); this HTTP API is for clients that can't speak MCP.
GET /api/v1/search| Param | Notes |
|---|---|
q | required. Free text, e.g. vegetarian thali |
city, state | optional location filter (e.g. state=NJ) |
vertical | optional — scope to one category (restaurants, temples, groceries, professionals, salons, events, apparel, sweets, studios, services, community, legal, education, realestate, finance) |
lat, lng | optional — enables proximity ranking + distance_miles |
limit | optional, 1–50 (default 20) |
curl "https://namasteamerica.us/api/v1/search?q=south+indian+breakfast&state=NJ&limit=5"
{
"query": "south indian breakfast",
"count": 5,
"ranking": "vector",
"results": [
{"vertical": "restaurants", "name": "Dosa Hut", "city": "Edison", "state": "NJ",
"phone": "+1 732 555 0100", "website": "https://...", "rating": 4.6,
"latitude": 40.5, "longitude": -74.3, "verified_ago": "verified 3 days ago"}
]
}
GET /api/v1/verticalsLists the category keys you can pass to ?vertical=.
AI agents: see /for-agents (MCP + setup) · machine spec /openapi.json · /llms.txt · chat · browse