v1 REST API for engaging social posts, smart replies, blogs, and newsletters.
Integrate supapost into your applications and workflows. Generate AI-powered posts, manage content, create images, and more -- all through a simple REST API.
https://supapost.ai/api/v1All 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 (50 req/day),Pro (500 req/day),Agency (2,000 req/day).
curl -X GET https://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.
Errors return a JSON object with an error string and the HTTP status. Plan-tier and quota errors include extra context fields (feature, current_plan, limit, reset_at) at the top level.
{
"error": "Invalid or missing API key"
}| Status | Code | Description |
|---|---|---|
| 400 | BAD_REQUEST | Invalid request body or parameters |
| 401 | UNAUTHORIZED | Missing or invalid API key |
| 402 | PAYMENT_REQUIRED | Feature requires a paid plan; response includes feature, current_plan, required_plans |
| 404 | NOT_FOUND | Resource not found |
| 429 | RATE_LIMITED | Daily, per-minute, or monthly quota exceeded; response includes limit and reset_at |
| 500 | INTERNAL_ERROR | Something went wrong on our end |
| 502 | UPSTREAM_ERROR | AI provider rejected or errored (e.g. content policy) |
| 503 | UNAVAILABLE | Plan limits or AI service not configured. Contact support |
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