Tophhie Cloud API: Another Three Endpoints... 🌐

We're back at it again! Building API endpoints to support our never-ending list of apps and services.

Again, we're focusing on Tophhie Social. The atproto PDS server.

So, let's get into it...

GET - /pds/blobStorageUsageBytes

This API fetches the total storage used on the Tophhie Social blob bucket hosted in Cloudflare's R2 storage service. We use this API to show the total blob storage used on our Tophhie Social Status Page; https://status.tophhie.social.

https://api.tophhie.cloud/pds/blobStorageUsageBytes

As of today (17th Nov 2025), this is what the response looks like.

{
  "usageBytes": "302318389"
}

GET - /pds/blobStorageUsageBytes/{did}

This API serves as an extension to the first one. Except, this endpoint returns the total blob storage used for a specific Tophhie Social atproto account.

https://api.tophhie.cloud/pds/blobStorageUsageBytes/{did}

As of today, this is what the response looks like for my own atproto account.
(did:plc:ggobmtqnjirtchpwgydxoecb).

{
  "usageBytes": "55852214"
}

GET - /pds/uptimeStats

This one serves multiple purposes actually. In line with our aim to be truly transparent within our service, we started publishing monthly uptime reports on the @tophhie.social Bluesky account... When we started building the Tophhie Social Status Page, we wanted to include these metrics on that page also.

The second purpose, transparency again... we wanted people to be able to query this data on-demand for themselves. So, they always have visibility over the uptime metrics and incidents.

Therefore, in came the API...

This API talks to our backend monitoring service (BetterStack Uptime) and pulls the uptime and availability data for the Tophhie Social PDS.

https://api.tophhie.cloud/pds/uptimeStats

By default, this API return the availability for the "all time" period. So, this is just when we initially started monitoring the service.

However, you can specify two query parameters to get statistics between a certain period. Simply provide:

• startDate
• endDate

in the format "yyyy-MM-dd".

For example:

https://api.tophhie.cloud/pds/uptimeStats?startDate=2025-10-01&endDate=2025-10-31

returns...

{
  "availability": 99.0323,
  "total_downtime": 25920,
  "number_of_incidents": 4,
  "longest_incident": 24723,
  "average_incident": 6480
}

Again, niche APIs. But they're there to help improve our services, and provide our users with more transparency over the service they're using 😄

Until next time 👋