📡 ScreenshotAPI Documentation

Base URL: https://158.247.230.116.nip.io

← Back to Home

🆓 Get Your Free API Key

No email required. One click, get a key instantly. 30 requests/day.

GET/health

Check API status. No authentication required.

curl https://158.247.230.116.nip.io/health
→ {"status":"ok","uptime":"5912","cache":{"size":3},"keysIssued":1}

GET/screenshot

Take a screenshot. Requires API key.

ParameterTypeDefaultDescription
urlstringrequiredTarget URL
api_keystringrequiredYour API key
widthnumber1280Viewport width
heightnumber720Viewport height
fullPageboolfalseCapture full scrollable page
selectorstring""CSS selector for element capture
formatstringpngpng or jpeg
qualitynumber90JPEG quality (1-100)
delaynumber0Wait ms before capture
curl "https://158.247.230.116.nip.io/screenshot?url=https://example.com&api_key=YOUR_KEY"
# Element selector — capture only the header:
curl "https://158.247.230.116.nip.io/screenshot?url=https://example.com&selector=h1&api_key=YOUR_KEY"

POST/screenshot

JSON body version. Supports PDF + element selector.

curl -X POST https://158.247.230.116.nip.io/screenshot   -H "Content-Type: application/json"   -H "X-API-Key: YOUR_KEY"   -d '{"url":"https://example.com","selector":".hero","format":"png"}'
# PDF:
curl -X POST https://158.247.230.116.nip.io/screenshot   -H "Content-Type: application/json"   -H "X-API-Key: YOUR_KEY"   -d '{"url":"https://example.com","pdf":true}'

POST/social-card

Generate OG social card (1200x630). Light/dark modes. Custom logo.

ParameterTypeDefaultDescription
urlstringrequiredTarget URL for OG extraction
dark_modeboolfalseDark theme card
logostring""URL or base64 logo image
curl -X POST https://158.247.230.116.nip.io/social-card   -H "Content-Type: application/json"   -H "X-API-Key: YOUR_KEY"   -d '{"url":"https://github.com","dark_mode":false}'

POST/register

Register for a free API key. No auth required. Rate-limited per IP (3/hour).

curl -X POST https://158.247.230.116.nip.io/register
→ {"api_key":"sk-...","plan":"free","limit":"30 requests/day"}

GET/openapi.json

OpenAPI 3.0 specification for third-party integrations.

curl https://158.247.230.116.nip.io/openapi.json
→ {... complete API specification ...}