Own PeerTube? Customize your docs with AI search, analytics, and more.

Claim your docs

PeerTube

GET

Search videos

https://peertube2.cpy.re/api/v1/search/videos

Access Token Required: API Key

Query Params

searchstringrequired

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete video information and interact with it.

startDatestring

Get videos that are published after this date

endDatestring

Get videos that are published before this date

originallyPublishedStartDatestring

Get videos that are originally published after this date

originallyPublishedEndDatestring

Get videos that are originally published before this date

durationMininteger

Get videos that have this minimum duration

durationMaxinteger

Get videos that have this maximum duration

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://peertube2.cpy.re/api/v1/search/videos' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET