# Shotium

> Screenshot and OG image rendering API for developers and AI agents. Base URL https://api.shotium.com/v1 — Bearer auth, RFC 9457 problem+json errors, image bytes on success.

Key facts: GET /v1/screenshot renders any public URL (png/jpeg/webp, full-page support, 24h cache). POST /v1/og-image renders 1200×630 social images from 5 built-in templates. GET /v1/og-image also accepts HMAC-signed URLs safe to embed in <meta property="og:image"> — no API key exposed. Rate limit 60 req/min per key. A render is billed only when a new image is rendered and delivered; cache hits (origin or CDN edge) and failed renders are free; nothing auto-charges. Sign-up (GitHub or Google OAuth) grants 100 free render credits: https://shotium.com/account

## Docs

- [API reference](https://shotium.com/docs): all endpoints, parameters, signed URL algorithm with Node and Python examples, error table, rate limits and billing semantics
- [OpenAPI 3.1 spec](https://shotium.com/openapi.json): machine-readable contract for every endpoint — parameter schemas, the stable error enum, and auth schemes
- [OG templates](https://shotium.com/og-templates): the 5 template ids with parameter schemas and real sample output
- [Free OG image generator](https://shotium.com/tools/og-image-generator): browser tool that renders the same 5 templates with no signup — useful for seeing the output before writing any code
- [Open Graph checker](https://shotium.com/tools/open-graph-checker): paste a URL to preview its social card on X, Facebook and LinkedIn and list every OG/Twitter tag — no signup, reads the same HTML crawlers see
- [Pricing](https://shotium.com/pricing): free credits, Starter $15/2000 renders, Growth $49/10000, $10/1000 credit packs
- [Changelog](https://shotium.com/changelog): dated product releases, fixes, and reliability improvements
- [Blog](https://shotium.com/blog): guides, honest comparisons, and engineering notes — OG image workflows, SSRF hardening, browser infrastructure
- [Blog RSS feed](https://shotium.com/rss.xml): machine-readable feed of all posts
- [Screenshot API guides](https://shotium.com/screenshot-api): runnable examples per language — Python, Node.js, PHP, Ruby, Go, Java and cURL; each covers screenshots, OG images, signed URLs and error handling
- [OG image API guides](https://shotium.com/og-image-api): how a signed og:image URL works, and where the one line goes in Next.js (generateMetadata, Edge runtime variant, metadataBase/localhost pitfall), Astro (layout frontmatter) and Nuxt (server route + useSeoMeta)
- [n8n integration](https://shotium.com/integrations/n8n): install the community node, credential setup, three operations, workflow patterns
- [n8n community node](https://www.npmjs.com/package/n8n-nodes-shotium): Take Screenshot, Generate OG Image and Generate Signed URL operations for n8n workflows

## Optional

- [About](https://shotium.com/about): what Shotium is, who builds it (the Shotium team) and how the service is run
- [Terms of service](https://shotium.com/terms)
- [Privacy policy](https://shotium.com/privacy)
- [Contact](https://shotium.com/contact)