Ir al contenido
Documentación de Endless

YouTube channel videos

POST
/social/youtube_channel_videos

Get a channel's long-form uploads with view counts, length, and publish dates. Use when asked what a channel has posted or for its top/most-viewed videos (sort_by:'popular'). For a date range pass since: the listing cards are sparse, so each video is then fetched individually to get its date and counts — accurate, but one call per video, so keep the window tight. Pair since with until and the tool returns a totals block computed over exactly that window — quote it, never add up the rows yourself. Read coverage before reporting totals. For Shorts use youtube_channel_shorts.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT token from authentication

In: header

Header Parameters

Endless-Api-Version?string

Pin the caller to an API major (1). Omit to accept the current version. A major this deployment cannot serve is refused with 400 unsupported_api_version.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/social/youtube_channel_videos" \  -H "Content-Type: application/json" \  -d '{    "organization_id": "string",    "input": {      "channel": "string"    }  }'
{  "operation": "instagram_profile",  "result": {    "summary": "string",    "channel": "string",    "count": -9007199254740991,    "totals": {      "window": {        "since": "string",        "until": "string",        "tz": "string"      },      "posts": -9007199254740991,      "views": 0,      "likes": 0,      "comments": 0,      "engagement_rate": 0,      "rows_without_views": -9007199254740991,      "rows_without_likes": -9007199254740991,      "rows_without_comments": -9007199254740991,      "views_metric": "string",      "measured_at": "string",      "partial": true,      "overlaps": "string",      "oldest": "string",      "newest": "string"    },    "receipt": "string",    "coverage": "string",    "videos": [      {        "id": "string",        "url": "string",        "title": "string",        "description": "string",        "channel": {          "id": "string",          "title": "string",          "handle": "string",          "url": "string"        },        "published_at": "string",        "published_text": "string",        "length": "string",        "view_count": 0,        "view_count_text": "string",        "like_count": 0,        "comment_count": 0,        "thumbnail": "string"      }    ]  },  "requests": 0,  "credits_charged": 0}