API v1
API Documentation
Generate AI content for multiple platforms via API or MCP.
Quick Start
- Get your API key at Account → API Keys
- Make your first request:
curl -X POST https://api.glowpost.kr/api/v1/generate \
-H "Authorization: Bearer gp_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"topic": "Remote work productivity tips",
"platforms": ["blog", "twitter", "linkedin"],
"tone": "casual",
"language": "en"
}'Authentication
All requests require an API key in the Authorization header:
Authorization: Bearer gp_your_api_key
API keys are shown once at creation. Store them securely — we can't retrieve them.
POST /api/v1/generate
Generate content for multiple platforms. Uses 1 credit.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| topic | string | Yes | Topic to write about (max 500) |
| context | string | No | Additional context (max 2000) |
| platforms | string[] | No | blog, twitter, linkedin, newsletter, instagram |
| tone | string | No | professional, casual, humorous, inspirational, educational |
| language | string | No | en, ko, ja (default: en) |
| blog_length | string | No | short, medium, long (default: medium) |
Example
curl -X POST https://api.glowpost.kr/api/v1/generate \
-H "Authorization: Bearer gp_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"topic": "Remote work productivity tips",
"platforms": ["blog", "twitter", "linkedin"],
"tone": "casual",
"language": "en"
}'GET /api/v1/balance
Check your credit balance.
curl https://api.glowpost.kr/api/v1/balance \ -H "Authorization: Bearer gp_your_api_key"
Response: { "credits": 14 }
GET /api/v1/history
View recent generations. Optional limit param (default 20, max 50).
curl https://api.glowpost.kr/api/v1/history?limit=5 \ -H "Authorization: Bearer gp_your_api_key"
MCP Server (Claude Code)
Use GlowPost directly in Claude Code, Cursor, or any MCP-compatible tool.
Installation
Add to your MCP config (claude_desktop_config.json):
{
"mcpServers": {
"glowpost": {
"command": "npx",
"args": ["-y", "glowpost-mcp"],
"env": {
"GLOWPOST_API_KEY": "gp_your_api_key"
}
}
}
}Available Tools
generate_contentGenerate content for multiple platforms from a topicget_balanceCheck your credit balanceget_historyView recent generation historyRate Limits
| Scope | Limit |
|---|---|
| Per API Key | 10 requests / minute |
| Per IP | 30 requests / minute |
| Auth failures | 10 failures / 5min → 15min block |
Rate limit info is returned in response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Error Codes
| Status | Error | Description |
|---|---|---|
| 401 | invalid_api_key | Missing or invalid API key |
| 402 | insufficient_credits | Not enough credits |
| 400 | invalid_request | Invalid parameters |
| 429 | rate_limited | Rate limit exceeded |
| 500 | generation_failed | AI generation error |