> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenshothis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Screenshot API for Modern Applications

> Generate beautiful screenshots programmatically with a single API call.

<Frame>
  <img className="block rounded-2xl shadow dark:hidden" src="https://mintcdn.com/screenshothis/UI8SClmFjGNNMwMq/images/playground-light.png?fit=max&auto=format&n=UI8SClmFjGNNMwMq&q=85&s=5cf098954abc8fbfc3e5158ecfc937fc" alt="Screenshothis API playground interface" width="5760" height="3240" data-path="images/playground-light.png" />

  <img className="hidden rounded-2xl shadow shadow-white/5 dark:block" src="https://mintcdn.com/screenshothis/UI8SClmFjGNNMwMq/images/playground-dark.png?fit=max&auto=format&n=UI8SClmFjGNNMwMq&q=85&s=93c19e709921a9db9018d8fad207ee78" alt="Screenshothis API playground interface in dark mode" width="5760" height="3240" data-path="images/playground-dark.png" />
</Frame>

Generate beautiful, high-resolution screenshots of any web page with a single HTTP request. You get lightning-fast Chromium rendering, automatic high-DPI output, and flexible customization options—perfect for social cards, link previews, automated testing, and visual content generation.

## Why developers choose Screenshothis

<CardGroup cols={2}>
  <Card title="Lightning Fast" icon="bolt">
    Get screenshots in under 2 seconds with optimized Chromium rendering
  </Card>

  <Card title="High Quality" icon="image">
    Automatic high-DPI output up to 4K resolution with crisp, clear images
  </Card>

  <Card title="Full Control" icon="sliders">
    Custom viewports, device emulation, content blocking, and dark mode support
  </Card>

  <Card title="Production Ready" icon="shield-check">
    Built-in rate limiting, authentication, and horizontal scaling
  </Card>
</CardGroup>

## Get started in under 2 minutes

<Steps>
  <Step title="Get your API key">
    Sign up for free at [screenshothis.com](https://screenshothis.com/register) and create your API key. You'll get 100 free screenshots per month.
  </Step>

  <Step title="Make your first request">
    ```bash theme={null}
    curl "https://api.screenshothis.com/v1/screenshots/take?api_key=your_api_key&url=https://github.com" \
      -o screenshot.jpeg
    ```

    <Check>
      Your screenshot saves as `screenshot.jpeg` in the current directory
    </Check>
  </Step>

  <Step title="Customize your screenshots">
    Add parameters to control the output:

    ```bash theme={null}
    curl "https://api.screenshothis.com/v1/screenshots/take" \
      -G \
      -d "api_key=your_api_key" \
      -d "url=https://github.com" \
      -d "format=webp" \
      -d "quality=90" \
      -d "width=1920" \
      -d "height=1080" \
      -d "block_ads=true" \
      -d "block_cookie_banners=true" \
      -d "prefers_color_scheme=dark" \
      -o screenshot.webp
    ```

    <Tip>
      Use WebP format for smaller file sizes while maintaining excellent quality
    </Tip>
  </Step>
</Steps>

## Popular use cases

<AccordionGroup>
  <Accordion title="Social media previews" icon="share">
    Generate dynamic `og:image` tags for better social sharing:

    ```bash theme={null}
    curl "https://api.screenshothis.com/v1/screenshots/take" \
      -d "api_key=your_api_key" \
      -d "url=https://yourblog.com/post" \
      -d "width=1200" \
      -d "height=630"
    ```

    <Check>Perfect dimensions for Twitter, LinkedIn, and Facebook cards</Check>
  </Accordion>

  <Accordion title="Website thumbnails" icon="image">
    Create thumbnails for dashboards, newsletters, or link previews:

    ```bash theme={null}
    curl "https://api.screenshothis.com/v1/screenshots/take" \
      -d "api_key=your_api_key" \
      -d "url=https://example.com" \
      -d "width=400" \
      -d "height=300" \
      -d "format=webp"
    ```
  </Accordion>

  <Accordion title="Visual testing" icon="bug">
    Capture screenshots for visual regression testing in CI pipelines:

    ```bash theme={null}
    curl "https://api.screenshothis.com/v1/screenshots/take" \
      -d "api_key=your_api_key" \
      -d "url=https://yourapp.com/component" \
      -d "selector=#main-component" \
      -d "format=png" \
      -d "block_resources=script,stylesheet" \
      -d "prefers_reduced_motion=reduce"
    ```

    <Check>Ideal for automated testing and quality assurance workflows</Check>
  </Accordion>
</AccordionGroup>

## Continue your journey

<CardGroup cols={2}>
  <Card title="Complete quickstart guide" icon="rocket" href="/quickstart">
    Follow our step-by-step guide to master the API in 5 minutes
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Explore all available parameters and response formats
  </Card>

  <Card title="JavaScript SDK" icon="js" href="/sdk/js">
    Use our official TypeScript SDK for seamless integration
  </Card>

  <Card title="Self-host setup" icon="server" href="/self-host">
    Run Screenshothis on your own infrastructure
  </Card>
</CardGroup>

## Open source and community-driven

Screenshothis is **open source** (AGPL-3.0) because we believe in transparency and community collaboration. You can:

* ⭐ **Star us on [GitHub](https://github.com/screenshothis/screenshothis)** to show your support
* 🐛 **Report issues** or **request features** in our [Issues](https://github.com/screenshothis/screenshothis/issues)
* 🤝 **Contribute** improvements, bug fixes, or new features
* 🏠 **Self-host** on your own infrastructure for complete control

<Info>
  By keeping our code open, you can see exactly how your screenshots are generated, contribute enhancements, and run your own instance if needed
</Info>

***

© Screenshothis • AGPL-3.0