Back to Documentation

API Reference

Integrate Ranklite into your application with our REST API. Generate content, manage articles, and automate your SEO workflow programmatically.

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Get your API key from your account settings.

API Endpoints

POST/api/v1/articles/generate

Generate a new SEO-optimized article

GET/api/v1/articles

List all articles in your account

GET/api/v1/articles/{id}

Retrieve a specific article by ID

PATCH/api/v1/articles/{id}

Update an existing article

DELETE/api/v1/articles/{id}

Delete an article

Example Request

Here's a basic example of generating an article using the API.

curl -X POST https://api.ranklite.com/v1/articles/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "best running shoes 2025",
    "tone": "professional",
    "length": 2000,
    "include_images": true
  }'

Response Format

All API responses are returned in JSON format with consistent structure.

{
  "success": true,
  "data": {
    "id": "art_abc123",
    "title": "The Best Running Shoes of 2025",
    "content": "...",
    "status": "published",
    "created_at": "2025-12-14T10:30:00Z"
  }
}

Rate Limits

API requests are rate limited to ensure fair usage. Free accounts are limited to 100 requests per day, Pro accounts get 10,000 requests per day. View detailed rate limit information in the Rate Limits documentation.