> For the complete documentation index, see [llms.txt](https://docs.autocontentapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autocontentapi.com/readme/public.md).

# Public

## Get all public podcasts

> Publicly retrieve all public podcasts without requiring authentication (transcript excluded for performance)

```json
{"openapi":"3.0.0","info":{"title":"Content API","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.autocontentapi.com"}],"paths":{"/public/podcasts":{"get":{"summary":"Get all public podcasts","description":"Publicly retrieve all public podcasts without requiring authentication (transcript excluded for performance)","tags":["Public"],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"categoryId":{"type":"integer"},"audioUrl":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"imageUrl":{"type":"string"},"quizUrl":{"type":"string","nullable":true},"infographicUrl":{"type":"string","nullable":true},"slideDeckUrl":{"type":"string","nullable":true},"videoExplainerUrl":{"type":"string","nullable":true},"videoExplainerPosterUrl":{"type":"string","nullable":true},"fileSize":{"type":"integer"},"durationSeconds":{"type":"integer"}}}}}}}}},"500":{"description":"Internal server error"}}}}}}
```

## Get public podcasts by category

> Publicly retrieve public podcasts filtered by category ID without requiring authentication (transcript excluded for performance)

```json
{"openapi":"3.0.0","info":{"title":"Content API","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.autocontentapi.com"}],"paths":{"/public/podcasts/category/{categoryId}":{"get":{"summary":"Get public podcasts by category","description":"Publicly retrieve public podcasts filtered by category ID without requiring authentication (transcript excluded for performance)","tags":["Public"],"parameters":[{"in":"path","name":"categoryId","required":true,"schema":{"type":"integer"},"description":"The category ID to filter podcasts by"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"categoryId":{"type":"integer"},"audioUrl":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"imageUrl":{"type":"string"},"quizUrl":{"type":"string","nullable":true},"infographicUrl":{"type":"string","nullable":true},"slideDeckUrl":{"type":"string","nullable":true},"videoExplainerUrl":{"type":"string","nullable":true},"videoExplainerPosterUrl":{"type":"string","nullable":true},"fileSize":{"type":"integer"},"durationSeconds":{"type":"integer"}}}}}}}}},"400":{"description":"Bad Request - Invalid categoryId parameter"},"500":{"description":"Internal server error"}}}}}}
```

## Get a single public podcast with full details

> Publicly retrieve a single public podcast by ID with full details including transcript

```json
{"openapi":"3.0.0","info":{"title":"Content API","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.autocontentapi.com"}],"paths":{"/public/podcasts/{id}":{"get":{"summary":"Get a single public podcast with full details","description":"Publicly retrieve a single public podcast by ID with full details including transcript","tags":["Public"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"The podcast ID"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"categoryId":{"type":"integer"},"audioUrl":{"type":"string"},"title":{"type":"string"},"transcript":{"type":"string"},"summary":{"type":"string"},"imageUrl":{"type":"string"},"quizUrl":{"type":"string","nullable":true},"fileSize":{"type":"integer"},"durationSeconds":{"type":"integer"},"slug":{"type":"string"}}}}}}}},"400":{"description":"Bad Request - Invalid id parameter"},"404":{"description":"Podcast not found"},"500":{"description":"Internal server error"}}}}}}
```

## Get a single public podcast by slug with full details

> Publicly retrieve a single public podcast by slug with full details including transcript

```json
{"openapi":"3.0.0","info":{"title":"Content API","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.autocontentapi.com"}],"paths":{"/public/podcasts/slug/{slug}":{"get":{"summary":"Get a single public podcast by slug with full details","description":"Publicly retrieve a single public podcast by slug with full details including transcript","tags":["Public"],"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"},"description":"The podcast slug"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"id":{"type":"string"},"categoryId":{"type":"integer"},"audioUrl":{"type":"string"},"title":{"type":"string"},"transcript":{"type":"string"},"summary":{"type":"string"},"imageUrl":{"type":"string"},"quizUrl":{"type":"string","nullable":true},"fileSize":{"type":"integer"},"durationSeconds":{"type":"integer"},"slug":{"type":"string"}}}}}}}},"400":{"description":"Bad Request - Invalid slug parameter"},"404":{"description":"Podcast not found"},"500":{"description":"Internal server error"}}}}}}
```
