OG Image API
Dynamic 1200×630 Open Graph images from a URL — Satori WASM on the edge.
◎ Host: og.tools.town
Method: GET
Auth: None
Endpoints: 2
Pass a title (and optional subtitle, author, site, theme) and get a PNG social card. Used across the empire for tools.town meta images; call it from any site that needs share previews without a design pass.
Endpoint
All requests should be made to the following host:
GET https://og.tools.town/?title=… Authentication
No API key required. Public GET for image generation today. Metered keys via api.tools.town when you need quotas.
All Endpoints
Every route available on og.tools.town.
| Method | Path | Description |
|---|---|---|
| GET | /?title=… | Render a PNG OG card (title required). |
| GET | /analyze?url=… | Fetch a URL and extract OG meta tags as JSON. |
Example Request
cURL
curl -L -o card.png "https://og.tools.town/?title=Hello%20World&subtitle=Tools.Town&theme=dark"Error Codes
| Code | Meaning |
|---|---|
| 400 | Bad Request — missing or invalid parameter |
| 404 | Not Found — unknown route on this host |
| 405 | Method Not Allowed — check the method in the table above |
| 500 | Internal Server Error — try again or contact support |