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).

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"
  }'