Quick start
- 1Get a key
Create one in Dashboard → API & MCP (Pro).
- 2Make a call
POST /api/v1/improvewith a post. Get rewrites and a meme back. - 3Or plug in your agent
Add the MCP server or drop in the skill.
Authentication
Every request needs your key as a bearer token. Keys start with bst_, are shown once, and can be revoked anytime. Keep them server-side. The base URL is https://beastify.xyz/api/v1; requests and responses are JSON.
Authorization: Bearer bst_…/api/v1/improveImprove a post
Analyzes a post (main weakness + editorial scores) and returns 3–4 rewrites with different strategies. Optionally picks a fitting meme template, writes the captions and renders it.
| Parameter | Type | Description |
|---|---|---|
postrequired | string | The post or rough draft (up to 2,000 characters). |
media | { kind: "image" | "video", dataUrl } | Optional image or video attached to the post. dataUrl is a JPEG, PNG or WebP data URL under ~650 KB. For a video, send one image tiling 4 frames spread across it (2×2 grid, e.g. at 1/5, 2/5, 3/5 and 4/5 of its length). The analysis then includes mediaSummary; pass it to /transform as mediaSummary to keep that context. |
meme | true | false | "auto" | "auto" (default) adds a meme only when one fits, true always tries, false never. |
Request
curl https://beastify.xyz/api/v1/improve \
-H "Authorization: Bearer $BEASTIFY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": "We just launched a new feature that lets teams have fewer meetings because everything is in one place.",
"meme": "auto"
}'Response
{
"id": "6720c1f4e3a1b2c3d4e5f601",
"analysis": {
"mainWeakness": "You're explaining the feature before giving people a reason to care.",
"scores": { "hook": 3, "clarity": 7, "specificity": 5, "curiosity": 4, "personality": 6, "conversation": 7 }
},
"variants": [
{
"id": "a1",
"strategy": "Best",
"text": "Your team doesn't need another tool. It needs fewer meetings.\n\nWe just shipped one place for everything."
},
{ "id": "a2", "strategy": "Punchy", "text": "Fewer tools. Fewer meetings. One place." }
],
"meme": {
"handle": "drake-hotline-bling",
"name": "Drake Hotline Bling",
"mediaType": "image",
"mimeType": "image/jpeg",
"url": "https://static.beastify.xyz/memes/2026-10-02/drake-hotline-bling-….jpg",
"width": 1200,
"height": 1200,
"inputs": { "text1": "Explaining the feature first", "text2": "Leading with the pain" },
"reason": "Contrasts the weak opener with the stronger one."
}
}Result

/api/v1/transformRemix a version
Applies one quick transformation to a version of the post.
| Parameter | Type | Description |
|---|---|---|
textrequired | string | The version to transform. |
kindrequired | string | shorter, hook (stronger hook), human (more human), funnier or angle (new angle). |
original | string | The original post, for context. |
Request
curl https://beastify.xyz/api/v1/transform \
-H "Authorization: Bearer $BEASTIFY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Your team doesn't need another tool. It needs fewer meetings.",
"kind": "funnier"
}'Response
{
"variant": {
"id": "b7",
"strategy": "Funny",
"text": "Your team doesn't need another tool. It needs a meeting about having fewer meetings. (Kidding. We built the tool.)"
}
}/api/v1/memes?query=choice&limit=3Search memes
Searches 900+ templates and 3,000+ reaction GIFs by keywords: names, situations, emotions, characters. An empty query returns the most popular templates.
| Parameter | Type | Description |
|---|---|---|
query | string | Keywords, e.g. "choice dilemma", "waiting", "drake". |
mediaType | "all" | "image" | "video" | "gif" | Filter by media type: image (still templates), video (animated templates), gif (reaction GIF library, caption optional). |
limit | number | 1–100, default 20. |
offset | number | For pagination. |
Request
curl "https://beastify.xyz/api/v1/memes?query=choice&limit=3" \
-H "Authorization: Bearer $BEASTIFY_API_KEY"Response
{
"total": 41,
"results": [
{
"handle": "two-buttons",
"name": "Two Buttons",
"mediaType": "image",
"width": 600,
"height": 908,
"inputs": [
{ "key": "text1", "label": "Left button choice", "alias": "left_option" },
{ "key": "text2", "label": "Right button choice", "alias": "right_option" },
{ "key": "text3", "label": "The person deciding", "alias": "chooser" }
],
"thumbUrl": "https://beastify.xyz/memes/thumb/two-buttons.jpg",
"previewUrl": "https://beastify.xyz/memes/media/two-buttons.jpg"
}
]
}Result
/api/v1/memes/two-buttonsGet a template
A template's caption fields with what each one is for and an example, so you (or your model) can write captions that fit.
Request
curl "https://beastify.xyz/api/v1/memes/two-buttons" \
-H "Authorization: Bearer $BEASTIFY_API_KEY"Response
{
"handle": "two-buttons",
"name": "Two Buttons",
"mediaType": "image",
"width": 600,
"height": 908,
"inputs": [
{
"key": "text1",
"label": "Left button choice",
"alias": "left_option",
"description": "Write one of the options the person is tempted to choose.",
"example": "Go to bed before midnight"
},
{
"key": "text2",
"label": "Right button choice",
"alias": "right_option",
"description": "Write the competing option that makes the decision difficult.",
"example": "Watch one more cooking video"
},
{
"key": "text3",
"label": "The person deciding",
"alias": "chooser",
"description": "Describe who is struggling or what situation has them sweating.",
"example": "Me with an early meeting tomorrow"
}
],
"thumbUrl": "https://beastify.xyz/memes/thumb/two-buttons.jpg"
}/api/v1/memes/two-buttons/generateGenerate a meme
Renders a template with your captions. Image templates return a JPEG; video/GIF templates return an MP4, or an animated GIF with "format": "gif". Keys can be text1… or their alias (e.g. left_option); blank captions are skipped. Templates with picture slots (inputs of type image, keys image1…) take an https:// image URL or a data:image/…;base64 URL.
| Parameter | Type | Description |
|---|---|---|
inputsrequired | object | Captions keyed by input key or alias, e.g. { "text1": "…" }. Picture slots (image1…) take an image URL. |
format | "mp4" | "gif" | Video/GIF templates only. Default mp4. |
Request
curl https://beastify.xyz/api/v1/memes/two-buttons/generate \
-H "Authorization: Bearer $BEASTIFY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputs": {
"text1": "Ship it Friday",
"text2": "Write the tests",
"text3": "Me at 4:59pm"
}
}'Response
{
"meme": {
"handle": "two-buttons",
"name": "Two Buttons",
"mediaType": "image",
"mimeType": "image/jpeg",
"url": "https://static.beastify.xyz/memes/2026-10-02/two-buttons-….jpg",
"width": 600,
"height": 908,
"inputs": { "text1": "Ship it Friday", "text2": "Write the tests", "text3": "Me at 4:59pm" }
}
}Result

/api/v1/memes/suggestSuggest a meme for a post
Lets Beastify pick the best-fitting template for a post, write the captions and render it. Returns "meme": null when nothing fits well. Pass exclude to try another.
| Parameter | Type | Description |
|---|---|---|
postrequired | string | The post the meme should go with. |
query | string | Optional hint for the template search. |
exclude | string[] | Handles to skip. |
Request
curl https://beastify.xyz/api/v1/memes/suggest \
-H "Authorization: Bearer $BEASTIFY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": "We cut 14 SaaS subscriptions last quarter. Nobody noticed."
}'Response
{
"meme": {
"handle": "distracted-boyfriend",
"name": "Distracted Boyfriend",
"mediaType": "image",
"mimeType": "image/jpeg",
"url": "https://static.beastify.xyz/memes/2026-10-02/distracted-boyfriend-….jpg",
"inputs": { "text1": "One focused tool", "text2": "My team", "text3": "Our 14 SaaS subscriptions" },
"reason": "Shows the team leaving the bloated stack for one simple tool."
}
}Result

/api/v1/meYour account
Check which account and plan a key belongs to.
Request
curl "https://beastify.xyz/api/v1/me" \
-H "Authorization: Bearer $BEASTIFY_API_KEY"Response
{
"email": "[email protected]",
"plan": "pro"
}Media URLs returned by the API are valid for 12 hours (memes with an uploaded picture: 10 days). The first request renders the meme, so it can take a few seconds for videos. Download or re-host anything you want to keep. Video renders take a few seconds, so use a client timeout of at least 120 seconds.
MCP server
A Streamable HTTP MCP server at https://beastify.xyz/mcp, authenticated with your API key. Connect it once and ask your agent things like “Beastify this draft and make a meme for it”.
improve_postAnalysis + 3–4 rewrites (optionally with a meme)transform_postShorter / hook / human / funnier / anglesearch_memesFind templates by keywordsget_meme_templateCaption fields with descriptions and examplesgenerate_memeRender a template (JPEG or MP4)suggest_memePick + caption + render for a postclaude mcp add --transport http beastify https://beastify.xyz/mcp \
--header "Authorization: Bearer bst_…"Agent skill
A ready-made SKILL.md that teaches agents when and how to use Beastify over the REST API (no MCP needed). Save it in your agent's skills folder and export your key.
mkdir -p ~/.claude/skills/beastify
curl -o ~/.claude/skills/beastify/SKILL.md https://beastify.xyz/skill/beastify/SKILL.md
export BEASTIFY_API_KEY=bst_…Errors
Errors return a non-2xx status and {"error": {"code": "…", "message": "…"}}. The message is written for humans; switch on the code.
| Status | Code | Meaning |
|---|---|---|
400 | POST_TOO_LONG · EMPTY_POST · INVALID_INPUTS · INVALID_TRANSFORM | Fix the request; the message says what's wrong. |
401 | MISSING_API_KEY · INVALID_API_KEY | Missing, wrong or revoked key. |
402 | PRO_REQUIRED | The key's account isn't on Pro. |
404 | MEME_NOT_FOUND · NOT_FOUND | Unknown template handle or endpoint. |
502 / 504 | LLM_MALFORMED · LLM_TIMEOUT | The AI hiccuped. Retry once. |
503 | LLM_UNAVAILABLE · DATABASE_UNAVAILABLE | Temporary outage. Retry shortly. |