Quick Start Guide
1. Authentication
Get your API key from the dashboard and include it in your requests:
# Include your API key in headers
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
https://api.emerlya.com/v1/generate2. Basic Content Generation
Send a POST request to generate content:
# Generate blog content
POST /v1/generate
{
"prompt": "Write a blog about AI",
"type": "blog_post",
"brand_id": "your_brand_id"
}Core API Endpoints
POST
Content Generation
/v1/generateGenerate various types of content using AI with your brand voice and guidelines.
Parameters:
- •
prompt- Content description - •
type- Content type (blog, email, social) - •
brand_id- Brand profile ID - •
length- Content length preference
POST
Document Analysis
/v1/analyzeUpload and analyze documents to extract insights and improve content generation.
Parameters:
- •
file- Document file (PDF, DOCX) - •
brand_id- Brand profile ID - •
extract_guidelines- Extract brand guidelines - •
extract_knowledge- Extract knowledge base
GET
Brand Management
/v1/brandsManage brand profiles, voice settings, and content guidelines programmatically.
Operations:
- •
GET /brands- List all brands - •
POST /brands- Create new brand - •
PUT /brands/:id- Update brand - •
DELETE /brands/:id- Delete brand
GET
Analytics & Usage
/v1/analyticsGet insights on your content performance, API usage, and generation statistics.
Metrics:
- • Content generation count
- • Word usage statistics
- • Performance metrics
- • Rate limit information
Code Examples
JavaScript / Node.js
// Install: npm install emerlya-ai
const Emerlya = require('emerlya-ai');
const client = new Emerlya({
apiKey: 'your-api-key'
});
async function generateContent() {
const response = await client.generate({
prompt: 'Write marketing copy for AI tool',
type: 'marketing_copy',
brandId: 'brand_123'
});
console.log(response.content);
}Python
# Install: pip install emerlya-ai
import emerlya
# Initialize client
client = emerlya.Client(
api_key="your-api-key"
)
# Generate content
response = client.generate(
prompt="Create email newsletter content",
content_type="email",
brand_id="brand_123",
length="medium"
)
print(response.content)Rate Limits & Pricing
Rate Limits
- Starter: 100 requests/hour
- Professional: 1,000 requests/hour
- Enterprise: Custom limits
API Access Included
- Essentials: 1,000 requests/month included
- Professional: 5,000 requests/month included
- Business: 25,000 requests/month included
- Enterprise: 100,000 requests/month included