Imago API Reference

curl -X POST https://imagoapi.com/api/og/generate \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "imago_your_key_here",
    "title": "My First OG Image",
    "description": "Generated with Imago API in seconds"
  }'

<meta property="og:image" content="https://imagoapi.com/api/images/og_abc123.png" />
<meta name="twitter:image" content="https://imagoapi.com/api/images/og_abc123.png" />

{
  "api_key": "imago_your_key_here",
  "title": "..."
}

{
  "api_key":      "imago_...",           // required
  "title":        "My Page Title",      // required
  "description":  "A short description", // optional
  "template":     "gradient",           // gradient | modern | bold | minimal | dark | vibrant | corporate | playful | developer | magazine
  "brand_color":  "#6366F1",            // optional: hex color
  "site_name":    "My Site"             // optional: shown in image footer
}

{
  "success": true,
  "image": {
    "url":        "https://imagoapi.com/api/images/og_abc123.png",
    "filename":   "og_abc123.png",
    "format":     "png",
    "dimensions": { "width": 1200, "height": 630 },
    "mimeType":   "image/png"
  },
  "metadata": {
    "title":       "My Page Title",
    "description": "A short description",
    "template":    "gradient"
  },
  "usage": {
    "current": 5,
    "limit":   50
  },
  "generatedAt": "2026-03-07T12:00:00.000Z"
}

curl -X POST https://imagoapi.com/api/og/generate \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "imago_your_key",
    "title": "My Product Launch",
    "description": "Shipped it! Version 2.0 is live.",
    "template": "bold",
    "brand_color": "#6366F1",
    "site_name": "MyApp"
  }'

const res = await fetch('https://imagoapi.com/api/og/generate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key:     'imago_your_key',
    title:       'My Page Title',
    description: 'A description for the image',
    template:    'gradient',
    brand_color: '#6366F1',
    site_name:   'MyApp'
  })
});

const data = await res.json();
console.log(data.image.url); // https://imagoapi.com/api/images/og_abc123.png

const axios = require('axios');

const { data } = await axios.post('https://imagoapi.com/api/og/generate', {
  api_key:     'imago_your_key',
  title:       'My Page Title',
  description: 'A description for the image',
  template:    'gradient'
});

console.log(data.image.url);

import requests

response = requests.post(
    'https://imagoapi.com/api/og/generate',
    json={
        'api_key':     'imago_your_key',
        'title':       'My Page Title',
        'description': 'A description for the image',
        'template':    'gradient',
    }
)

data = response.json()
print(data['image']['url'])

// pages/api/og.js (or app/api/og/route.js)
export default async function handler(req, res) {
  const { title, description } = req.query;

  const response = await fetch('https://imagoapi.com/api/og/generate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      api_key: process.env.IMAGO_API_KEY,
      title,
      description,
    })
  });

  const data = await response.json();
  res.redirect(data.image.url);
}