Stophy

Video

Fetch video details, transcript, comments, or replies. Pass type: details for metadata, transcript for timestamped captions, comments for top-level comments, or replies for a comment thread (pass the repliesToken from a comment as continuationToken).

Fetch video details, transcript, comments, or replies. Pass type: details for metadata, transcript for timestamped captions, comments for top-level comments, or replies for a comment thread (pass the repliesToken from a comment as continuationToken).

Authorization

bearerAuth
AuthorizationBearer <token>

API key from your dashboard. Prefix with Bearer in the Authorization header.

In: header

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

POST
/v1/video
curl -X POST "https://example.com/v1/video" \  -H "Content-Type: application/json" \  -d '{    "videoUrl": "https://www.youtube.com/watch?v=D7liwdjvhWc",    "type": "details"  }'

{  "success": true,  "requestId": "string",  "cacheState": "hit | miss",  "creditsUsed": "number",  "creditsRemaining": "number",  "data": {    "video": {      "id": "string",      "videoUrl": "string",      "title": "string",      "author": "string",      "authorId": "string",      "description": "string | null",      "viewCount": "number",      "viewCountText": "string",      "likeCount": "number",      "likeCountText": "string",      "durationSec": "number",      "durationText": "string",      "publishedAt": "string",      "tags": "string[]",      "isLive": "boolean",      "category": "string",      "thumbnails": [        {          "url": "string",          "width": "number",          "height": "number"        }      ]    },    "related": [      {        "id": "string",        "videoUrl": "string",        "title": "string",        "author": "string",        "authorId": "string",        "viewCount": "number",        "viewCountText": "string",        "duration": "string",        "durationSec": "number",        "durationText": "string",        "publishedAt": "string",        "publishedAtText": "string",        "thumbnails": [          {            "url": "string",            "width": "number",            "height": "number"          }        ]      }    ]  }}

{  "success": false,  "code": "INVALID_INPUT",  "error": "videoUrl is required"}
{  "success": false,  "code": "UNAUTHORIZED",  "error": "string",  "details": null}
{  "success": false,  "code": "UNAUTHORIZED",  "error": "string",  "details": null}
{  "success": false,  "code": "UNAUTHORIZED",  "error": "string",  "details": null}
{  "success": false,  "code": "UNAUTHORIZED",  "error": "string",  "details": null}

Error Handling

All errors return a JSON body with a machine-readable code. Rate limit is 120 req/min.

Search POST

Search YouTube with optional filters for content type, sort order, upload date, duration, and features. Returns paginated results.