ESC
YouTube Top N List preview
IMAGE youtube-thumbnail 1280×720px

YouTube Top N List

Numbered list thumbnail for 'Top 5' or 'Best of' style videos.

Use Cases

  • Top 5 / Top 10 list videos
  • Best tools and resources roundups
  • Tips and tricks series
  • Ranked product reviews

Tags

youtube thumbnail top-5 listicle best-of countdown 1280x720
Get API Key → API Docs

Template Variables

Variable Type Default Description
count string 5 Number in the 'Top N' format
topic string Tools You Need List topic text
bg_color color #18181b Background colour
accent_color color #f59e0b Number highlight colour
text_color color #ffffff Text colour

API Example

POST to https://image.toolkitapi.io/v1/image/from-template with your template URL and variable values. 

curl -X POST "https://image.toolkitapi.io/v1/image/from-template" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_url": "https://toolkitapi.io/static/templates/image/yt-listicle.html", "variables": {"count": "5", "topic": "Tools You Need", "bg_color": "#18181b", "accent_color": "#f59e0b", "text_color": "#ffffff"}, "width": 1280, "height": 720, "format": "png"}'
import httpx, base64

resp = httpx.post(
    "https://image.toolkitapi.io/v1/image/from-template",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "template_url": "https://toolkitapi.io/static/templates/image/yt-listicle.html",
        "variables": {
            "count": "5",
            "topic": "Tools You Need",
            "bg_color": "#18181b",
            "accent_color": "#f59e0b",
            "text_color": "#ffffff"
        },
        "width": 1280,
        "height": 720,
        "format": "png"
    },
)
image_bytes = base64.b64decode(resp.json()["image"])
with open("result.png", "wb") as f:
    f.write(image_bytes)
const response = await fetch("https://image.toolkitapi.io/v1/image/from-template", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "template_url": "https://toolkitapi.io/static/templates/image/yt-listicle.html",
    "variables": {
      "count": "5",
      "topic": "Tools You Need",
      "bg_color": "#18181b",
      "accent_color": "#f59e0b",
      "text_color": "#ffffff"
    },
    "width": 1280,
    "height": 720,
    "format": "png"
  }),
});
const data = await response.json();
// data.image is a base64-encoded PNG
$body = @{
    template_url = "https://toolkitapi.io/static/templates/image/yt-listicle.html"
    variables    = {
      "count": "5",
      "topic": "Tools You Need",
      "bg_color": "#18181b",
      "accent_color": "#f59e0b",
      "text_color": "#ffffff"
    }
    width  = 1280
    height = 720
    format = "png"
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method POST `
  -Uri "https://image.toolkitapi.io/v1/image/from-template" `
  -Headers @{"X-API-Key" = "YOUR_API_KEY"} `
  -ContentType "application/json" `
  -Body $body
Back to Template Library