Prompterella

API Documentation

Integrate Prompterella into your application to stage context programmatically and route users to their preferred AI provider. Designed for simple, stateless handoffs.

Integration Flow

To use Prompterella, your application needs to perform two simple steps:

  1. Stage the Context: Send your prompt and data to our API.
  2. Redirect the User: Navigate the user to the returned gatewayUrl.

This stateless approach ensures you don't need to manage complex AI sessions - just hand off the context, and we'll handle the routing.

Client IntegrationJavaScript
const response = await fetch('https://prompterella.link/api/v1/stage', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: 'Analyze this code for bugs',
    text: codeContent,
  })
});

const { gatewayUrl } = await response.json();
window.location.href = gatewayUrl;

Browser Bookmarklet

Want to summarize pages while browsing? Drag the button below to your bookmarks bar to install the Prompterella Tool.

✨ Prompterella Tool

↑ Drag this button to your browser's bookmarks bar

How to use:

  1. Navigate to any article or page you want to process.
  2. Click the Prompterella Tool in your bookmarks.
  3. A "✨ Ask AI" button will appear in the bottom-right corner.
  4. Click it to stage the page content and open the Gateway.
POST/api/v1/stage

Stage a prompt and context for AI consumption. This endpoint accepts your payload and returns a unique, time-limited ID and a gateway URL.

Request Body

FieldTypeRequiredDescription
promptstringYesThe instruction for the AI model.
textstringYesThe primary context/article/code payload.
sourceUrlstringNoOptional reference URL for the source.

🔒 Data Retention

All staged contexts are stored in memory and automatically purged after 2 hours. We do not store data long-term.

Example RequestcURL
curl -X POST https://prompterella.link/api/v1/stage \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Summarize this article",
    "text": "Your large context here...",
    "sourceUrl": "https://example.com/article"
  }'
ResponseJSON
{
  "id": "abc123xyz",
  "gatewayUrl": "https://prompterella.link/gateway/abc123xyz",
  "expiresAt": "2026-02-08T20:19:42.342Z"
}