SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Blogs

Fetch a single published post by slug.

Fetch a single published post by slug.

GEThttps://app.softsolz.uk/api/v1/services/blogs/posts/published/{slug}

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

slugstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Query Params

count_viewboolean

Set to true to count this read as a post view. Off by default, so server renders, cache refreshes and previews do not inflate views. To measure real readers on a site you render yourself, send reader events from the browser instead.

Response

Response Body

slugstringURL-safe post slug.
titlestringPost title.
subtitlestring | nullOptional subtitle.
excerptstring | nullShort excerpt.
cover_image_urlstring | nullCover image URL.
cover_image_altstring | nullCover image alt text.
og_image_urlstring | nullOpen Graph image URL.
seo_titlestring | nullSEO title override.
seo_descriptionstring | nullSEO description override.
categorystring | nullCategory label.
tagsarray of stringsTags.
authorstring | nullDisplay author/byline name.
author_image_urlstring | nullByline avatar image URL.
reading_time_minutesintegerEstimated reading time.
featuredbooleanWhether the post is featured.
no_indexbooleanExcluded from search engines.
comments_enabledbooleanWhether comments are open on this post.
show_tocbooleanWhether a table of contents is shown on this post.
show_sharebooleanWhether reader share buttons are shown.
show_datebooleanWhether the publish date is shown.
show_reading_timebooleanWhether the reading time is shown.
published_atstringWhen the post was published.
body_htmlstringPost body as sanitized HTML.
cta_labelstring | nullOptional call-to-action label.
cta_urlstring | nullOptional call-to-action URL.
share_channelsarray of stringsNetworks shown in the reader share bar.
canonical_urlstring | nullPublic URL of the post, when a blog public URL is configured.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/blogs/posts/published/{slug} \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"slug": "launch-announcement",
"title": "Launch announcement",
"subtitle": "your-subtitle",
"excerpt": "your-excerpt",
"cover_image_url": "https://example.com",
"cover_image_alt": "your-cover-image-alt",
"og_image_url": "https://example.com",
"seo_title": "your-seo-title",
"seo_description": "your-seo-description",
"category": "Product",
"tags": [
"news"
],
"author": "your-author",
"author_image_url": "https://example.com",
"reading_time_minutes": 4,
"featured": true,
"no_index": true,
"comments_enabled": true,
"show_toc": true,
"show_share": true,
"show_date": true,
"show_reading_time": true,
"published_at": "2026-01-01T09:00:00.000Z",
"body_html": "your-body-html",
"cta_label": "your-cta-label",
"cta_url": "https://example.com",
"share_channels": [
"x",
"linkedin",
"facebook",
"instagram",
"threads",
"reddit",
"teams",
"slack",
"copy"
],
"canonical_url": "https://example.com"
}
}