Article Generator

Generate long-form articles from prompts or source data.

Product pagePostman collectionOpenAPI spec

Base URL

https://use.api.co.id

Send a JSON request body with the x-api-co-id header: for example title and keywords to generate an article, or url to rewrite an existing one. The response contains the article as WordPress-ready HTML.

Features

• Generate high-quality, SEO-optimized articles.
• Rewrite existing articles from URLs.
• Generate featured images for articles with AI.
• Customize writing style, tone, and content parameters.
• WordPress-ready HTML output.
• Optional FAQ section.

Pricing

There are two pricing modes.

Pay As You Go (PAYG)

Service	Cost
Article generation	1300 points per article
Article rewrite	1300 points per rewrite
Image generation	300 points per image

• Points are deducted after successful generation.
• Returns 402 Payment Required if your balance is insufficient.

Bring Your Own Key (BYOK)

• Requirements: active premium subscription + configured Gemini/ChatGPT API keys.
• Article generation, article rewrite, and image generation: free (uses your own API keys).
• Configure API keys in the dashboard settings.
• If premium expires or the keys are removed, it falls back to PAYG mode.

Response headers

Header	Description
x-article-mode	Pricing mode used: pay_as_you_go or bring_your_own_key

Article Generation

Generate Article

POST/article-generator/generate

Generate a high-quality, SEO-optimized article based on your parameters. ### Pricing - PAYG mode: 1300 points per article - BYOK mode: FREE (premium users with configured API keys) ### Response Headers - x-article-mode: pay_as_you_go or bring_your_own_key ### Error Responses - 401: User not authenticated - 402: Insufficient points balance (PAYG mode, need 1300 points) - 400: Invalid request body or generation failed

Body (application/json)

Name	Type	Description
titleRequired	string	Article title or topic Example: What is REST API
keywordsRequired	string[]	Array of keywords to optimize for Example: ["REST API","web development","API design"]
allow_related_keywordOptional	boolean	Include related keywords (default false) Example: true
languageRequired	string	Article language Example: Indonesia
writing_styleRequired	string[]	Array of writing styles Example: ["blog-friendly","informative"]
toneRequired	string[]	Array of tones Example: ["friendly","casual"]
search_intentRequired	string[]	Array of search intents Example: ["informational"]
point_of_viewRequired	string[]	Array of perspectives Example: ["neutral"]
creativity_levelRequired	string[]	Array of creativity levels Example: ["balanced"]
audienceRequired	string	Target audience description Example: developers and beginners
additional_promptOptional	string	Additional instructions for article generation Example:
faqOptional	boolean	Add FAQ section at the bottom of the article (default false) Example: false

Response fields

Name	Type	Description
dataOptional	object
data.metaOptional	object
data.meta.titleOptional	string
data.meta.keywordsOptional	string[]
data.meta.main_keywordOptional	string
data.meta.languageOptional	string
data.meta.search_intentOptional	string
data.meta.audienceOptional	string
data.meta.descriptionOptional	string
data.meta.word_countOptional	integer
data.titleOptional	string
data.articleOptional	string	Complete article content in HTML format (WordPress-ready)
errorsOptional	string

Request

curl -X POST "https://use.api.co.id/article-generator/generate" \  -H "x-api-co-id: $API_CO_ID_KEY" \  -H "Content-Type: application/json" \  -d '{"title":"What is REST API","keywords":["REST API","web development","API design"],"allow_related_keyword":true,"language":"Indonesia","writing_style":["blog-friendly","informative"],"tone":["friendly","casual"],"search_intent":["informational"],"point_of_view":["neutral"],"creativity_level":["balanced"],"audience":"developers and beginners","additional_prompt":"","faq":false}'

Response

200OKSuccessful response - Article generated

{  "data": {    "meta": {      "title": "What is REST API",      "keywords": [        "REST API",        "web development"      ],      "main_keyword": "REST API",      "language": "Indonesia",      "search_intent": "informational",      "audience": "developers",      "description": "Pelajari apa itu REST API, arsitektur, dan cara kerjanya dalam pengembangan web modern.",      "word_count": 1200    },    "title": "What is REST API",    "article": "<h2>Pengenalan REST API</h2><p>REST API adalah...</p>"  },  "errors": null}

Article Rewriter

Rewrite Article by URL

POST/article-generator/article-rewriter-by-url

Fetch, validate, and rewrite article content from a URL. Returns rewritten article in the same format as article generator. ### Pricing - PAYG mode: 1300 points per rewrite - BYOK mode: FREE (premium users with configured API keys) ### Response Headers - x-article-mode: pay_as_you_go or bring_your_own_key ### Error Responses - 401: User not authenticated - 402: Insufficient points balance (PAYG mode, need 1300 points) - 400: Invalid request body or rewrite failed - 503: Article rewriter service not available

Body (application/json)

Name	Type	Description
urlRequired	string	URL of the article to rewrite Example: https://example.com/article-to-rewrite
allow_related_keywordOptional	boolean	Include related keywords (default false) Example: true
languageRequired	string	Output article language Example: Indonesia
writing_styleRequired	string[]	Array of writing styles Example: ["blog-friendly","informative"]
toneRequired	string[]	Array of tones Example: ["friendly","casual"]
search_intentRequired	string[]	Array of search intents Example: ["informational"]
point_of_viewRequired	string[]	Array of perspectives Example: ["neutral"]
creativity_levelRequired	string[]	Array of creativity levels Example: ["balanced"]
audienceRequired	string	Target audience description Example: developers and beginners
additional_promptOptional	string	Additional instructions for rewriting Example:
faqOptional	boolean	Add FAQ section at the bottom of the article (default false) Example: false

Response fields

Name	Type	Description
dataOptional	object
data.metaOptional	object
data.meta.titleOptional	string
data.meta.keywordsOptional	string[]
data.meta.main_keywordOptional	string
data.meta.languageOptional	string
data.meta.search_intentOptional	string
data.meta.audienceOptional	string
data.meta.descriptionOptional	string
data.meta.word_countOptional	integer
data.titleOptional	string
data.articleOptional	string	Complete article content in HTML format (WordPress-ready)
errorsOptional	string

Request

curl -X POST "https://use.api.co.id/article-generator/article-rewriter-by-url" \  -H "x-api-co-id: $API_CO_ID_KEY" \  -H "Content-Type: application/json" \  -d '{"url":"https://example.com/article-to-rewrite","allow_related_keyword":true,"language":"Indonesia","writing_style":["blog-friendly","informative"],"tone":["friendly","casual"],"search_intent":["informational"],"point_of_view":["neutral"],"creativity_level":["balanced"],"audience":"developers and beginners","additional_prompt":"","faq":false}'

Response

200OKSuccessful response - Article rewritten

{  "data": {    "meta": {      "title": "Panduan Lengkap REST API",      "keywords": [        "REST API",        "web development"      ],      "main_keyword": "REST API",      "language": "Indonesia",      "search_intent": "informational",      "audience": "developers",      "description": "Panduan lengkap memahami REST API dan implementasinya dalam pengembangan web modern.",      "word_count": 1500    },    "title": "Panduan Lengkap REST API",    "article": "<h2>Apa Itu REST API?</h2><p>REST API adalah...</p>"  },  "errors": null}

Image Generation

Generate Featured Image

POST/article-generator/image-generator

Generate a featured image for an article title using AI. ### Pricing - PAYG mode: 300 points per image - BYOK mode: FREE (premium users with configured API keys) ### Response Headers - x-article-mode: pay_as_you_go or bring_your_own_key ### Error Responses - 401: User not authenticated - 402: Insufficient points balance (PAYG mode, need 300 points) - 400: Invalid request body or generation failed - 503: Image generator service not available

Body (application/json)

Name	Type	Description
article_titleRequired	string	Title of the article to generate a featured image for Example: What is REST API
return_webpOptional	boolean	If true, return base64-encoded WebP image instead of URL (default false) Example: false

Request

curl -X POST "https://use.api.co.id/article-generator/image-generator" \  -H "x-api-co-id: $API_CO_ID_KEY" \  -H "Content-Type: application/json" \  -d '{"article_title":"What is REST API","return_webp":false}'

Response

200OKSuccessful response - Image generated

{  "data": {    "image_url": "https://example.com/generated-image.png"  },  "errors": null}