PromptWeb API

🔌 Overview

The PromptWeb API will allow you to create, update, and manage websites programmatically. Perfect for:

• AI Agents: Give your agent the power to create websites for users
• SaaS Platforms: Embed website generation as a feature
• Automation Tools: Batch-create landing pages or portfolios
• Integration Partners: Connect PromptWeb to your existing tools

📋 Planned Endpoints

The following endpoints are planned for the initial API release:

{
  "name": "My Portfolio",
  "description": "Create a portfolio with dark theme and project grid",
  "subdomain": "john-portfolio"  // optional
}

{
  "id": "site_abc123",
  "name": "My Portfolio",
  "url": "https://john-portfolio.promptweb.ai",
  "status": "live",
  "created_at": "2026-02-25T14:30:00Z"
}

{
  "edit": "Make the header blue and add a contact form"
}

🔑 Authentication

The API will support multiple authentication methods:

API Keys (Recommended for Agents)

Generate API keys in your dashboard. Include in the Authorization header:

Authorization: Bearer sk_live_abc123...

OAuth 2.0 (For Third-Party Integrations)

Standard OAuth flow for user-authorized integrations. Supports authorization code and client credentials grants.

⚡ Rate Limits

API rate limits will be based on your pricing tier:

Pricing shown above is preliminary and subject to change before launch.

📚 SDKs & Libraries

Official client libraries will be available for popular languages:

• JavaScript/TypeScript: npm install @promptweb/sdk
• Python: pip install promptweb
• Go: go get github.com/promptweb/go-sdk
• Ruby: gem install promptweb

Example Usage (JavaScript)

import { PromptWeb } from '@promptweb/sdk';

const client = new PromptWeb({ apiKey: 'sk_live_...' });

// Create a new site
const site = await client.sites.create({
  name: 'My Portfolio',
  description: 'Portfolio with dark theme and project grid'
});

console.log(`Site live at: ${site.url}`);

// Update the site
await client.sites.update(site.id, {
  edit: 'Add a contact form with email field'
});

// Take screenshot
const screenshot = await client.sites.screenshot(site.id);
console.log(screenshot.url);

🎯 Use Cases

For AI Agent Developers

Give your agent the ability to create websites:

// User: "Create a landing page for my new product"
// Your agent:
const site = await promptweb.sites.create({
  name: "Product Landing",
  description: userRequest
});
await agent.reply(`Your landing page is live: ${site.url}`);

For SaaS Platforms

Offer website generation as a feature:

// When user signs up, create their profile page
const site = await promptweb.sites.create({
  name: `${user.name}'s Profile`,
  description: `Professional profile page for ${user.bio}`
});
await db.users.update(user.id, { profileUrl: site.url });

For Automation Tools

Batch-create landing pages from a spreadsheet:

for (const row of spreadsheet) {
  const site = await promptweb.sites.create({
    name: row.campaignName,
    description: row.pageDescription
  });
  row.landingPageUrl = site.url;
}

📬 Join the Waitlist

Want early access to the API? We're onboarding partners in phases.

To join the waitlist:

1. Send a message to @promptweb_bot
2. Describe your use case and expected volume
3. We'll reach out when your spot is available

🔗 Current Integration Option

While waiting for the REST API, you can integrate PromptWeb today using our Telegram bot:

Telegram Bot API Integration

Use any Telegram bot library to interact with @promptweb_bot programmatically:

// Example with grammY (Node.js)
import { Bot } from "grammy";

const userBot = new Bot("YOUR_BOT_TOKEN");

// Forward user requests to PromptWeb bot
userBot.on("message", async (ctx) => {
  await ctx.api.sendMessage(
    "@promptweb_bot", 
    ctx.message.text
  );
});

userBot.start();

Advantages: Available now, same features as human users, no separate API key needed.

Limitations: Requires Telegram bot token, less structured than REST API, rate limits apply.