joshu

Find places that match intents near a location

From Atly, through Joshu Data Bodega.

Part of Places (local search) search intent.

Price
$0 per call

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

  • latnumber, optional

    With lon (and optionally radius_km) instead of area_id.

  • lonnumber, optional

  • limitinteger, optional

    Places to return.

  • area_idstring, optional

    Up to 120 characters. An area id from atly.places.areas, or a city name such as "Austin" or "Boise, ID". Give this or lat and lon, not both.

  • radius_kmnumber, optional

    Search radius around lat/lon in km, held to 0.2-50.

  • categoriesstring, required

    1-5 category names or ids from atly.places.categories, most important first. A name must be exact; a near miss is refused with the close matches. Every result matches all of them; if none does, trailing ones are dropped (never the first) and dropped_categories names them.

  • place_typestring, optional

    Words matched as whole words against each place's Google place types, e.g. ["restaurant"]. Google's types are literal: for cafes pass ["cafe", "coffee"]. Use it for a kind of venue, not a dish or a feature.

Call it

Router call with a router API key
curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "atly.places.search.intent",
    "params": {
      "limit": 1,
      "area_id": "<area ID>",
      "categories": [
        "69e178c3-14be-11ee-a9cb-614c6a0a867a"
      ]
    }
  }'