API Documentation

Integrate AI Post Prompt into your applications

Quick Start

Get started with our API in minutes

Get Started
Swagger UI

Interactive API documentation

Open Swagger
Code Examples

Sample code in multiple languages

View Examples

Quick Start

Base URL
https://aipostprompt.in/api
Authentication

Currently, the API is open and doesn't require authentication. This will change in future versions.

Response Format

All responses are in JSON format with proper HTTP status codes.

Available Endpoints

POST /api/posts/generate

Generate a social media post with AI

Request Body:
{
  "topic": "AI tools for startups",
  "platform": "LinkedIn",
  "tone": "Professional",
  "regionalVibe": "ProfessionalHinglish",
  "enableAntiAIFilter": true,
  "includeHashtags": true,
  "includeEmojis": true,
  "generateCommentStrategies": true,
  "targetAudience": "Tech entrepreneurs",
  "personalContext": "Optional personal experience"
}
Response:
{
  "generatedPost": "Your AI-generated post...",
  "viralScore": {
    "score": 8.5,
    "factors": [...]
  },
  "metadata": {
    "wordCount": 150,
    "hashtags": ["#AI", "#Startups"]
  },
  "alternativeVersions": [...],
  "commentStrategies": [...]
}
POST /api/posts/quick-generate

Quick generate with minimal parameters

Request Body:
{
  "topic": "AI in Indian Startups",
  "language": "Hinglish"
}
POST /api/carousel/generate

Generate a PDF carousel for LinkedIn

Request Body:
{
  "topic": "10 AI Tools for Startups",
  "template": "Listicle",
  "numberOfSlides": 10,
  "regionalVibe": "BangaloreTech",
  "targetAudience": "Startup founders",
  "brandColors": ["#4285F4", "#34A853", "#FBBC05"]
}
GET /health

Check API health status

Code Examples

JavaScript / Fetch API
const response = await fetch('https://aipostprompt.in/api/posts/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    topic: 'AI tools for startups',
    platform: 'LinkedIn',
    tone: 'Professional',
    regionalVibe: 'ProfessionalHinglish',
    enableAntiAIFilter: true
  })
});

const data = await response.json();
console.log(data.generatedPost);
C# / HttpClient
using var client = new HttpClient();
var request = new
{
    topic = "AI tools for startups",
    platform = "LinkedIn",
    tone = "Professional",
    regionalVibe = "ProfessionalHinglish",
    enableAntiAIFilter = true
};

var response = await client.PostAsJsonAsync(
    "https://aipostprompt.in/api/posts/generate", 
    request
);

var result = await response.Content.ReadFromJsonAsync();
Console.WriteLine(result.GeneratedPost);
Python / Requests
import requests

response = requests.post(
    'https://aipostprompt.in/api/posts/generate',
    json={
        'topic': 'AI tools for startups',
        'platform': 'LinkedIn',
        'tone': 'Professional',
        'regionalVibe': 'ProfessionalHinglish',
        'enableAntiAIFilter': True
    }
)

data = response.json()
print(data['generatedPost'])

Additional Resources