Sign in Subscribe
Tophhie Cloud API

Introducing: Tophhie Cloud Blog API 📰

We've exposed the APIs available via our blog hosting provider, Ghost, in the Tophhie Cloud API.

Chris Greenacre

Chris Greenacre

— 2 min read
Introducing: Tophhie Cloud Blog API 📰
An illustration showing a laptop and a webpage with the words "Introducing: Tophhie Cloud Blog API". Courtesy of Sora.
ℹī¸
The Tophhie Cloud API now has publicly available documentation. Head to https://api.tophhie.cloud to check it out.

Starting today (23rd April 2025), the Tophhie Cloud API has been updated to include endpoints specific to the Tophhie Cloud Blog meaning you can query blog post information, and blog specific information from these endpoints. Completely for free!

We're introducing four new endpoints in the Tophhie Cloud API.

  • /blog/info - Get generic information about the Tophhie Cloud Blog.
  • /blog/authors - Fetch a list of authors.
  • /blog/posts - Fetch a list of blog posts.
  • /blog/posts/{id} - Fetch a specific blog post by its ID.

Let's go through each of them.

Blog Information API

This API is available at https://api.tophhie.cloud/blog/info

The Blog Information API does exactly what it says on the tin. It returns generic information about the Tophhie Cloud Blog that might be useful to some people.

Some of the information returned includes:

  • Blog Title
  • Description
  • Logo URL
  • Icon URL
  • Accent Colour
  • Support Email Address
  • Language
  • URL

As of today, the API returns...

{
  "title": "Tophhie Cloud Blog",
  "description": "Thoughts, stories and ideas surrounding technology and the cloud.",
  "logo": "https://blog.tophhie.cloud/content/images/2024/11/tophhie-cloud-high-resolution-logo-white-transparent-icon-colour.png",
  "icon": "https://blog.tophhie.cloud/content/images/size/w256h256/2024/11/tophhiecloud-square-150x150.png",
  "accent_color": "#100235",
  "facebook": "tophhie",
  "twitter": "@chris_greenacre",
  "locale": "en-gb",
  "timezone": "Europe/Dublin",
  "members_support_address": "blog-support@tophhie.cloud",
  "lang": "en-gb",
  "url": "https://blog.tophhie.cloud/"
}

Blog Authors API

This API is accessible at https://api.tophhie.cloud/blog/authors

The Blog Authors API returns a collection of Tophhie Cloud Blog writers. If someone has posted an article on the blog, they'll be returned in this response.

As of today, that's just me 🙂

Some of the information returned in the Author object includes:

  • Name
  • Profile Image URL
  • Cover Image URL
  • Bio
  • Social Media Handles
  • Author URL

Blog Posts API

This API is accessible at https://api.tophhie.cloud/blog/posts and https://api.tophhie.cloud/blog/posts/{id}

The Blog Posts API (depending on which endpoint you use) returns either a collection of blog posts, or a specific blog post by its ID.

Each blog post object includes the following information:

  • ID
  • UUID
  • Title
  • Featured state
  • Visibility
  • Created date
  • Updated date
  • Published date
  • Excerpts
  • URL

As part of the response for the first "/blog/posts" endpoint, you'll be provided with a "next_page" property if there are more results to retrieve. You can also specify how many posts you want to retrieve with the "limit" query.

We'll be starting to use these endpoints in some of our internal automation projects, specifically for notifications, and auditing.

Hopefully, they provide some use to you too!

Until next time 👋

Read more