REST API documentation for TendSocial - AI-powered social media content platform.

Quick Links

• 🔗 Interactive API Explorer - Try endpoints directly in your browser
• Base URL: https://api.tendsocial.com (Production) or http://localhost:5000 (Development)
• Authentication: JWT-based auth via Supabase
• API Version: v1 (current)

📖 Reference Documentation

• Complete API Reference - All endpoints with examples
• Admin AI Reference - Platform admin AI configuration endpoints

Endpoint Categories

Public Endpoints (/api/public/*)

• Package/pricing information
• OAuth callbacks
• Public resources (no auth required)

Platform Admin (/api/platform/*)

• System settings and configuration
• User and company management
• Analytics and reporting
• Feature flags

Company/Tenant (/api/company/*)

• Company-scoped resources
• Posts, campaigns, assets
• Analytics connections
• Team management

User (/api/user/*)

• User profile
• Social account connections
• Personal settings

📚 Integration Guides

• Authentication Guide - API key management and JWT auth
• OAuth Setup - Configure social media platform OAuth

🔍 Feature-Specific References

• Assets API - Media library and file uploads
• File Upload API - Multipart file upload endpoints
• Inbox API - Social media inbox integration
• Link-in-Bio API - Bio page management
• Media Endpoints - Social media posting

🛠️ Development

Authentication

All protected endpoints require a JWT token in the Authorization header:

Authorization: Bearer <your_jwt_token>

Rate Limiting

• Authenticated requests: 100 requests per minute per user
• Public endpoints: 20 requests per minute per IP

Response Format

All responses use JSON with consistent error handling:

{
  "success": true,
  "data": { /* response data */ }
}

Error Responses

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  }
}

🔗 Related Documentation

• Developer Documentation - Architecture and implementation details
• Client Documentation - User-facing feature documentation