ogify
API reference

Screenshot URL

Capture viewport, full-page, or element screenshots and receive a hosted PNG, JPEG, or WebP URL.

HTTP request

POST https://api.ogify.online/v1/render/url
Content-Type: application/json
x-api-key: $OGIFY_KEY

Request body

FieldTypeRequiredNotes
urlstringYesPublic http/https URL. Private/local hosts are blocked.
viewport_widthintegerNo320–2400. Defaults to 1200.
viewport_heightintegerNo240–3000. Defaults to 630.
full_pagebooleanNoCapture the entire page height.
selectorstringNoCapture one matching element instead of the viewport.
formatpng | jpeg | webpNoDefaults to png.
qualityintegerNo1–100 for JPEG/WebP.
delayintegerNo0–10000 ms after navigation.
wait_untilstringNoload, domcontentloaded, or networkidle0.
wait_for_selectorstringNoWait for a CSS selector before capture.
custom_cssstringNoInject up to 100 KB of CSS before capture.
custom_jsstringNoRun page-side JavaScript before capture.
dark_modebooleanNoEmulate prefers-color-scheme: dark.
hide_selectorsstring[]NoHide up to 25 elements before capture.
headersobjectNoAdditional safe request headers.
user_agentstringNoOverride browser user agent.
device_scale_factornumberNo1–3 for higher-density output.
cookiesarrayNoSet up to 50 cookies before navigation.
localestringNoSet Accept-Language for localized pages.
timezonestringNoIANA timezone used by the browser page.
click_selectorstringNoClick an element before capture.
scroll_tonumber | bottomNoScroll before capture to trigger lazy content.
block_resourcesstring[]NoOptionally block image, stylesheet, font, media, or script resources.
clipobjectNoCapture x/y/width/height region. Not with selector/full_page.
omit_backgroundbooleanNoPreserve transparency where supported.

Example

curl -X POST https://api.ogify.online/v1/render/url \
  -H "x-api-key: $OGIFY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url":"https://example.com",
    "full_page":true,
    "format":"webp",
    "quality":88,
    "hide_selectors":[".cookie-banner"],
    "wait_until":"networkidle0"
  }'

Browser controls

Use selector or clip for partial captures, custom_css/custom_js for page automation, cookies for authenticated sessions you control, click_selector and scroll_to for lazy UI, and locale/timezone controls for regional rendering.

full_page and selector cannot be used together.

Security

Ogify blocks direct private/local URLs and aborts browser subrequests to direct private/local hosts. Some sites may still show region-specific pages, consent dialogs, login screens, or anti-bot challenges because Ogify captures the page the browser actually receives.