# Video chapters of podcast feeds

`GET /feeds/podcast/video-chapters.json`

**PeerTube >= 9.0** Chapters of a video in the Podcasting 2.0 JSON format, referenced by the `podcast:chapters` tag of podcast feed items.
See https://podcasting2.org/docs/podcast-namespace/tags/chapters


Authentication: no security requirement declared for this operation.

Parameters:

- `videoId` (query, string, required) - The video id, uuid or short uuid
  Type: string

Responses:

- 200: successful operation

Content type: application/json+chapters

Type: PodcastChapters

Podcasting 2.0 JSON chapters, see https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/examples/chapters/jsonChapters.md

Schema: [PodcastChapters](https://sourcey-peertube.pages.dev/api-rest-reference/models/podcastchapters.md)

- `version` (optional)
  Type: string
  
  Example:
  
  ```json
  "1.2.0"
  ```

- `chapters` (optional)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `startTime` (optional)
      Type: integer
      
      Start of the chapter, in seconds
    
    - `title` (optional)
      Type: string

Content type: application/json

Type: PodcastChapters

Podcasting 2.0 JSON chapters, see https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/examples/chapters/jsonChapters.md

Schema: [PodcastChapters](https://sourcey-peertube.pages.dev/api-rest-reference/models/podcastchapters.md)

- `version` (optional)
  Type: string
  
  Example:
  
  ```json
  "1.2.0"
  ```

- `chapters` (optional)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `startTime` (optional)
      Type: integer
      
      Start of the chapter, in seconds
    
    - `title` (optional)
      Type: string

- 404: video not found

- 406: accept header unsupported

## Examples

### cURL

```bash
curl -X GET 'https://peertube2.cpy.re/feeds/podcast/video-chapters.json?videoId=string'
```

### JavaScript

```javascript
const response = await fetch('https://peertube2.cpy.re/feeds/podcast/video-chapters.json?videoId=string', {
  method: 'GET',
});

const data = await response.text();
```

### Python

```python
import requests

response = requests.get('https://peertube2.cpy.re/feeds/podcast/video-chapters.json?videoId=string')
print(response.text)
```