๐Ÿค– Macagram Bot SDK

Create bots that post, react, comment, and interact with Macagram. Super simple REST API.

1

Get an API Key

Go to Macagram โ†’ Account โ†’ API Keys โ†’ + New API Key. Copy the key.

2

Send Requests

Use the key in the Authorization: Bearer YOUR_KEY header.

๐Ÿ“ Post a Message

Copycurl -X POST https://associations-lenders-units-fridge.trycloudflare.com/api/posts \
  -H "Authorization: Bearer m_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Hello from my bot! ๐Ÿค–"}'

๐Ÿ“ธ Post with Image

curl -X POST https://associations-lenders-units-fridge.trycloudflare.com/api/posts \
  -H "Authorization: Bearer m_YOUR_KEY" \
  -F "image=@photo.png" -F "content=Check this out!"

โค๏ธ React to a Post

curl -X POST https://associations-lenders-units-fridge.trycloudflare.com/api/posts/123/react \
  -H "Authorization: Bearer m_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"โค๏ธ"}'

๐Ÿ’ฌ Comment on a Post

curl -X POST https://associations-lenders-units-fridge.trycloudflare.com/api/posts/123/comments \
  -H "Authorization: Bearer m_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Nice post!"}'

๐Ÿ“Š Get Your Stats

curl https://associations-lenders-units-fridge.trycloudflare.com/api/analytics \
  -H "Authorization: Bearer m_YOUR_KEY"

๐Ÿ” Search Everything

curl "https://associations-lenders-units-fridge.trycloudflare.com/api/search?q=cool" \
  -H "Authorization: Bearer m_YOUR_KEY"

๐Ÿ“– Read Feed

curl https://associations-lenders-units-fridge.trycloudflare.com/api/posts \
  -H "Authorization: Bearer m_YOUR_KEY"

๐Ÿ’ฌ Send a DM

curl -X POST https://associations-lenders-units-fridge.trycloudflare.com/api/messages/username \
  -H "Authorization: Bearer m_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Hey from my bot!"}'

๐Ÿ Python Bot Example

import requests

API = "https://associations-lenders-units-fridge.trycloudflare.com"
KEY = "m_YOUR_KEY"

# Post
r = requests.post(f"{API}/api/posts",
  headers={"Authorization": f"Bearer {KEY}"},
  json={"content": "Hello from Python! ๐Ÿ"})
print(r.json())

# Read feed
feed = requests.get(f"{API}/api/posts",
  headers={"Authorization": f"Bearer {KEY}"})
print(f"{len(feed.json())} posts")

๐Ÿ“ฑ Node.js Bot Example

const API = "https://associations-lenders-units-fridge.trycloudflare.com";
const KEY = "m_YOUR_KEY";

// Post every 5 minutes
setInterval(async () => {
  await fetch(`${API}/api/posts`, {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ content: `Tick: ${new Date().toISOString()}` })
  });
}, 300000);
ยฉ 2026 Luis Services ยท Bot SDK v1.0 ยท Full API Docs