# Public API Examples

All examples below are public-safe and use the read-only HTTP interface.

## 1. List all service types
```txt
GET /api/public/service-types
```

## 2. List all services in landscape design
```txt
GET /api/public/services?serviceType=landscape-design
```

## 3. List cities in Salt Lake County
```txt
GET /api/public/service-areas?level=city&parent=salt-lake-county
```

## 4. Get photos for site preparation in Salt Lake City
```txt
GET /api/public/photos?service=site-preparation&area=salt-lake-city&limit=6
```

## 5. Get FAQs for sprinkler installation in Salt Lake City
```txt
GET /api/public/faqs?service=sprinkler-installation&area=salt-lake-city
```

## 6. Get project summaries for Murray
```txt
GET /api/public/projects?city=Murray&limit=6
```

## 7. Get provider context for concrete contractors in Draper
```txt
GET /api/public/provider-context?service=concrete-contractors&city=Draper
```

## 8. Get broader insights for landscape architecture in Salt Lake City
```txt
GET /api/public/insights?service=landscape-architecture&area=salt-lake-city
```

## 9. Discover the machine-readable contract
```txt
GET /api/public/openapi.json
```

## 10. Discover all supported capabilities
```txt
GET /api/public/index
```