Use Case

Website Thumbnails

Q: What's the optimal thumbnail size for web directories?

For most directories, 400x300 pixels (4:3 aspect ratio) works well. This provides enough detail while keeping file sizes small. For mobile-first designs, consider 300x200 or 320x240 pixels.

Q: How do I handle websites that take time to load?

Use the delay parameter (2-5 seconds) to wait for content to fully load. For sites with heavy JavaScript or slow APIs, you can increase the delay or use our wait-for-selector option to ensure specific elements are visible.

Q: Should I use JPEG or PNG for thumbnails?

JPEG is recommended for thumbnails as it provides smaller file sizes with acceptable quality. Use quality settings between 70-85 for the best balance. PNG is only needed if you require transparency.

Q: How long should I cache thumbnails?

Cache thumbnails for at least 24 hours, preferably 7 days or more. Most websites don't change their homepage frequently, so longer caching reduces API costs while maintaining freshness.

Generate thumbnail previews for link aggregators, directories, and bookmarking services. Create visual previews at any size.

Overview

Thumbnails transform plain text links into engaging visual content. Whether you're building a link directory, bookmarking service, or content aggregator, website thumbnails help users quickly scan and identify sites at a glance.

Screenshotly generates consistent, high-quality thumbnails at any resolution you need. Our API handles the complexity of rendering modern web pages—JavaScript-heavy SPAs, lazy-loaded images, and dynamic content—delivering reliable thumbnails every time.

The key to great thumbnails is consistency. Random viewport sizes, inconsistent loading states, and varying quality make your interface look unprofessional. With Screenshotly, you define the exact specifications once, and every thumbnail matches. Combine this with our caching recommendations, and you can serve thousands of thumbnails instantly.

Key Benefits

Generate thumbnails at any size

Build link directories

Create bookmark previews

Visual search results

Results You Can Expect

< 1s

cached thumbnail delivery

50KB

average thumbnail size

99.9%

render success rate

How It Works

Define your thumbnail dimensions and quality requirements

Set up an API endpoint to handle thumbnail requests

Check your cache before calling the Screenshotly API

Generate and cache new thumbnails with appropriate TTL

Serve thumbnails with fallback placeholders for loading states

Code Example

// Generate thumbnail
const response = await fetch('https://api.screenshotly.app/screenshot', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    url: 'https://example.com',
    device: 'desktop',
    format: 'jpeg',
    quality: 80,
  }),
});

Frequently Asked Questions

What's the optimal thumbnail size for web directories?

For most directories, 400x300 pixels (4:3 aspect ratio) works well. This provides enough detail while keeping file sizes small. For mobile-first designs, consider 300x200 or 320x240 pixels.

How do I handle websites that take time to load?

Use the delay parameter (2-5 seconds) to wait for content to fully load. For sites with heavy JavaScript or slow APIs, you can increase the delay or use our wait-for-selector option to ensure specific elements are visible.

Should I use JPEG or PNG for thumbnails?

JPEG is recommended for thumbnails as it provides smaller file sizes with acceptable quality. Use quality settings between 70-85 for the best balance. PNG is only needed if you require transparency.

How long should I cache thumbnails?

Cache thumbnails for at least 24 hours, preferably 7 days or more. Most websites don't change their homepage frequently, so longer caching reduces API costs while maintaining freshness.

Want a step-by-step walkthrough?

Read: Website Thumbnail Generation Guide →

Ready to automate thumbnails?

Get started with 100 free screenshots. No credit card required.

Start Free Trial Try Playground