FiveMinRead Agent API

Quick Reference

Authentication

Pass your API key in every request header:

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

Permissions: can_read for GET · can_write for POST/PATCH/PUT · can_delete for DELETE.

Full Article POST Example

curl -X POST https://fiveminread.com/api/v1/admin/articles/ \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "The Power of Deep Work",
  "content": "<h2>The Core Idea</h2>\n<p>Cal Newport argues that <strong>deep work</strong> — focused, distraction-free concentration — is the superpower of the 21st century.</p>\n<h2>Why It Matters</h2>\n<p>Most knowledge workers spend their days on shallow tasks: email, meetings, social media. Newport shows how cultivating depth separates top performers.</p>",
  "excerpt": "<p>Why the ability to focus deeply is becoming rare and more valuable than ever.</p>",
  "status": "published",
  "meta_title": "The Power of Deep Work - FiveMinRead",
  "meta_description": "How focused, distraction-free work creates extraordinary results in the knowledge economy.",
  "image_prompt": "A lone person working at a minimalist desk by a rain-streaked window, soft lamp light, editorial photography, muted warm tones, shallow depth of field",
  "translations": {
    "vi": {
      "title": "Sức Mạnh Của Công Việc Sâu",
      "content": "<h2>Ý Tưởng Cốt Lõi</h2><p>Cal Newport lập luận rằng <strong>công việc sâu</strong> là siêu năng lực của thế kỷ 21.</p>",
      "excerpt": "<p>Tại sao khả năng tập trung sâu ngày càng trở nên khan hiếm và có giá trị hơn.</p>",
      "meta_title": "Sức Mạnh Của Công Việc Sâu - FiveMinRead",
      "meta_description": "Cách tập trung sâu tạo ra kết quả phi thường trong nền kinh tế tri thức."
    }
  }
}'

Full Book POST Example

POST /api/v1/admin/books/
X-API-Key: your_api_key_here

{
  "title": "Atomic Habits",
  "author_name": "James Clear",
  "author_bio": "James Clear is an author and speaker focused on habits, decision-making, and continuous improvement.",
  "big_idea": "Tiny changes in behavior compound over time into remarkable results — the 1% improvements that most people overlook.",
  "quick_summary": "James Clear argues that habits are the compound interest of self-improvement. Small, consistent changes to your systems — not your goals — are what lead to lasting transformation.",
  "summary_content": "<h2>Part 1: The Fundamentals</h2>\n<p>Clear introduces the <strong>Four Laws of Behavior Change</strong>: make it obvious, attractive, easy, and satisfying.</p>\n<h2>Part 2: The 1st Law — Make It Obvious</h2>\n<p>Design your environment so good habits are the path of least resistance.</p>",
  "key_insights": [
    {
      "title": "The 1% Rule",
      "insight": "Getting 1% better every day compounds to being 37x better after one year.",
      "example": "A cycling coach improved team performance through tiny gains: lighter seats, rubbing alcohol on tires, better sleep pillows — each 1% stacked into Tour de France wins."
    },
    {
      "title": "Identity-Based Habits",
      "insight": "Change your identity first — every action becomes a vote for the person you wish to become.",
      "example": "Instead of 'I want to quit smoking', say 'I'm not a smoker'. The identity shift changes behavior automatically."
    }
  ],
  "actionable_takeaways": [
    "Use habit stacking: 'After I [CURRENT HABIT], I will [NEW HABIT]'",
    "Design your environment — put your book on the pillow, not the nightstand",
    "Never miss twice — one slip is an accident, two is a new (bad) habit",
    "Use the two-minute rule: scale any habit down to two minutes to start"
  ],
  "notable_quotes": [
    "You do not rise to the level of your goals. You fall to the level of your systems.",
    "Every action you take is a vote for the type of person you wish to become.",
    "Habits are the compound interest of self-improvement."
  ],
  "who_should_read": "Anyone who wants to build better habits, break bad ones, or understand the science behind behavior change. Especially useful for entrepreneurs, athletes, and anyone working on long-term goals.",
  "status": "published",
  "difficulty_level": "beginner",
  "page_count": 320,
  "publication_year": 2018,
  "amazon_link": "https://amzn.to/atomichabits",
  "meta_title": "Atomic Habits Summary - Key Takeaways by James Clear",
  "meta_description": "The key insights from Atomic Habits: how tiny 1% improvements compound into remarkable results.",
  "image_prompt": "Abstract minimalist book cover art: a single glowing atom transforming into an unbreakable chain, deep navy blue background, gold and cream accents, clean geometric shapes, premium editorial illustration style, portrait orientation",
  "translations": {
    "vi": {
      "title": "Thói Quen Nguyên Tử",
      "big_idea": "Những thay đổi hành vi nhỏ tích lũy theo thời gian thành kết quả phi thường.",
      "quick_summary": "James Clear lập luận rằng thói quen là lãi kép của việc tự phát triển.",
      "summary_content": "<h2>Phần 1: Cơ Bản</h2><p>Clear giới thiệu <strong>Bốn Quy Luật Thay Đổi Hành Vi</strong>.</p>",
      "who_should_read": "Bất kỳ ai muốn xây dựng thói quen tốt và loại bỏ thói quen xấu.",
      "meta_title": "Tóm Tắt Thói Quen Nguyên Tử - FiveMinRead",
      "meta_description": "Những ý chính từ cuốn Thói Quen Nguyên Tử của James Clear."
    }
  }
}

Article Management Endpoints

Book Management Endpoints

Public & Categories

Response Codes

Site Context

• Site: FiveMinRead — book summary platform. Author: Alex Ng.
• Languages: EN (default), VI /vi/, JA /ja/, ID /id/, FR /fr/
• Slugs: Auto-generated from English title if not provided (lowercase, hyphenated).
• Author on API posts: Defaults to first superuser (Alex Ng).
• Status on create: Defaults to draft unless you send "status": "published".
• Reading time: Calculated automatically from content word count.
• Translations strategy: English first is fine — add translations via PATCH later. Missing languages fall back to English.