Gets list of archived livestreams

GET /history

Gets list of archived livestreams

Query parameters

  • page integer(int32)

    Page to display

  • limit integer(int32)

    Amount of livestreams to display per page

  • sort string

    Sort direction of results

    Values are asc or desc.

  • unfinished boolean

    Whenever unfinished livestreams (live or upcoming) should be displayed

Responses

  • OK

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes array[object]
    • id string Required

      Video ID

    • submitters array[string] Required

      List of user IDs which have submitted this video to the queue (Format: Provider/UserID)

    • scheduledStart string(date-time) Required

      Scheduled start of livestream

    • finished boolean Required

      Whenever the livestream has finished already

    • title string Required

      Livestream title

    • channelName string Required

      Name of channel which is streaming this livestream

    • channelId string Required

      Channel ID of channel which is streaming this livestream

    • thumbnail string Required

      URL to maximum quality thumbnail available for livestream

    • URL where archive is available for download

    • fileSizeBytes integer(int64)

      Archive file size in bytes

    • length integer(int32)

      Length of livestream in seconds

GET /history
curl \
 -X GET https://pomu.app/api/history
Response examples (200)
# Headers
X-Pomu-Pagination-Total: 42
X-Pomu-Pagination-Has-More: true

# Payload
[
  {
    "id": "string",
    "submitters": [
      "string"
    ],
    "scheduledStart": "2023-05-04T09:42:00+00:00",
    "finished": true,
    "title": "string",
    "channelName": "string",
    "channelId": "string",
    "thumbnail": "string",
    "downloadUrl": "string",
    "fileSizeBytes": 42,
    "length": 42
  }
]
Response examples (200)
# Headers
X-Pomu-Pagination-Total: 42
X-Pomu-Pagination-Has-More: true

# Payload
[
  {
    "id": "string",
    "submitters": [
      "string"
    ],
    "scheduledStart": "2024-05-04T09:42:00+00:00",
    "finished": true,
    "title": "string",
    "channelName": "string",
    "channelId": "string",
    "thumbnail": "string",
    "downloadUrl": "string",
    "fileSizeBytes": 42,
    "length": 42
  }
]