Build with Thumbalyze
Integrate thumbnail analysis and generation into your workflow with REST or MCP. Available on the Business plan (team admins can also enable access).
API reference
OpenAPI docs for analyze, generate, compare, channel audits, and more.
MCP setup
Connect Claude, Cursor, or ChatGPT with OAuth or an API key.
REST API
JSON in/out with bearer auth.
Base URL: https://www.thumbalyze.com/api/v1
Interactive OpenAPI: /developers/api (raw: /api/v1/openapi).
MCP
Same tools inside your assistant.
Remote server: https://www.thumbalyze.com/api/mcp
See the MCP product page for Claude, Cursor, and OAuth setup.
Authentication
Create an API key in dashboard Settings → Developer (thum_…). Send Authorization: Bearer <key> on every request. MCP OAuth access tokens (thoa_…) are also accepted on REST endpoints.
Rate limits
Public API and MCP traffic is limited to 60 requests per minute per account (rolling). You receive 429 with code rate_limited when exceeded. Credit billing is unchanged from the web app.
Example: analyze
curl -sS -X POST 'https://www.thumbalyze.com/api/v1/analyze' \
-H 'Authorization: Bearer thum_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"youtubeUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"title": "Your video title",
"mode": "medium"
}'Example: generate
curl -sS -X POST 'https://www.thumbalyze.com/api/v1/generate' \
-H 'Authorization: Bearer thum_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"title": "I Tried This for 30 Days",
"niche": "Fitness",
"includeText": true,
"overlayText": "30 DAYS"
}'