Crevior API

API Documentation

Use the Crevior API to create article generation tasks and retrieve generated article results from your own backend system.

The API is designed for backend-to-backend integration. Do not expose your API key in frontend code, browser JavaScript, mobile apps, or public repositories.

Base URL

https://crevior.com

Authentication

All API requests require an API key. You can find your private API key in your dashboard after logging in.

X-API-Key: YOUR_API_KEY

Keep your API key private. If your key is exposed, regenerate it immediately from your dashboard.

Rate Limits

Rate limits help keep the platform stable for all users. Limits may vary by plan and may be adjusted for abuse prevention.

Plan	API Limit	Notes
Starter	5 requests/min	Suitable for light usage.
Professional	10 requests/min	Suitable for regular content workflows.
Business	20 requests/min	Suitable for higher-volume teams.
Enterprise	Custom	Custom usage limits may be arranged.

1. Create Article Generation Task

This endpoint creates a new article generation task. The API returns a task number immediately. Article generation runs asynchronously.

Endpoint

POST https://crevior.com/api/articles/generate

Headers

Content-Type: application/json
X-API-Key: YOUR_API_KEY

Request Body

{
  "keyword": "best AI article generator",
  "language": "English",
  "targetMarket": "United States",
  "wordRange": "1000-2000",
  "tone": "Professional/Formal",
  "readability": "Knowledgeable",
  "pointOfView": "Second person",
  "generateFaq": true
}

Parameter	Type	Required	Description
keyword	string	Yes	Main topic or SEO keyword.
language	string	Yes	Writing language. Example: English, Spanish, German, Japanese.
targetMarket	string	No	Target country or market. Example: United States.
wordRange	string	Yes	Allowed values: 800-1000, 1000-2000, 2000-3000.
tone	string	No	Writing tone.
readability	string	No	Reading level. Example: General, Knowledgeable, Expert.
pointOfView	string	No	Narrative perspective.
generateFaq	boolean	No	Whether to include FAQ content.

Success Response

{
  "success": true,
  "task_no": "AT20260610121200123",
  "status": "Pending",
  "estimated_words": 2000
}

2. Query Article Task Result

Use this endpoint to check task status. When the status is Completed, the response includes the generated article.

Endpoint

GET https://crevior.com/api/articles/tasks/{taskNo}

Headers

X-API-Key: YOUR_API_KEY

Processing Response

{
  "success": true,
  "task": {
    "task_no": "AT20260610121200123",
    "keyword": "best AI article generator",
    "language": "English",
    "word_range": "1000-2000",
    "status": "Processing",
    "article_id": null,
    "used_words": 0,
    "error_message": null
  },
  "article": null
}

Completed Response

{
  "success": true,
  "task": {
    "task_no": "AT20260610121200123",
    "status": "Completed",
    "article_id": 123,
    "used_words": 1580
  },
  "article": {
    "id": 123,
    "title": "Best AI Article Generator for SEO Teams",
    "keyword": "best AI article generator",
    "language": "English",
    "metaTitle": "Best AI Article Generator for SEO Teams",
    "metaDescription": "Discover how to choose the best AI article generator for SEO content workflows.",
    "content": "<h1>Best AI Article Generator...</h1>",
    "usedWords": 1580,
    "createdAt": "2026-06-10T12:30:00"
  }
}

Task Status Values

Status	Meaning
Pending	Task has been created and is waiting to be processed.
Processing	Crevior is generating the article.
Completed	Article has been generated successfully.
Failed	Task failed. Check the error_message field.

Error Responses

Crevior uses standard HTTP status codes and returns JSON error messages.

400 Bad Request

{
  "success": false,
  "message": "Keyword is required"
}

401 Unauthorized

{
  "success": false,
  "message": "Invalid API key"
}

402 Payment Required

{
  "success": false,
  "message": "Insufficient word balance"
}

429 Too Many Requests

{
  "success": false,
  "message": "Rate limit exceeded"
}

500 Internal Server Error

{
  "success": false,
  "message": "The article generation service is temporarily unavailable"
}

Support

Need help with API integration? Contact us at [email protected] .