Docs/API Reference

API Reference

Build custom integrations and automate your content workflow with the ScribePilot API.

Base URL

https://www.scribepilot.ai/api/v1

Quick Example

JavaScript
// Start async blog generation
const response = await fetch('https://www.scribepilot.ai/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    topic: 'The Future of AI in Content Marketing',
    targetWordCount: 1500,
    tone: 'professional',
    quality: 'premium', // or 'economy' for budget-friendly (10x fewer credits)
  }),
});

const { runId, creditsReserved, statusUrl } = await response.json();

// Poll for completion
const status = await fetch(statusUrl, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
});
console.log(await status.json()); // { status, progress, result }

Available Endpoints

MethodEndpointDescription
POST/api/v1/generateStart async blog generation (returns runId)
GET/api/v1/generate/statusPoll for generation progress
POST/api/v1/generate/cancelCancel in-progress generation
GET/api/v1/creditsGet credit balance and pricing
GET/api/v1/postsList all generated posts
GET/api/v1/posts/:idGet a specific post by ID
PATCH/api/v1/posts/:idUpdate a post (e.g. publish)
DELETE/api/v1/posts/:idDelete a post

Rate Limits

PlanRequests per Hour
Starter10
Pro100
Growth500
Agency1,000

Rate limits are applied per API key. Create multiple keys to segment your usage.

Need help with the API?

Our team is ready to assist with your integration.

Contact Support