API Documentation

Integrate reblogger.ai into your applications with our comprehensive REST API

API Overview

Everything you need to know about the reblogger.ai API

Base URL: https://reblogger.ai/api/v1

Authentication: Bearer Token (API Key)

Content-Type: application/json

Secure

API key authentication

Fast

Optimized for speed

Simple

Easy to integrate

Authentication

How to authenticate your API requests

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Getting Your API Key

Sign up for an account on the platform
Go to your profile page
Navigate to the "API Keys" section
Click "Create New Key"
Copy the key (it's only shown once!)

Available Models

Complete list of AI models available for article generation

Text Generation Models

Cost-Effective Models

Model	Provider	Input/Output ($/1M)	Context	Features
`gpt-5-nano`	openai	$0.05/$0.4	Unlimited	System
`gpt-4.1-nano`	openai	$0.1/$0.4	8K	System Stream
`gpt-4o-mini`	openai	$0.15/$0.6	16K	System Stream
`claude-3-5-haiku-latest`	claude	$0.8/$4	8K	System Stream
`grok-3-mini`	grok	$0.3/$0.5	4K	Stream

Mid-Range Models

Model	Provider	Input/Output ($/1M)	Context	Features
`gpt-5-mini`	openai	$0.25/$2	Unlimited	System
`gpt-4.1-mini`	openai	$0.4/$1.6	8K	System Stream
`grok-4-fast-reasoning`	grok	$0.2/$0.5	4K	Stream
`grok-4-fast-non-reasoning`	grok	$0.2/$0.5	4K	Stream
`claude-sonnet-4-5`	claude	$3/$15	4K	System Stream
`claude-sonnet-4-0`	claude	$3/$15	4K	System Stream
`claude-3-7-sonnet-latest`	claude	$3/$15	4K	System Stream

Premium Models

Model	Provider	Input/Output ($/1M)	Context	Features
`gpt-5`	openai	$1.25/$10	Unlimited	System
`gpt-4.1`	openai	$2/$8	4K	System Stream
`gpt-4o`	openai	$2.5/$10	4K	System Stream
`grok-3`	grok	$3/$15	4K	Stream
`claude-opus-4-1`	claude	$15/$75	4K	System Stream
`claude-opus-4-0`	claude	$15/$75	4K	System Stream

Image Generation Models

Model	Provider	Description
`gpt-image-1`	openai	OpenAI image generation model (text-to-image)
`gpt-image-1-mini`	openai	OpenAI lighter image model
`dall-e-3`	openai	OpenAI image generation model
`black-forest-labs/flux-schnell`	replicate	Fast Flux model
`black-forest-labs/flux-dev`	replicate	Higher quality Flux Dev model
`black-forest-labs/flux-1.1-pro-ultra`	replicate	Flux high-end model (Pro Ultra)
`black-forest-labs/flux-1.1-pro`	replicate	Flux Pro
`google/nano-banana`	replicate	Google image model
`bytedance/seedream-4`	replicate	ByteDance image model

💡 Tips

Cost-Effective: Best for high-volume, budget-conscious workflows
Mid-Range: Balanced performance and cost for most use cases
Premium: Maximum quality for high-value content
Default: gpt-5-nano gpt-5-nano for text and black-forest-labs/flux-schnell for images

Generate Article (Async API)

Create new articles using the async API - no timeouts, real-time progress tracking

Endpoint: POST /api/v1/generate

Description: Generate a new article using AI (asynchronous processing)

Response: Returns immediately with job ID for progress tracking

🚀 Async Benefits

No Timeouts: Long generations (5-10+ minutes) won't timeout
Real-time Progress: Track exactly what's happening with detailed steps
Non-blocking: Start multiple generations simultaneously
Resilient: Resume polling if connection drops
Better UX: Users get immediate feedback and can track progress

Request Parameters

Parameter	Type	Required	Description
`topic`	string	No*	Article topic (required if source_url not provided)
`source_url`	string	No*	URL to extract content from (required if topic not provided)
`model`	string	No	AI model to use (default: gpt-5-nano)
`language`	string	No	Language code (en, de, fr, es, etc.)
`image_model`	string	No	Image generation model

* Either topic or source_url is required

Example Request

curl -X POST "https://reblogger.ai/api/v1/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "The Future of Artificial Intelligence",
    "model": "gpt-5-nano",
    "language": "en",
    "image_model": "dall-e-3"
  }'

Example Response (Immediate)

{
  "success": true,
  "jobId": "clx123abc456def",
  "articleId": "clx789ghi012jkl",
  "status": "pending",
  "message": "Article generation started. Use the job ID to check progress and get results."
}

Polling for Results

Use the job ID to check progress and get the final article:

GET /api/v1/job/clx123abc456def

// Response while processing:
{
  "success": true,
  "job": {
    "jobId": "clx123abc456def",
    "status": "processing",
    "progress": 45,
    "currentStep": "Generating article sections...",
    "totalSteps": 4,
    "createdAt": "2024-01-17T14:48:56Z",
    "updatedAt": "2024-01-17T14:49:12Z"
  }
}

// Response when completed:
{
  "success": true,
  "job": {
    "jobId": "clx123abc456def",
    "status": "completed",
    "progress": 100,
    "currentStep": "Generation completed",
    "completedAt": "2024-01-17T14:50:23Z",
    "result": {
      "article": {
        "title": "The Future of Artificial Intelligence: A Comprehensive Guide",
        "content": "<h1>The Future of Artificial Intelligence</h1><p>...</p>",
        "wordCount": 2500,
        "metaDescription": "Explore the future of AI...",
        "coverImageUrl": "https://example.com/cover.jpg"
      },
      "cost": {
        "prompt": 0.15,
        "completion": 0.45,
        "total": 0.60
      },
      "outline": { /* article structure */ },
      "images": [ /* generated images */ ]
    }
  }
}

Error Handling

Understanding API errors and how to handle them

400 Bad Request

Invalid parameters or missing required fields

{
  "error": "Either topic or source_url is required"
}

401 Unauthorized

Invalid or missing API key

{
  "error": "Invalid or missing API key"
}

Code Examples

Integration examples in multiple programming languages

// Start async generation
const response = await fetch('https://reblogger.ai/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    topic: 'The Future of AI',
    model: 'gpt-5-nano',
    language: 'en',
    image_model: 'black-forest-labs/flux-schnell'
  })
});

const { jobId, articleId } = await response.json();
console.log('Job started:', jobId);

// Poll for progress
const pollJob = async () => {
  const statusResponse = await fetch(`https://reblogger.ai/api/v1/job/${jobId}`, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });
  
  const status = await statusResponse.json();
  console.log('Progress:', status.job.progress + '%', status.job.currentStep);
  
  if (status.job.status === 'completed') {
    console.log('Article ready:', status.job.result.article.title);
    return status.job.result;
  } else if (status.job.status === 'failed') {
    console.error('Generation failed:', status.job.error);
    return null;
  } else {
    // Still processing, poll again in 5 seconds
    setTimeout(pollJob, 5000);
  }
};

pollJob();

Article Generation Limits

Monthly article generation limits based on your subscription plan

Free

Perfect for trying out AI content generation

4 articles/month

Topic-based only

Basic AI models

Starter

Perfect for individual bloggers and content creators

25 articles/month

Topic-based only

Basic AI models

Professional

Ideal for growing businesses and content teams

60 articles/month

Topic-based, Source-based (WordPress, Medium, etc.)

All AI models

API access

Enterprise

For large teams and agencies with high content needs

Unlimited articles

Topic-based, Source-based (WordPress, Medium, etc.)

All AI models

API access

Dedicated support