Open Graph

Open Graph image API for dynamic social share cards

Pass a title, optional subtitle, badge, and site name as JSON. ForgeDocs renders a 1200×630 PNG with the og-card pack — ideal for blogs, docs sites, product pages, and agents that mint share previews on the fly.

Start 7-day free trial Try the playground Starter $8.99/mo →

PNG at social dimensions, not a second product

Set format: "png" on the same /api/v1/render endpoint you use for PDFs. The og-card pack is sized for Open Graph and Twitter/X cards, so you do not need a separate screenshot service.

Structured fields agents can fill

Title is required; subtitle, badge, site, and footer are optional. Coding agents and CMS webhooks can call the API (or MCP render_template) whenever a page is published.

Same auth, quotas, and jobs as documents

OG images count toward the same Starter quota as invoices and HTML to PDF. Use async jobs when you regenerate large site maps of share cards overnight.

curl · Open Graph PNG

curl -X POST https://pdfforagents.com/api/v1/render \
  -H "Content-Type: application/json" \
  -d '{
    "template": "og-card",
    "format": "png",
    "data": {
      "title": "JSON in. PDFs & images out.",
      "subtitle": "Agent-native document generation via MCP or HTTP.",
      "badge": "MCP ready",
      "site": "forgedocs.dev"
    }
  }' \
  --output og.png

Common questions

Is this a dedicated Open Graph image API?+

Yes for the intent: the og-card pack plus PNG output. Under the hood it uses the same Chromium render path as HTML to PDF — one endpoint, one quota.

Can I use custom HTML for OG images instead?+

Absolutely. Pass html (or markdown) with format: "png" if you need full layout control beyond the og-card pack.

What does Starter cost?+

Starter is $8.99/mo after a 7-day free trial, covering packs, HTML, Markdown, PNG, and PDF renders.

Ready to generate documents from your stack?

Starter is $8.99/mo after a 7-day free trial. Use the playground locally, or wire MCP / REST when you're ready to ship.

Start 7-day free trial Open playground