shotkiln-com Screenshot API
The Screenshot API from shotkiln-com — 1 operation(s) for screenshot.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/shotkiln-com:shotkiln-com-screenshot-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Shotkiln Screenshot API
version: 0.1.0
description: 'Screenshots, PDFs and OG images from any public URL or HTML. Plans: Free 100/mo, Starter 2000/mo, Pro 10000/mo, Scale 50000/mo.'
contact:
name: Shotkiln support
email: support@shotkiln.com
servers:
- url: https://shotkiln.com
security:
- ApiKeyHeader: []
- Bearer: []
- {}
tags:
- name: Screenshot
paths:
/v1/screenshot:
get:
operationId: screenshotGet
summary: Screenshot a web page (query parameters; embeddable in with api_key)
parameters:
- name: url
in: query
required: true
schema:
type: string
format: uri
description: Public http(s) URL (ports 80/443/8080/8443)
- name: width
in: query
required: false
schema:
type: integer
minimum: 320
maximum: 3840
default: 1280
- name: height
in: query
required: false
schema:
type: integer
minimum: 200
maximum: 3840
default: 800
- name: full_page
in: query
required: false
schema:
type: boolean
default: false
description: Capture the full scrollable page (max 16384 px tall)
- name: scroll
in: query
required: false
schema:
type: boolean
default: true
description: 'With full_page: scroll through the page in steps first, then back to the top, so lazy-loaded images appear. Bounded by the render timeout. Set false to capture without scrolling. Ignored for viewport captures.'
- name: format
in: query
required: false
schema:
type: string
enum:
- png
- jpeg
- webp
default: png
- name: quality
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 80
description: jpeg/webp only
- name: delay
in: query
required: false
schema:
type: integer
minimum: 0
maximum: 10000
default: 0
description: Extra wait after load (ms)
- name: device_scale_factor
in: query
required: false
schema:
type: number
minimum: 1
maximum: 3
default: 1
- name: dark_mode
in: query
required: false
schema:
type: boolean
default: false
description: 'Emulate prefers-color-scheme: dark'
- name: cache_ttl
in: query
required: false
schema:
type: integer
minimum: 0
maximum: 2592000
default: 3600
description: Seconds to cache; 0 = always render fresh. Cache hits do not use quota.
responses:
'200':
description: Rendered file
content:
image/png: {}
image/jpeg: {}
image/webp: {}
headers:
X-Cache:
schema:
type: string
enum:
- HIT
- MISS
- BYPASS
X-Quota-Remaining:
schema:
type: integer
X-RateLimit-Remaining:
schema:
type: integer
'400':
description: 'Invalid parameter or blocked URL (code: invalid_parameter, invalid_url, url_blocked, blocked_url)'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or revoked API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Target page too large
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit, daily limit or monthly quota exceeded (see Retry-After)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: Target page failed to load
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: Browser capacity temporarily unavailable (see Retry-After)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'504':
description: Render timed out
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Screenshot
post:
operationId: screenshot
summary: Screenshot a web page
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
url:
type: string
format: uri
description: Public http(s) URL (ports 80/443/8080/8443)
width:
type: integer
minimum: 320
maximum: 3840
default: 1280
height:
type: integer
minimum: 200
maximum: 3840
default: 800
full_page:
type: boolean
default: false
description: Capture the full scrollable page (max 16384 px tall)
scroll:
type: boolean
default: true
description: 'With full_page: scroll through the page in steps first, then back to the top, so lazy-loaded images appear. Bounded by the render timeout. Set false to capture without scrolling. Ignored for viewport captures.'
format:
type: string
enum:
- png
- jpeg
- webp
default: png
quality:
type: integer
minimum: 1
maximum: 100
default: 80
description: jpeg/webp only
delay:
type: integer
minimum: 0
maximum: 10000
default: 0
description: Extra wait after load (ms)
device_scale_factor:
type: number
minimum: 1
maximum: 3
default: 1
dark_mode:
type: boolean
default: false
description: 'Emulate prefers-color-scheme: dark'
cache_ttl:
type: integer
minimum: 0
maximum: 2592000
default: 3600
description: Seconds to cache; 0 = always render fresh. Cache hits do not use quota.
required:
- url
responses:
'200':
description: Rendered file
content:
image/png: {}
image/jpeg: {}
image/webp: {}
headers:
X-Cache:
schema:
type: string
enum:
- HIT
- MISS
- BYPASS
X-Quota-Remaining:
schema:
type: integer
X-RateLimit-Remaining:
schema:
type: integer
'400':
description: 'Invalid parameter or blocked URL (code: invalid_parameter, invalid_url, url_blocked, blocked_url)'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or revoked API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Target page too large
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limit, daily limit or monthly quota exceeded (see Retry-After)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: Target page failed to load
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: Browser capacity temporarily unavailable (see Retry-After)
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'504':
description: Render timed out
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Screenshot
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
required:
- code
- message
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: x-api-key
Bearer:
type: http
scheme: bearer