Developer Docs

SeleScribe API

Integrate SeleScribe's AI academic writing capabilities into your institution's LMS, research portal, or application.

Getting Started

The SeleScribe API allows you to programmatically access our AI academic writing engine. The API is RESTful and returns JSON responses.

Base URL

https://selescribe.com/api/v1

Authentication

All API requests require authentication using a Bearer token. Contact our team at api@selescribe.com to request API access.

// Include in all requests

Authorization: Bearer <your-api-key>

Content-Type: application/json

Document Generation

Generate academic documents programmatically using our AI engine.

POST /api/v1/documents/generate

{

"documentType": "Research Article",

"topic": "Impact of AI on African Education",

"discipline": "Education",

"citationStyle": "APA 7th Edition",

"wordCount": 5000,

"language": "English"

}

Thesis Tracker

Track thesis progress, manage chapters, and retrieve word count analytics for a scholar's thesis project.

GET /api/v1/thesis/progress

// Returns thesis chapters, word counts, and completion percentage

Authorization: Bearer <your-api-key>

POST /api/v1/thesis/chapter

{

"chapterNumber": 2,

"chapterTitle": "Literature Review",

"targetWordCount": 12000,

"discipline": "Social Sciences"

}

Response

{
  "chapterId": "ch_abc123",
  "status": "generating",
  "estimatedWords": 12000,
  "humanizationScore": 100,
  "aiDetectionScore": 0
}

Journal Submissions

Submit articles to the SeleScribe Academic Journal, track review status, and manage DOI registration.

POST /api/v1/journal/submit

{

"title": "Article Title",

"abstract": "Article abstract...",

"authors": "Author Name",

"discipline": "Social Sciences",

"keywords": ["keyword1", "keyword2"],

"wordCount": 5000

}

GET /api/v1/journal/submissions

// Returns all submissions with status: submitted | under_review | approved | published | rejected

GET /api/v1/journal/submissions/:id/status

// Track individual submission review status and DOI

Rate Limits

PlanRequests/minDocuments/month
Free53
Scholar2030
Scholar Pro60100
EnterpriseUnlimitedUnlimited

Errors

SeleScribe uses standard HTTP status codes. All error responses include a JSON body with an error field.

CodeMeaningResolution
400Bad RequestCheck request body and required fields
401UnauthorizedVerify your API key is valid and included
403ForbiddenYour plan does not support this endpoint
404Not FoundResource does not exist
429Rate LimitedSlow down — you have exceeded your rate limit
500Server ErrorContact api@selescribe.com with your request ID

// Example error response

{
  "error": "Rate limit exceeded",
  "code": 429,
  "message": "You have exceeded 20 requests/minute. Upgrade your plan for higher limits.",
  "requestId": "req_abc123xyz"
}

SDKs

Official SDKs are available for the most popular languages. Community SDKs are also listed below.

JavaScript / TypeScriptOfficial
npm install @selescribe/sdk
PythonOfficial
pip install selescribe
PHPCommunity
composer require selescribe/sdk
RubyCommunity
gem install selescribe

Need an SDK for another language? Contact our developer team or contribute on GitHub.