API Overview

The ThumbGrab API lets you programmatically extract YouTube thumbnails.

Base URL

https://thumbgrab.cc/api/v1

Authentication

API access requires a Pro subscription. Authenticate using your API key in the header:

Authorization: Bearer YOUR_API_KEY

Get your API key from Dashboard Settings.

Endpoints

Extract Single Thumbnail

POST /extract

Request:

{
  "url": "https://youtube.com/watch?v=VIDEO_ID"
}

Response:

{
  "videoId": "VIDEO_ID",
  "title": "Video Title",
  "thumbnails": [
    {
      "resolution": "maxresdefault",
      "url": "https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg",
      "width": 1280,
      "height": 720,
      "available": true
    }
  ]
}

Bulk Extract

POST /extract/bulk

Request:

{
  "urls": [
    "https://youtube.com/watch?v=VIDEO1",
    "https://youtube.com/watch?v=VIDEO2"
  ]
}

Rate Limits

Pro users: 100 requests per minute
Bulk endpoint: Max 50 URLs per request

Error Codes

Code	Meaning
400	Invalid URL or request
401	Missing or invalid API key
429	Rate limit exceeded
500	Server error