Back to Knowledge Base
Developer Guide

API Reference

Complete REST API documentation. Generate articles, manage projects, and integrate with your applications.

Base URL

/api/v1

Auth

Bearer Token

Rate Limit

100 req/hr

Format

JSON

Authentication

All API requests require authentication using a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY
Never share your API key publicly. Keep it secure on your server.

Quick Example

Fetch your articles in 3 lines of code

curl
curl -H "Authorization: Bearer YOUR_API_KEY"
  "https://autoblogging.pro/api/v1/articles"

Endpoints

GET/api/v1/projects
Bearer Token100/hour

List all projects

Request

curl -X GET "https://autoblogging.pro/api/v1/projects" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "projects": [
    {
      "id": "proj_123",
      "title": "My Tech Blog",
      "domain": "techblog.com",
      "status": "active",
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}
POST/api/v1/projects
Bearer Token50/hour

Create a new project

Request

curl -X POST "https://autoblogging.pro/api/v1/projects" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My New Blog",
    "domain": "myblog.com",
    "primaryLanguage": "en"
  }'

Response

{
  "id": "proj_456",
  "title": "My New Blog",
  "domain": "myblog.com",
  "status": "active",
  "createdAt": "2024-01-15T10:30:00Z"
}
GET/api/v1/articles
Bearer Token200/hour

List articles for a project

Request

curl -X GET "https://autoblogging.pro/api/v1/articles?projectId=proj_456" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "articles": [
    {
      "id": "art_789",
      "title": "10 Tips for Better SEO",
      "status": "published",
      "wordCount": 1250,
      "createdAt": "2024-01-15T11:00:00Z"
    }
  ],
  "total": 1
}
POST/api/v1/articles/generate
Bearer Token30/hour

Generate a new article

Request

curl -X POST "https://autoblogging.pro/api/v1/articles/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "proj_456",
    "articleType": "how-to",
    "keywords": ["SEO tips", "content marketing"]
  }'

Response

{
  "id": "art_999",
  "status": "generating",
  "estimatedTime": 120,
  "message": "Article generation started"
}
GET/api/v1/webhooks
Bearer Token100/hour

List all webhooks

Request

curl -X GET "https://autoblogging.pro/api/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "webhooks": [
    {
      "id": "wh_123",
      "url": "https://yoursite.com/webhook",
      "events": ["article.created", "article.published"],
      "status": "active"
    }
  ]
}
POST/api/v1/webhooks
Bearer Token50/hour

Create a new webhook

Request

curl -X POST "https://autoblogging.pro/api/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yoursite.com/webhook",
    "events": ["article.created", "article.published"],
    "secret": "your-webhook-secret"
  }'

Response

{
  "id": "wh_456",
  "url": "https://yoursite.com/webhook",
  "events": ["article.created", "article.published"],
  "status": "active",
  "createdAt": "2024-01-15T12:00:00Z"
}

Error Codes

400Bad Request

Invalid request parameters

401Unauthorized

Invalid or missing API key

403Forbidden

Rate limit exceeded

404Not Found

Resource does not exist

429Too Many Requests

Rate limit exceeded

500Server Error

Internal error

Need Help?

Check out our complete guide with SDK examples and best practices.