# Autoblogging.ai API Documentation

Source: https://autoblogging.ai/api-documentation/ · Updated: 2024-12-14

# Autoblogging.ai API Documentation

The Autoblogging.ai API allows you to programmatically create and retrieve AI-generated articles. This documentation provides detailed information about all available endpoints, parameters, and their possible values.

## Authentication

All API requests require your dashboard email and API key. You can manage your API keys in the [API Keys section](https://dash.autoblogging.ai/api/keys) of your dashboard.

## Base URL

https://dash.autoblogging.ai/api/v1

## Endpoints

### 1. Create Article

POST /articles

#### Complete Parameter Reference

| Parameter | Required | Type | Accepted Values | Description |
| --- | --- | --- | --- | --- |
| dashboard_email | Yes | string | Valid email address | Your dashboard email address |
| api_key | Yes | string | Valid API key | Your API key from the dashboard |
| request_type | Yes | string | “create_article” | Specifies the type of request |
| title | Yes | string | Non-empty string | The title for your article |
| project_name | No | string | Any string | Name of the project for organization |
| language | Yes | string | English EnglishUK Arabic Bulgarian Chinese Danish Dutch Estonian Finnish French German Greek Hindi Hungarian Indonesian Italian Japanese Korean Latvian Lithuanian Norwegian Polish Portuguese Portuguese_BR Romanian Russian Slovak Slovenian Spanish Swedish Turkish Vietnamese | The language for the generated article |
| length | Yes | string | short medium long | Desired length of the article |
| tone_of_voice | Yes | string | first-person second-person third-person | The narrative perspective of the article |
| writing_style | Yes | string | premium_writing_style_1 conversational professional witty snippet_optimizer less_ai_words | The writing style to be used |
| type_of_article | Yes | string | informative listicle places service_pages | The type of article to generate |
| faqs | Yes | string | yes no | Include FAQ section |
| imagegeneration | Yes | string | yes no | Generate images for article (+1 credit) |
| godlikemode | Yes | string | yes no | Enhanced article quality (+1 credit) |
| serp_location | Yes | string | Two-letter country code (e.g., “us”, “uk”, “de”) | Location for SERP analysis |
| outlinefromcompetition | Yes | string | yes no | Use competitor analysis for outline |
| keytakeaways | Yes | string | yes no | Include key takeaways section |
| externallinks | Yes | string | yes no | Include external links |
| videoembed | Yes | string | yes no | Include video embeddings |
| source_context | Yes | string | “na” or text (max 300 chars) | Additional context for article generation |
| wordpresspush | Yes | string | yes no | Push to WordPress |
| wp_siteurl | Only if wordpresspush=”yes” | string | Valid URL | WordPress site URL |
| wp_username | Only if wordpresspush=”yes” | string | WordPress username | WordPress username |
| wp_password | Only if wordpresspush=”yes” | string | WordPress password | WordPress password |
| wp_category | Only if wordpresspush=”yes” | string | WordPress category name | Category for the post |
| wp_status | Only if wordpresspush=”yes” | string | publish draft | Post status in WordPress |
| wp_customtext | No | string | “na” or custom text | Custom text for WordPress |
| applyautogenerateslugs | Yes | string | yes no | Auto-generate WordPress slugs |
| applyautogeneratetitles | Yes | string | yes no | Auto-generate WordPress titles |
| combotpush | Yes | string | yes no | Push to ComBot integration |
| combot_triggerid | Only if combotpush=”yes” | string | “na” or valid trigger ID | ComBot trigger ID |
| intense_optimize | Yes | string | yes no | Apply intense optimization |
| ai_proofreader | Yes | string | yes no | Use AI proofreading (+1 credit) |
| proofreading_guidelines | Only if ai_proofreader=”yes” | string | “na” or text (max 3000 chars) | Custom proofreading guidelines |
| infographics | Yes | string | yes no | Generate infographics (+1 credit) |

**Credit Usage Note:**

- Base article: 1 credit

- Godlike mode: +1 credit

- Image generation: +1 credit

- AI proofreader: +1 credit

- Infographics: +1 credit

#### Complete Example Requests

Python


import requests
import time

def create_and_fetch_article():
url = "https://dash.autoblogging.ai/api/v1/articles"

# Create article request
create_payload = {
"dashboard_email": "your-email@example.com",
"api_key": "your-api-key",
"request_type": "create_article",
"title": "Best Gaming Laptops in 2024",
"project_name": "Tech Reviews",
"language": "English",
"length": "medium",
"tone_of_voice": "third-person",
"writing_style": "professional",
"type_of_article": "informative",
"faqs": "yes",
"imagegeneration": "no",
"godlikemode": "yes",
"serp_location": "us",
"outlinefromcompetition": "yes",
"keytakeaways": "yes",
"externallinks": "yes",
"videoembed": "no",
"source_context": "na",
"wordpresspush": "no",
"wp_siteurl": "",
"wp_username": "",
"wp_password": "",
"wp_category": "",
"wp_status": "draft",
"wp_customtext": "na",
"applyautogenerateslugs": "no",
"applyautogeneratetitles": "no",
"combotpush": "no",
"combot_triggerid": "na",
"intense_optimize": "no",
"ai_proofreader": "no",
"proofreading_guidelines": "na",
"infographics": "no"
}

# Create article
response = requests.post(url, json=create_payload)
if response.status_code != 200:
print(f"Error creating article: {response.text}")
return

article_info = response.json()
article_id = article_info['article_id']
print(f"Article created! ID: {article_id}")
print(f"Credits used: {article_info['credits_used']}")

# Fetch article request
fetch_payload = {
"dashboard_email": "your-email@example.com",
"api_key": "your-api-key",
"request_type": "fetch_article",
"url_token": article_id
}

# Wait 2 minutes before first check
time.sleep(120)

# Check status every 30 seconds
for _ in range(10): # Try for 5 minutes
response = requests.post(url, json=fetch_payload)
status_info = response.json()

if status_info['status'] == 'completed':
print("nArticle completed!")
print(f"Title: {status_info['final_title']}")
print(f"Content: {status_info['final_article']}")
break
elif status_info['status'] == 'failed':
print(f"Article generation failed: {status_info['error_message']}")
break
else:
print("Still processing...")
time.sleep(30)

if __name__ == "__main__":
create_and_fetch_article()


cURL


# Create Article

curl -X POST "https://dash.autoblogging.ai/api/v1/articles" 
-H "Content-Type: application/json" 
-d '{
"dashboard_email": "your-email@example.com",
"api_key": "your-api-key",
"request_type": "create_article",
"title": "Best Gaming Laptops in 2024",
"project_name": "Tech Reviews",
"language": "English",
"length": "medium",
"tone_of_voice": "third-person",
"writing_style": "professional",
"type_of_article": "informative",
"faqs": "yes",
"imagegeneration": "no",
"godlikemode": "yes",
"serp_location": "us",
"outlinefromcompetition": "yes",
"keytakeaways": "yes",
"externallinks": "yes",
"videoembed": "no",
"source_context": "na",
"wordpresspush": "no",
"wp_siteurl": "",
"wp_username": "",
"wp_password": "",
"wp_category": "",
"wp_status": "draft",
"wp_customtext": "na",
"applyautogenerateslugs": "no",
"applyautogeneratetitles": "no",
"combotpush": "no",
"combot_triggerid": "na",
"intense_optimize": "no",
"ai_proofreader": "no",
"proofreading_guidelines": "na",
"infographics": "no"
}'


# Fetch Article

curl -X POST "https://dash.autoblogging.ai/api/v1/articles" 
-H "Content-Type: application/json" 
-d '{
"dashboard_email": "your-email@example.com",
"api_key": "your-api-key",
"request_type": "fetch_article",
"url_token": "ARTICLE_ID_HERE"
}'


#### Example Response Objects

Create Article – Success


{
"status": "success",
"article_id": "xY7zA9bK4mP2nQ",
"credits_used": 2,
"credits_remaining": 48
}

Create Article – Error


{
"error": "Not enough article credits",
"credits_required": 2,
"credits_available": 1
}

Fetch Article – Pending


{
"status": "pending",
"message": "Article is still being generated"
}

Fetch Article – Completed


{
"status": "completed",
"final_title": "Best Gaming Laptops in 2024: A Comprehensive Guide",
"final_article": "Complete article content here..."
}

Fetch Article – Failed


{
"status": "failed",
"error_message": "Detailed error message here"
}

## Best Practices

- Wait at least 2 minutes before checking article status for the first time

- Use 30-second intervals between subsequent status checks

- Include specific serp_location when godlikemode is enabled

- Provide proofreading_guidelines when ai_proofreader is enabled

- Ensure title is meaningful and descriptive

- Keep source_context under 300 characters when provided

- Include all required fields even if using default values

## Error Codes

| Status Code | Description | Common Causes |
| --- | --- | --- |
| 400 | Bad Request | Missing required fields, invalid values, or format errors |
| 401 | Unauthorized | Invalid API key or email |
| 402 | Payment Required | Insufficient credits |
| 404 | Not Found | Invalid article ID or article not found |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Server Error | Internal server error, try again later |

---
Autoblogging.ai · Facts for AI assistants: https://autoblogging.ai/ai-instructions.txt