eternalsocial.dev
YouTube

Get YouTube shorts from a channel

POST
/api/youtube/shorts

Authorization

bearerAuth
AuthorizationBearer <token>

JWT token from /auth/login or API key from /keys

In: header

Request Body

application/json

channelUrl*string
Formaturi
oldestDate?number

Filter shorts until this timestamp (milliseconds)

webhookUrl?string

Webhook URL to receive results. If provided, request returns immediately.

Formaturi

Response Body

application/json

application/json

application/json

curl -X POST "http://localhost:3222/api/youtube/shorts" \  -H "Content-Type: application/json" \  -d '{    "channelUrl": "https://www.youtube.com/@MrBeast"  }'
{
  "success": true,
  "requestId": "string",
  "data": {
    "channel": {
      "kind": "string",
      "etag": "string",
      "id": "string",
      "snippet": {
        "title": "string",
        "description": "string",
        "customUrl": "string",
        "publishedAt": "string",
        "thumbnails": {
          "default": {
            "url": "string",
            "width": 0,
            "height": 0
          },
          "medium": {
            "url": "string",
            "width": 0,
            "height": 0
          },
          "high": {
            "url": "string",
            "width": 0,
            "height": 0
          },
          "standard": {
            "url": "string",
            "width": 0,
            "height": 0
          },
          "maxres": {
            "url": "string",
            "width": 0,
            "height": 0
          }
        },
        "defaultLanguage": "string",
        "localized": {
          "title": "string",
          "description": "string"
        },
        "country": "string"
      },
      "statistics": {
        "viewCount": "string",
        "subscriberCount": "string",
        "hiddenSubscriberCount": true,
        "videoCount": "string"
      },
      "brandingSettings": {
        "channel": {
          "title": "string",
          "description": "string",
          "keywords": "string",
          "trackingAnalyticsAccountId": "string",
          "moderateComments": true,
          "unsubscribedTrailer": "string",
          "defaultLanguage": "string",
          "country": "string"
        },
        "image": {
          "bannerExternalUrl": "string"
        }
      }
    },
    "shorts": [
      {
        "kind": "string",
        "etag": "string",
        "id": "string",
        "snippet": {
          "publishedAt": "string",
          "channelId": "string",
          "title": "string",
          "description": "string",
          "thumbnails": {
            "default": {
              "url": "string",
              "width": 0,
              "height": 0
            },
            "medium": {
              "url": "string",
              "width": 0,
              "height": 0
            },
            "high": {
              "url": "string",
              "width": 0,
              "height": 0
            },
            "standard": {
              "url": "string",
              "width": 0,
              "height": 0
            },
            "maxres": {
              "url": "string",
              "width": 0,
              "height": 0
            }
          },
          "channelTitle": "string",
          "tags": [
            "string"
          ],
          "categoryId": "string",
          "liveBroadcastContent": "string",
          "defaultLanguage": "string",
          "localized": {
            "title": "string",
            "description": "string"
          },
          "defaultAudioLanguage": "string"
        },
        "statistics": {
          "viewCount": "string",
          "likeCount": "string",
          "dislikeCount": "string",
          "favoriteCount": "string",
          "commentCount": "string"
        },
        "shortUrl": "string"
      }
    ]
  },
  "itemCount": 0,
  "creditsCharged": 0
}
{
  "success": true,
  "requestId": "string",
  "status": "processing",
  "message": "string"
}
{
  "success": false,
  "error": "string",
  "requestId": "string"
}