🚀 SocialForge API

White-Label AI Social Media Generation for Agencies

📚 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

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