Public API

Version

Current version: v1

The v1 schema is stable for straightforward website integrations, catalogue indexing, and automation flows such as the weekly podcast sponsor selection.

Endpoints

• /api/v1/books.json - returns the full public ebook catalogue as a JSON array.
• /api/v1/featured-book.json - returns the single featured book for the current UTC ISO week, plus sponsor-ready podcast copy.

Catalogue endpoint

GET /api/v1/books.json

Returns the full public catalogue. This is the source used for browsing, indexing, and deterministic featured-book selection.

Example request

GET /api/v1/books.json HTTP/1.1
Host: jonathan-harris.online
Accept: application/json

Example response

[
  {
    "id": 1,
    "key": "1-ebook",
    "title": "AI and Formula 1: Redefining Speed and Strategy with Intelligent Technology",
    "short": "A plain-English guide to AI in Formula 1, focused on practical use, trade-offs, and sharper questions.",
    "cover": "https://images.jonathan-harris.online/ai-formula-speed-webp",
    "main_image": "https://images.jonathan-harris.online/ai-formula-speed-webp",
    "tags": ["Transportation", "Artificial Intelligence", "AI Trends", "AI in Sports"],
    "filter": "Transportation",
    "keywords": ["Transportation", "AI and Formula 1: Redefining Speed and Strategy with Intelligent Technology", "AI Trends", "Artificial Intelligence", "AI in Sports"],
    "buy_url": "https://mybook.to/Gi93rOF",
    "buy_target_url": "https://mybook.to/Gi93rOF",
    "buy_route": "/ebooks/ai-and-formula-1-redefining-speed-and-strategy-with-intelligent-technology/buy-now",
    "buy_route_full": "https://jonathan-harris.online/ebooks/ai-and-formula-1-redefining-speed-and-strategy-with-intelligent-technology/buy-now",
    "slug": "ai-and-formula-1-redefining-speed-and-strategy-with-intelligent-technology"
  }
]

Featured book endpoint

GET /api/v1/featured-book.json

Returns the current featured book for the week. Selection is deterministic and rotates by UTC ISO week number using the public catalogue order. The selection index is calculated as iso_week % catalogue_length, which keeps the choice stable for the whole week and aligned with the homepage feature block.

What it returns

• version - API version string.
• selection - deterministic rotation metadata for the current week.
• book - the single featured public book record.
• podcast_sponsor - plain-English sponsor copy generated only from existing book metadata.

Example request

GET /api/v1/featured-book.json HTTP/1.1
Host: jonathan-harris.online
Accept: application/json

Example response

{
  "version": "v1",
  "selection": {
    "method": "iso_week_rotation",
    "iso_week": 15,
    "year": 2026
  },
  "book": {
    "id": 16,
    "key": "16-ebook",
    "title": "AI in Agriculture: Revolutionizing Farming for a Sustainable Future",
    "short": "A plain-English guide to AI in Agriculture, focused on practical use, trade-offs, and sharper questions.",
    "cover": "https://images.jonathan-harris.online/ai-agriculture-farming-sustainable-webp",
    "main_image": "https://images.jonathan-harris.online/ai-agriculture-farming-sustainable-webp",
    "filter": "Agriculture",
    "tags": ["Agriculture", "Artificial Intelligence", "AI Trends"],
    "slug": "ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future",
    "pages": 330,
    "canonical_url": "https://jonathan-harris.online/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/",
    "buy_url": "https://mybook.to/PsciMD5",
    "buy_target_url": "https://mybook.to/PsciMD5",
    "buy_route": "/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/buy-now",
    "buy_route_full": "https://jonathan-harris.online/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/buy-now",
    "datePublished": "2024-11-10",
    "dateModified": "2026-03-28T21:48:58Z"
  },
  "podcast_sponsor": {
    "label": "This week's sponsor",
    "headline": "This week's sponsor is AI in Agriculture: Revolutionizing Farming for a Sustainable Future",
    "cta": "See the book at https://jonathan-harris.online/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/ or buy on Amazon at https://jonathan-harris.online/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/buy-now",
    "midroll_15": "This week's sponsor is AI in Agriculture: Revolutionizing Farming for a Sustainable Future. A plain-English guide to AI in Agriculture, focused on practical use, trade-offs, and sharper questions. Read more at https://jonathan-harris.online/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/",
    "midroll_30": "This week's sponsor is AI in Agriculture: Revolutionizing Farming for a Sustainable Future. A plain-English guide to AI in Agriculture, focused on practical use, trade-offs, and sharper questions. It focuses on Agriculture. It runs 330 pages. Topics include Agriculture, Artificial Intelligence, AI Trends. See the full book page at https://jonathan-harris.online/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/ or go straight to Amazon at https://jonathan-harris.online/ebooks/ai-in-agriculture-revolutionizing-farming-for-a-sustainable-future/buy-now."
  }
}

Schema reference for book records

• id - integer identifier for the book record.
• key - internal catalogue key used for site-level mapping.
• title - full public-facing title.
• short - short descriptive summary suitable for cards, previews, and sponsor copy.
• cover - primary cover image URL.
• main_image - main artwork URL used on richer layouts.
• tags - array of topical labels for browsing and related-content logic.
• filter - top-level category used by the site catalogue.
• keywords - array of discovery keywords used for indexing and downstream integrations.
• buy_url and buy_target_url - outbound retailer or branded short-link destination.
• buy_route and buy_route_full - canonical on-site buy-now route in relative and absolute form.
• slug - canonical slug for the detail page at /ebooks/<slug>/.
• datePublished and dateModified - publication and record timestamps exposed for downstream reuse.

Integration notes

• Use /api/v1/books.json when you need the full catalogue for listings, search, or indexing.
• Use /api/v1/featured-book.json when you need one stable weekly pick for a homepage block, newsletter slot, or podcast sponsor insert.
• The podcast_sponsor object is intentionally restrained. It uses existing book metadata only, so there are no invented endorsements, claims, or puffed-up nonsense.
• If future schema changes are needed, add them under a new versioned path rather than reshaping v1 in place.