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
| Field | Type | Required | Notes |
|---|---|---|---|
| url | string | Yes | Website to capture. |
| title | string | Yes | Headline shown beside the screenshot. |
| author | string | No | Supporting author / site text. |
| tag | string | No | Eyebrow label. |
| brand | string | No | Brand mark on paid plans. |
| accent_color | #RRGGBB | No | Accent override. |
| background_color | #RRGGBB | No | Background override. |
| width / height | integer | No | Final card size. Defaults to 1200 × 630. |
| viewport_width / viewport_height | integer | No | Browser 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.