#What Article API solves
The Article API provides 2 powerful endpoints for AI-powered content creation and validation: generate complete, SEO-optimized articles from a brief, and validate existing content for quality metrics. Supports multiple output formats, writing tones and styles, keyword optimization, and human-like writing levels. Perfect for content marketing, blog automation, editorial workflows, and quality assurance.
#Available endpoints
#POST /v1/article/generate
- Best for: Creating complete, publication-ready articles from a brief description
- Use case: Blog posts, marketing content, SEO articles, guides, tutorials
#POST /v1/article/validate
- Best for: Evaluating article quality, readability, and compliance with requirements
- Use case: Quality assurance, editorial review, content auditing, compliance checking
#Quick start
# Generate a simple article
curl -X POST "https://api.yeb.to/v1/article/generate" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"brief": "Write about the benefits of remote work for software developers",
"length": 1500
}'
# Generate with full customization
curl -X POST "https://api.yeb.to/v1/article/generate" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"brief": "Complete guide to container orchestration with Kubernetes",
"title": "Kubernetes 101: From Zero to Production",
"format": "markdown",
"length": 3000,
"niche": "technology",
"tone": "professional",
"style": "tutorial",
"optimization": "both",
"human_like": "high"
}'
# Validate an article
curl -X POST "https://api.yeb.to/v1/article/validate" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"article_content": "Your article text here...",
"details": {
"niche": "technology",
"expected_length": 1500
}
}'
#Key parameters explained
#Generate endpoint parameters
| Param | Type | Default | Description |
|---|---|---|---|
brief |
string | Required | Description of the article to generate (max 250 words) |
title |
string | Auto-generated | Article title (if empty, AI generates one) |
format |
string | markdown | Output: markdown, html, json, plain_text |
length |
integer | 1500 | Target word count (100-10000) |
niche |
string | general | Topic: technology, marketing, lifestyle, finance, health, business |
tone |
string | neutral | Voice: neutral, formal, casual, professional, friendly, authoritative |
style |
string | article | Format: first_person, third_person, commentary, article, opinion, guide, tutorial |
optimization |
string | both | SEO focus: seo, ai_search, both, none |
keywords |
object | null | Keyword config: {"whitelist":[], "blacklist":[], "neutral":[]} |
human_like |
string | high | Human writing level: low, medium, high |
temperature |
float | 0.7 | AI creativity (0.0-2.0) |
#Validate endpoint parameters
| Param | Type | Default | Description |
|---|---|---|---|
article_content |
string | Required | The article text to validate |
details |
object | null | Validation criteria (niche, expected_length, format, tone, style, etc.) |
#Reading & handling responses
#Generate response
{
"article": {
"title": "The Complete Guide to Remote Work for Developers",
"content": "# The Complete Guide to Remote Work...\n\n## Introduction\n...",
"format": "markdown",
"word_count": 1523,
"reading_time_minutes": 6
},
"response_code": 200,
"response_time_ms": 12456
}
#Validate response
{
"overall_quality_rate": 0.85,
"sensitive_rate": 0.05,
"spam_score_rate": 0.12,
"validation_passed": true,
"scores": {
"readability": 0.88,
"grammar": 0.95,
"structure": 0.82,
"keyword_usage": 0.78,
"originality": 0.90
},
"issues": [],
"recommendations": [
"Consider adding more H2 headings for better structure",
"Increase keyword variations for better SEO"
],
"response_code": 200,
"response_time_ms": 2340
}
#Error responses
{ "error": "brief is required", "code": 422, "response_code": 422 }
{ "error": "Invalid API key", "code": 401, "response_code": 401 }
- 401: Invalid or missing API key
- 402: Insufficient credits
- 422: Missing required parameters or invalid format
- 429: Rate limit exceeded
- 500: Server error (retry with exponential backoff)
#Real-world use cases
#Automated blog content
Challenge: Generate SEO-optimized blog posts at scale
Solution: Use generate with keywords and optimization settings
POST /v1/article/generate
{
"brief": "Write about cloud cost optimization strategies",
"niche": "technology",
"tone": "professional",
"style": "guide",
"optimization": "seo",
"keywords": {
"whitelist": ["cloud costs", "AWS", "cost optimization"],
"blacklist": ["cheap", "free trial"]
},
"length": 2000
}
#Editorial quality assurance
Challenge: Review articles before publication
Solution: Validate content quality and compliance
// Generate article
POST /v1/article/generate {...}
// Validate before publishing
POST /v1/article/validate {
"article_content": "Generated article content...",
"details": {
"niche": "technology",
"expected_length": 2000,
"tone": "professional"
}
}
// Check validation_passed before publishing
#Best practices
- Write detailed briefs: More context = better articles. Include key points to cover.
- Use appropriate lengths: 1000-2000 words for blog posts, 2500-5000 for guides
- Match tone to audience: Professional for B2B, casual for consumer content
- Validate before publishing: Use the validate endpoint for quality assurance
- Leverage keywords wisely: Whitelist for must-include, blacklist for brand safety
- Set human_like to high: For content that needs to pass AI detection
- Handle long responses: Generation can take 10-30 seconds for long articles