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 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 |
|
The language for the generated article |
| length | Yes | string |
|
Desired length of the article |
| tone_of_voice | Yes | string |
|
The narrative perspective of the article |
| writing_style | Yes | string |
|
The writing style to be used |
| type_of_article | Yes | string |
|
The type of article to generate |
| faqs | Yes | string |
|
Include FAQ section |
| imagegeneration | Yes | string |
|
Generate images for article (+1 credit) |
| godlikemode | Yes | string |
|
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 |
|
Use competitor analysis for outline |
| keytakeaways | Yes | string |
|
Include key takeaways section |
| externallinks | Yes | string |
|
Include external links |
| videoembed | Yes | string |
|
Include video embeddings |
| source_context | Yes | string | “na” or text (max 300 chars) | Additional context for article generation |
| wordpresspush | Yes | string |
|
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 |
|
Post status in WordPress |
| wp_customtext | No | string | “na” or custom text | Custom text for WordPress |
| applyautogenerateslugs | Yes | string |
|
Auto-generate WordPress slugs |
| applyautogeneratetitles | Yes | string |
|
Auto-generate WordPress titles |
| combotpush | Yes | string |
|
Push to ComBot integration |
| combot_triggerid | Only if combotpush=”yes” | string | “na” or valid trigger ID | ComBot trigger ID |
| intense_optimize | Yes | string |
|
Apply intense optimization |
| ai_proofreader | Yes | string |
|
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 |
|
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": "[email protected]",
"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": "[email protected]",
"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()