v8

latestOpenAPI 3.1.0Proprietary2026-08-081,5483,1755.5 MB
Environment

Retail shops near a point by shop type

Return OpenStreetMap shop elements (shop=<type>) within a radius of a lat/lon centre. Covers common retail categories (supermarket, convenience, clothes, electronics, books, bakery, butcher, bicycle, jewelry, ...). Radius is capped at 5 km. Data is (C) OpenStreetMap contributors (ODbL 1.0) - attribution is required on any surface that renders this data.

get/api/v1/environment/osm/shops

Query parameters

latnumber required

Query centre latitude in decimal degrees (WGS84).

Query centre latitude in decimal degrees (WGS84).

lonnumber required

Query centre longitude in decimal degrees (WGS84).

Query centre longitude in decimal degrees (WGS84).

radius_minteger

Search radius in metres (100 to 5000).

Search radius in metres (100 to 5000).

shop_typestring required

Retail category. Accepted values: alcohol, bakery, beauty, bicycle, books, butcher, car, clothes, computer, convenience, department_store, electronics, florist, furniture, greengrocer, hairdresser, hardware, jewelry, kiosk, mall, mobile_phone, optician, pet, shoes, sports, supermarket, toys.

Retail category. Accepted values: alcohol, bakery, beauty, bicycle, books, butcher, car, clothes, computer, convenience, department_store, electronics, florist, furniture, greengrocer, hairdresser, hardware, jewelry, kiosk, mall, mobile_phone, optician, pet, shoes, sports, supermarket, toys.

limitinteger

Maximum number of elements to return (1-500).

Maximum number of elements to return (1-500).

Response

Shop elements near the requested point, (C) OpenStreetMap contributors (ODbL 1.0).

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}