Public API Documentation

Integrate your articles into your own systems. Easy access with REST API.

Quick Start

Create Account

Get API Token

Create a new token from Settings > Public API tab.

Integrate

Send requests to the API with your token and fetch your articles.

Authentication

All API requests require authentication using a Bearer token.

Base URL

https://fatbotter.com/api/v1/public

Authorization Header

Authorization: Bearer YOUR_API_TOKEN

Token Security

Never share your API token. Each token is valid for 6 months and only provides access to your own articles.

Rate Limiting

100

Requests / Minute

Minute

Month Token Validity

Response Headers:

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 99

API Endpoints

GET/articles

Lists all your articles with pagination.

Query Parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
per_page	integer	Items per page (max: 100, default: 10)
status	string	draft, published, archived, pending
language	string	tr, en, de, fr...
sort	string	created_at, updated_at, title, word_count
order	string	asc, desc
search	string	Search in title and content

GET/articles/{id}

Returns the article with the specified ID with all details. Images included.

GET/articles/{id}/images

Lists all images belonging to the article.

Response Format

Example Response (JSON)

{
  "success": true,
  "data": {
    "id": 123,
    "title": "Makale Başlığı",
    "slug": "makale-basligi",
    "content": "<p>HTML içerik...</p>",
    "excerpt": "Kısa özet...",
    "featured_image": "https://fatbotter.com/storage/...",
    "images": [
      {
        "id": 1,
        "url": "https://fatbotter.com/storage/...",
        "alt_text": "Görsel açıklaması",
        "is_featured": true
      }
    ],
    "meta": {
      "description": "Meta açıklama",
      "keywords": ["anahtar", "kelimeler"]
    },
    "word_count": 1500,
    "language": "tr",
    "status": "published",
    "published_at": "2026-01-01T12:00:00Z"
  },
  "meta": {
    "current_page": 1,
    "last_page": 10,
    "per_page": 10,
    "total": 100
  }
}

Code Examples

cURL

curl -X GET "https://fatbotter.com/api/v1/public/articles" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

JavaScript (Fetch API)

const API_TOKEN = 'YOUR_API_TOKEN';

const response = await fetch(
  'https://fatbotter.com/api/v1/public/articles',
  {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`,
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();
console.log(data);

PHP (cURL)

<?php

$apiToken = 'YOUR_API_TOKEN';

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://fatbotter.com/api/v1/public/articles',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiToken,
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

Python (requests)

import requests

API_TOKEN = 'YOUR_API_TOKEN'

headers = {
    'Authorization': f'Bearer {API_TOKEN}',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://fatbotter.com/api/v1/public/articles',
    headers=headers
)

data = response.json()
print(data)

Node.js (axios)

const axios = require('axios');

const API_TOKEN = 'YOUR_API_TOKEN';

async function getArticles() {
  try {
    const response = await axios.get(
      'https://fatbotter.com/api/v1/public/articles',
      {
        headers: {
          'Authorization': `Bearer ${API_TOKEN}`
        }
      }
    );

    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

getArticles();

Error Codes

HTTP Code	Description
`401`	Invalid or missing API token. Check your token.
`404`	Article not found or doesn't belong to you.
`429`	Rate limit exceeded. Please wait a minute.
`500`	Server error. Please try again later.

Start Using the API

Create an API token from the panel and integrate your articles into your own systems.

Create Token