supapost REST API v1
Integrate supapost into your applications and workflows. Generate AI-powered posts, manage content, create images, and more -- all through a simple REST API.
https://api.supapost.aiAll API requests require authentication using a Bearer token in the Authorization header. API keys can be generated from the dashboard settings and are available on all plans: Free (100 req/day),Pro (1,000 req/day),Agency (10,000 req/day).
curl -X GET https://api.supapost.ai/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY"Keep your API key secret. Do not share it in publicly accessible areas such as GitHub, client-side code, or browser requests. If a key is compromised, revoke it immediately from the dashboard.
Rate limits are applied per API key to ensure fair usage. When you exceed the limit, the API will return a 429 Too Many Requests response.
| Endpoint | Limit |
|---|---|
| Most endpoints | 60 req/min |
| Image generation | 20 req/min |
Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.
All errors return a consistent JSON structure with a status code and message.
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"status": 401
}
}| Status | Code | Description |
|---|---|---|
| 400 | BAD_REQUEST | Invalid request body or parameters |
| 401 | UNAUTHORIZED | Missing or invalid API key |
| 403 | FORBIDDEN | API access not available on your plan |
| 404 | NOT_FOUND | Resource not found |
| 429 | RATE_LIMITED | Too many requests |
| 500 | INTERNAL_ERROR | Something went wrong on our end |
Click on an endpoint to expand its documentation including parameters, examples, and response formats.
/api/v1/content/generate/api/v1/strategy/generate/api/v1/content/repurpose/api/v1/blogs/api/v1/blogs/api/v1/newsletters/api/v1/newsletters/api/v1/usage/api/v1/workspaces/api/v1/posts/generate/api/v1/posts/api/v1/posts/api/v1/posts/:id/api/v1/posts/:id/api/v1/posts/:id/api/v1/images/generate/api/v1/templates/api/v1/topics/suggest