API Documentation
Base URL
https://dash.autoblogging.ai/api/v1
Authentication
All API requests require authentication using an API key and dashboard email.
Endpoints
1. Create Article
Creates a new article based on the provided parameters.
- URL:
/articles
- Method:
POST
- Content-Type:
application/json
Request Body
Important Note: All fields in the request body must be provided. If a field is not applicable, use the default value specified in the table below.
Field | Type | Description | Default |
---|---|---|---|
dashboard_email | string | The email associated with the dashboard account | N/A (Required) |
api_key | string | The API key for authentication | N/A (Required) |
request_type | string | Must be set to “create_article” | N/A (Required) |
title | string | The main topic or title of the blog post | N/A (Required) |
project_name | string | Name of the project | Empty string |
language | string | The language of the article. Options: 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 | English |
length | string | Article length. Options: short, medium, long | medium |
tone_of_voice | string | Tone of the article. Options: first-person, second-person, third-person | third-person |
writing_style | string | Writing style. Options: premium_writing_style_1, Conversational, Professional, Witty | Professional |
type_of_article | string | Type of article. Options: Informative, listicle, places | Informative |
faqs | string | Whether to include FAQs. Options: yes, no | no |
imagegeneration | string | Whether to generate images. Options: yes, no | no |
godlikemode | string | Whether to use godlike mode. Options: yes, no | no |
serp_location | string | SERP location code (2-letter country code, e.g., “us” for United States) | us |
outlinefromcompetition | string | Whether to use outline from competition. Options: yes, no | no |
keytakeaways | string | Whether to include key takeaways. Options: yes, no | no |
externallinks | string | Whether to include external links. Options: yes, no | no |
videoembed | string | Whether to embed videos. Options: yes, no | no |
source_context | string | Additional context for the article (max 300 characters) | na |
wordpresspush | string | Whether to push to WordPress. Options: yes, no | no |
wp_siteurl | string | WordPress site URL (required if wordpresspush is yes) | Empty string |
wp_username | string | WordPress username (required if wordpresspush is yes) | Empty string |
wp_password | string | WordPress password (required if wordpresspush is yes) | Empty string |
wp_category | string | WordPress category (comma-separated if multiple) | Empty string |
wp_status | string | WordPress post status. Options: publish, draft | draft |
wp_customtext | string | Custom text for WordPress in HTML format | na |
applyautogenerateslugs | string | Whether to auto-generate slugs. Options: yes, no | no |
applyautogeneratetitles | string | Whether to auto-generate titles. Options: yes, no | no |
combotpush | string | Whether to use Combot push. Options: yes, no | no |
combot_triggerid | string | Combot trigger ID | na |
intense_optimize | string | Whether to use intense optimization. Options: yes, no | no |
ai_proofreader | string | Whether to use AI proofreading. Options: yes, no | no |
proofreading_guidelines | string | Guidelines for proofreading (required if ai_proofreader is yes, max 3000 characters) | na |
Response
- Success Response:
- Code: 200
- Content:
{ "status": "success", "article_id": "<url_token>" }
- Error Responses:
- Code: 400
- Content: Various error messages depending on the validation failure
- Code: 401
- Content:
{ "error": "Invalid API key or email" }
- Code: 404
- Content:
{ "error": "User not found" }
Example cURL Request
curl -X POST https://dash.autoblogging.ai/api/v1/articles
-H "Content-Type: application/json"
-d '{
"dashboard_email": "[email protected]",
"api_key": "your_api_key_here",
"request_type": "create_article",
"title": "The Impact of Artificial Intelligence on Modern Business",
"project_name": "AI in Business",
"language": "English",
"length": "medium",
"tone_of_voice": "third-person",
"writing_style": "Professional",
"type_of_article": "Informative",
"faqs": "yes",
"imagegeneration": "yes",
"godlikemode": "no",
"serp_location": "us",
"outlinefromcompetition": "yes",
"keytakeaways": "yes",
"externallinks": "yes",
"videoembed": "no",
"source_context": "Focus on recent AI advancements and their practical applications in various industries",
"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": "yes",
"ai_proofreader": "yes",
"proofreading_guidelines": "Ensure technical terms are accurately used and explained. Check for consistent formatting of company names and AI-related acronyms."
}'
2. Fetch Article
Retrieves a generated article by its URL token.
- URL:
/articles
- Method:
POST
- Content-Type:
application/json
Request Body
Field | Type | Description |
---|---|---|
dashboard_email | string | The email associated with the dashboard account |
api_key | string | The API key for authentication |
request_type | string | Must be set to “fetch_article” |
url_token | string | The unique token of the article to fetch |
Response
- Success Response:
- Code: 200
- Content:
{ "final_title": "Article Title", "final_article": "Full article content..." }
- Error Response:
- Code: 404
- Content:
{ "error": "Article not found or not yet generated" }
Example cURL Request
curl -X POST https://dash.autoblogging.ai/api/v1/articles
-H "Content-Type: application/json"
-d '{
"dashboard_email": "[email protected]",
"api_key": "your_api_key_here",
"request_type": "fetch_article",
"url_token": "abcdefghijklmn"
}'
Notes
- Ensure all required fields are provided in the request body. If a field is not applicable, use the default value specified in the table.
- The API uses credits for article creation. Make sure you have sufficient credits before making requests.
- Some fields like
godlikemode
,intense_optimize
, andai_proofreader
may consume additional credits. - WordPress integration is optional. If you don’t want to use it