API Documentation

Integrate AI content generation, SEO briefs, and translation into your product with simple REST APIs.

https://api.kevcspot.com/v1

Authentication

All API requests require a Bearer token. Get your free API key at kevcspot.com.

curl -X POST https://api.kevcspot.com/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Write a blog post about AI tools","format":"blog"}'

Endpoints

POST

/v1/generate

Generate AI content from a prompt. Supports blog posts, product descriptions, emails, social posts, and more.

Parameter	Type	Required	Description
`prompt`	string	Yes	The content prompt or topic
`format`	string	No	Output format: blog, email, social, product, custom
`tone`	string	No	Tone: professional, casual, humorous, authoritative
`max_words`	integer	No	Max word count (default: 500)

Response 200

{
  "id": "gen_abc123",
  "content": "Generated content here...",
  "format": "blog",
  "word_count": 487,
  "usage": { "tokens": 1200 }
}

POST

/v1/seo-brief

Generate a structured SEO brief with keyword clusters, heading suggestions, and competitive analysis.

Parameter	Type	Required	Description
`keyword`	string	Yes	Target keyword or phrase
`niche`	string	No	Industry/niche context
`competitors`	array	No	Competitor URLs to analyze

Response 200

{
  "keyword": "best ai tools 2026",
  "clusters": ["ai writing", "ai coding", "ai design"],
  "headings": ["H1: ...", "H2: ...", "H2: ..."],
  "word_count_target": 2500,
  "related_keywords": [...]
}

POST

/v1/translate

Translate and adapt content into 30+ languages with voice-ready formatting for dubbing workflows.

Parameter	Type	Required	Description
`text`	string	Yes	Content to translate
`target_lang`	string	Yes	Target language code (es, fr, de, ja, etc.)
`voice_ready`	boolean	No	Format output for TTS/dubbing (default: false)

Response 200

{
  "translated": "Contenido traducido aqui...",
  "source_lang": "en",
  "target_lang": "es",
  "character_count": 2847
}

GET

/v1/usage

Check your current API usage, rate limits, and remaining quota.

Response 200

{
  "plan": "free",
  "calls_today": 45,
  "calls_limit": 100,
  "calls_remaining": 55,
  "reset_at": "2026-06-23T00:00:00Z"
}

Rate Limits

Plan	Calls/Day	Calls/Min	Price
Free	100	10	$0/mo
Pro	5,000/mo	60	$29/mo
Enterprise	50,000/mo	200	$199/mo

Error Codes

Code	Meaning	Solution
`401`	Unauthorized	Check your API key
`429`	Rate limited	Wait and retry, or upgrade plan
`422`	Invalid params	Check required fields
`500`	Server error	Retry with exponential backoff