API Authentication
All API requests require authentication via an API key.
Getting Your API Key
Note: API access requires a Pro subscription.
Using Your API Key
Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYcURL Example
curl -X POST https://thumbgrab.cc/api/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://youtube.com/watch?v=dQw4w9WgXcQ"}'JavaScript Example
const response = await fetch('https://thumbgrab.cc/api/v1/extract', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
url: 'https://youtube.com/watch?v=dQw4w9WgXcQ'
}),
});
const data = await response.json();Python Example
import requests
response = requests.post(
'https://thumbgrab.cc/api/v1/extract',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={'url': 'https://youtube.com/watch?v=dQw4w9WgXcQ'}
)
data = response.json()Security Best Practices
- Never expose your API key in client-side code
- Store keys in environment variables
- Rotate keys if compromised
- Use separate keys for development and production
Key Not Working?
- Verify you have an active Pro subscription
- Check for typos or extra whitespace
- Ensure you're using the Bearer prefix
- Contact support if issues persist