Developer Documentation

Authentication

Currently, the API endpoints utilize standard PHP Session-based authentication. The API scripts automatically verify that the user making the request has an active login session.

Paywall Limits

Our endpoints have built-in metered paywalls to prevent abuse:

• Guest Users: Limited to 1 generation per tool. Returns a `limit_guest` string when exhausted.
• Free Accounts: Limited to 3 generations per tool. Returns a `limit_free` string when exhausted.
• Pro Accounts: Unlimited access. Requires $_SESSION['is_pro'] === 1.

Social Forge API

Generates a complete, highly-engaging 7-day social media content campaign formatted in raw HTML, ready for rendering in a web interface.

Request Parameters

Example Request

const response = await fetch('api_social_forge.php', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        brand: "Quantum Studio",
        topic: "Launching our new AI image generator.",
        platform: "LinkedIn"
    })
});
const data = await response.json();

Example Response

{
    "status": "success",
    "result": "<div class=\"doc-post\">...</div>"
}

Growth Toolkit API

A multi-purpose endpoint that handles Viral Hooks, Profile Bios, Smart Replies, and Email Subject extraction based on the provided toolType.

Core Request Parameters

Depending on the toolType, specific additional parameters are required:

• hook: requires topic, platform, and tone.
• bio: requires name and niche.
• reply: requires message and tone.
• email: requires content.

Example Request (Viral Hooks)

const response = await fetch('api_growth_toolkit.php', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        toolType: "hook",
        topic: "Why most startups fail in 6 months",
        platform: "TikTok / Reels",
        tone: "Controversial"
    })
});

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of an API request. Failed requests will always return a JSON object containing an error message.