🔌 Overview

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

💡 Getting Started: API keys are available now! Contact @promptweb_bot to request API access. See full API documentation for detailed integration guides.

📋 Available Endpoints

The PromptWeb REST API provides the following endpoints:

POST /api/v1/sites
Create a new website from a natural language description. Returns site URL and metadata.

Request Body

{
  "name": "My Portfolio",
  "prompt": "Create a portfolio with dark theme and project grid",
  "subdomain": "john-portfolio",  // optional
  "model": "flash"  // or "pro"
}

Response

{
  "id": 123,
  "slug": "john-portfolio",
  "name": "My Portfolio",
  "url": "https://john-portfolio.promptweb.ai",
  "created_at": 1703275200
}
PATCH /api/v1/sites/:slug
Update an existing site with natural language edits. Returns job ID for async processing.

Request Body

{
  "prompt": "Make the header blue and add a contact form"
}
GET /api/v1/sites/:slug
Retrieve site information including URL, status, creation date, and metadata.
GET /api/v1/sites
List all sites owned by your API key. Supports pagination, filtering, and sorting.
DELETE /api/v1/sites/:slug
Permanently delete a site and all associated files. Cannot be undone.

Plus: Authentication endpoints, webhook management, usage analytics, and more. See full API documentation for complete reference.

🔑 Authentication

The API uses Bearer token authentication with API keys:

API Keys

Generate API keys via @promptweb_bot. Include in the Authorization header:

Authorization: Bearer sk_live_abc123...

To get an API key:

  1. Message @promptweb_bot
  2. Use /api register command
  3. Receive your API key instantly

⚡ Rate Limits

API rate limits are based on your pricing tier:

Free

$0/mo
  • 100 requests/hour
  • 1,000 requests/day
  • 100 sites max
  • Community support

See full pricing details for volume discount tiers and resource limits.

🎯 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 response = await fetch('https://promptweb.ai/api/v1/sites', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Product Landing',
    prompt: userRequest
  })
});
const site = await response.json();
await agent.reply(`Your landing page is live: ${site.url}`);

For SaaS Platforms

Offer website generation as a feature in your product.

For Automation Tools

Batch-create landing pages from a spreadsheet or CMS.

📬 Get API Access

To start using the API:

  1. Message @promptweb_bot
  2. Use /api register to create an API key
  3. Read the API documentation
  4. Start building!
💡 Alternative: Telegram Bot Integration

You can also integrate PromptWeb using the Telegram Bot API. Use any Telegram bot library to interact with @promptweb_bot programmatically. We treat agents just like humans — same features, same access.

Ready to integrate PromptWeb?

Get your API key in seconds — no waiting list

Get API Key →