ogify
API reference

Render composite

Capture a live website and place it inside a branded Ogify social-card layout in one API request.

Request

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

Request body

FieldTypeRequiredNotes
urlstringYesWebsite to capture.
titlestringYesHeadline shown beside the screenshot.
authorstringNoSupporting author / site text.
tagstringNoEyebrow label.
brandstringNoBrand mark on paid plans.
accent_color#RRGGBBNoAccent override.
background_color#RRGGBBNoBackground override.
width / heightintegerNoFinal card size. Defaults to 1200 × 630.
viewport_width / viewport_heightintegerNoBrowser capture viewport.

Example

curl -X POST https://api.ogify.online/v1/render/composite \
  -H "x-api-key: $OGIFY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url":"https://ogify.online",
    "title":"Beautiful social images in one API call",
    "tag":"Website preview",
    "brand":"Ogify"
  }'

Use cases

  • Product launch cards with a live landing-page capture.
  • Changelog cards with a screenshot of the shipped feature.
  • Agency/social assets generated automatically from client URLs.