📚 Getting Started
The SocialForge API allows you to integrate AI-powered social media content generation into your own products. Perfect for agencies, SaaS platforms, and marketing tools.
⚠️ Authentication Required: All endpoints require an API key. Include it in the X-API-Key header with every request.
Base URL
https://api.vemtrac.com
Authentication Example
curl -H "X-API-Key: sk_test_free" https://api.vemtrac.com/v1/usage
🔌 API Endpoints
POST /v1/generate
Generate a social media post with AI.
curl -X POST https://api.vemtrac.com/v1/generate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"topic": "sustainable fashion trends 2026",
"platform": "instagram",
"tone": "inspirational"
}'
Request Body:
- topic (string, required) - Content topic
- platform (string) - Target platform (instagram, twitter, linkedin, facebook)
- tone (string) - Content tone (professional, casual, inspirational, etc.)
POST /v1/hashtags
Generate relevant hashtags for your content.
curl -X POST https://api.vemtrac.com/v1/hashtags \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Just launched our new eco-friendly product line!",
"count": 10
}'
Request Body:
- content (string, required) - Your post content
- count (number) - Number of hashtags to generate (default: 5)
POST /v1/calendar
Generate a content calendar with AI-planned posts.
curl -X POST https://api.vemtrac.com/v1/calendar \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"theme": "fitness and wellness",
"days": 7,
"postsPerDay": 2
}'
Request Body:
- theme (string, required) - Content theme/niche
- days (number) - Number of days (default: 7)
- postsPerDay (number) - Posts per day (default: 1)
GET /v1/usage
Check your API usage statistics.
curl https://api.vemtrac.com/v1/usage \
-H "X-API-Key: YOUR_API_KEY"
Response: Returns usage data including requests used today, daily limit, and tier information.
💰 Pricing
Free
$0/month
- 100 requests/day
- All endpoints included
- Community support
- Perfect for testing
POPULAR
Pro
$29/month
- Unlimited requests
- All endpoints included
- Priority support
- 99.9% uptime SLA
- Advanced analytics
Agency
$99/month
- Everything in Pro
- White-label access
- Custom branding
- Dedicated support
- Reseller rights
- Custom domains
📊 Response Format
All successful responses return JSON with a 200 OK status code.
Success Response Example
{
"success": true,
"data": {
"post": "Your generated content here...",
"hashtags": ["#example", "#socialforge"]
}
}
Error Response Example
{
"error": "Rate limit exceeded",
"limit": 100,
"used": 100,
"reset": "Tomorrow at 00:00 UTC"
}
🔒 Rate Limits
- Free: 100 requests per day
- Pro: Unlimited requests
- Agency: Unlimited requests
Rate limits reset daily at 00:00 UTC. Use the /v1/usage endpoint to check your current usage.
🆘 Support
Need help? Contact us:
- 📧 Email: support@vemtrac.com
- 📚 Documentation: docs.vemtrac.com
- 💬 Discord: discord.gg/socialforge