API Documentation

const { url } = await fetch("https://api.snapog.dev/v1/sign", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template: "brand-card",
    params: { title: "My Score: 420", description: "Can you beat me?" },
    options: { width: 1200, height: 800 }, // 3:2 required by Farcaster
    expiresIn: 2592000,
  }),
}).then(r => r.json());

<meta name="fc:miniapp" content='{
  "version": "1",
  "imageUrl": "https://api.snapog.dev/v1/i/<signed-token>",
  "button": {
    "title": "Play Now",
    "action": { "type": "launch_miniapp" }
  }
}' />

curl -X POST https://api.snapog.dev/v1/batch \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "brand-card",
    "params": { "title": "My App" },
    "sizes": ["farcaster", "og", "twitter"]
  }'

import fs from "fs";

const response = await fetch("https://api.snapog.dev/v1/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template: "blog-post",
    params: {
      title: "My Blog Post",
      author: "Jane Doe",
      tags: ["API", "Tutorial"],
    },
  }),
});

const buffer = await response.arrayBuffer();
fs.writeFileSync("og-image.png", Buffer.from(buffer));
console.log("Image saved to og-image.png");

import requests

response = requests.post(
    "https://api.snapog.dev/v1/generate",
    headers={"Authorization": "Bearer sk_live_YOUR_KEY"},
    json={
        "template": "blog-post",
        "params": {
            "title": "My Blog Post",
            "author": "Jane Doe",
            "tags": ["API", "Tutorial"],
        },
    },
)

with open("og-image.png", "wb") as f:
    f.write(response.content)
print("Image saved to og-image.png")

// app/blog/[slug]/page.tsx
export async function generateMetadata({ params }) {
  const post = await getPost(params.slug);

  const ogUrl = new URL("https://api.snapog.dev/v1/og/blog-post");
  ogUrl.searchParams.set("title", post.title);
  ogUrl.searchParams.set("author", post.author);

  return {
    openGraph: {
      images: [{ url: ogUrl.toString(), width: 1200, height: 630 }],
    },
  };
}