API Documentation

API Overview
Access the Social Media Connect platform programmatically through our REST API

Our API allows you to integrate Social Media Connect features into your own applications. All API endpoints require authentication using an API key.

Base URL: https://yourdomain.com/api

Content Generation API
Generate AI content programmatically

Generate Content

POST /api/content/generate

Generate content using Llama 3.3 70B Instruct Turbo model

Request Body

{
  "contentType": "blog-post",  // Required: blog-post, product-description, ad-copy, social-media, email, landing-page, seo
  "topic": "10 Tips for SEO",  // Required: The topic or title of the content
  "keywords": "seo, search engine, ranking",  // Optional: Keywords to include
  "instructions": "Focus on beginner-friendly tips",  // Optional: Additional instructions
  "tone": "professional",  // Required: professional, casual, friendly, authoritative, persuasive, humorous
  "length": "medium"  // Required: short, medium, long, very-long
}

Response

{
  "success": true,
  "content": "Generated content text...",
  "timestamp": "2025-05-13T22:33:16.000Z",
  "metadata": {
    "contentType": "blog-post",
    "topic": "10 Tips for SEO",
    "keywords": "seo, search engine, ranking",
    "tone": "professional",
    "length": "medium",
    "generatedAt": "2025-05-13T22:33:16.000Z"
  }
}

Error Responses

{
  "success": false,
  "error": "Error message describing what went wrong"
}

Example Usage (JavaScript)

// Using fetch API
async function generateContent() {
  const response = await fetch('https://yourdomain.com/api/content/generate', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY'
    },
    body: JSON.stringify({
      contentType: 'blog-post',
      topic: '10 Tips for SEO',
      keywords: 'seo, search engine, ranking',
      tone: 'professional',
      length: 'medium'
    })
  });
  
  const data = await response.json();
  
  if (data.success) {
    console.log('Generated content:', data.content);
  } else {
    console.error('Error:', data.error);
  }
}