> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoply.gg/llms.txt
> Use this file to discover all available pages before exploring further.
# Get a blog post
> One post with its text, as Markdown.
Needs the `blog.read` permission (Read Blog).
## OpenAPI
````yaml /api-reference/openapi.json get /stores/{storeId}/blog/posts/{postId}
openapi: 3.1.0
info:
title: Shoply API
version: '1'
description: >-
Everything a store's own server can do with a secret API key: its catalogue,
orders, customers, marketing, finance and the rest of what the dashboard
does. And the Customer API, which a buyer's own device asks with a token of
theirs.
servers:
- url: https://api.shoply.gg/v1
security:
- apiKey: []
tags:
- name: API key
- name: Store
- name: Domain
- name: Payment methods
- name: Analytics
- name: Storefronts
- name: Storefront code
- name: Payment Routing
- name: Custom payment methods
- name: Products
- name: Product pictures
- name: Stock
- name: Categories
- name: Upsells
- name: Subscriptions
- name: Orders
- name: Invoices
- name: Reviews
- name: Coupons
- name: Coupon categories
- name: Coupon pop-up
- name: Sales
- name: Blog
- name: Search settings
- name: Redirects
- name: Sitemap
- name: Cart Recovery
- name: Email Marketing
- name: Email Templates
- name: Customers
- name: Affiliates
- name: Support Tickets
- name: Blacklist
- name: Fraud protection
- name: Disputes
- name: Finance
- name: Tax
- name: Expenses
- name: Expense setup
- name: API requests
- name: Webhook endpoints
- name: Webhook deliveries
- name: Customer API
paths:
/stores/{storeId}/blog/posts/{postId}:
get:
tags:
- Blog
summary: Get a blog post
description: |-
One post with its text, as Markdown.
Needs the `blog.read` permission (Read Blog).
operationId: blogPosts.show
parameters:
- name: storeId
in: path
required: true
description: >-
The store's ID. A key reaches the store it was made in: `GET /key`
answers which.
schema:
type: string
- name: postId
in: path
required: true
description: The post.
schema:
type: string
responses:
'200':
description: It worked.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
message:
nullable: true
code:
nullable: true
data:
type: object
properties:
id:
type: string
categoryId:
type: string
title:
type: string
slug:
type: string
path:
type: string
status:
type: string
coverUrl:
nullable: true
views:
type: integer
publishedAt:
type: string
updatedAt:
type: string
body:
type: string
coverAlt:
type: string
seoTitle:
type: string
seoDescription:
type: string
url:
type: string
search:
type: object
properties:
title:
type: string
description:
type: string
html:
type: string
checks:
type: array
items:
type: object
properties:
ok:
type: boolean
text:
type: string
meta:
type: object
properties:
limits:
type: object
properties:
categories:
type: integer
postsPerCategory:
type: integer
images:
type: integer
body:
type: integer
title:
type: integer
seoTitle:
type: integer
seoDescription:
type: integer
example:
success: true
message: null
code: null
data:
id: 57d066e1-e807-42dc-8d81-b0ff59fa7eb3
categoryId: c3b25928-c119-4d41-8df1-0525a3a69be5
title: Activating Northwind Pro
slug: activating-northwind-pro
path: /blog/guides/activating-northwind-pro/
status: published
coverUrl: null
views: 0
publishedAt: '2026-10-22 16:20:18'
updatedAt: '2026-10-22 16:20:18.858'
body: |-
## Before you start
Have your licence key to hand.
1. Open **Help**.
2. Choose **Activate**.
3. Paste the key.
coverAlt: ''
seoTitle: ''
seoDescription: ''
url: >-
https://northwind.myshoply.gg/blog/guides/activating-northwind-pro/
search:
title: Activating Northwind Pro - Northwind Keys
description: >-
Have your licence key to hand. Open Help. Choose Activate.
Paste the key.
html: >-
Before you start
Have your licence key to hand.
- Open Help.
- Choose
Activate.
- Paste the
key.
checks:
- ok: true
text: 'The search title fits: 41 of 60 characters'
- ok: false
text: >-
No description. Search engines will use the first
lines
meta:
limits:
categories: 20
postsPerCategory: 15
images: 20
body: 100000
title: 140
seoTitle: 70
seoDescription: 200
'401':
$ref: '#/components/responses/NoKey'
'403':
$ref: '#/components/responses/NotAllowed'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/TooMany'
x-codeSamples:
- lang: javascript
label: Node.js
source: |
import Shoply from "@shoplygg/node";
const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });
const result = await shoply.blogPosts.show("POST_ID");
- lang: php
label: PHP
source: |
getenv('SHOPLY_API_KEY')]);
$result = $shoply->blogPosts->show('POST_ID');
- lang: python
label: Python
source: |
import shoply
client = shoply.Client() # reads SHOPLY_API_KEY
result = client.blogPosts.show("POST_ID")
components:
responses:
NoKey:
description: >-
No API key was sent, or the one sent is not a live key:
`api_key_required`, `invalid_api_key`.
content:
application/json:
schema:
$ref: '#/components/schemas/Refusal'
NotAllowed:
description: >-
The key is real and may not do this: `missing_scope` (with
`requiredScope`), `ip_not_allowed`, `account_unavailable`, or
`dashboard_only` for something only a person in the dashboard may do.
content:
application/json:
schema:
$ref: '#/components/schemas/Refusal'
NotFound:
description: >-
There is no such thing in this store: `not_found`. A store that is not
the key's own is answered the same way.
content:
application/json:
schema:
$ref: '#/components/schemas/Refusal'
TooMany:
description: >-
The key has used up its budget for now: `rate_limited`. `Retry-After`
says how many seconds to wait.
content:
application/json:
schema:
$ref: '#/components/schemas/Refusal'
schemas:
Refusal:
type: object
properties:
success:
type: boolean
example: false
message:
type: string
description: What is wrong, in words for a person.
code:
type: string
description: What is wrong, as a word that does not change.
data:
nullable: true
errors:
type: object
description: >-
For `validation_failed`: what is wrong with each field, by the
field's name.
additionalProperties:
type: string
required:
- success
- message
- code
securitySchemes:
apiKey:
type: http
scheme: bearer
description: >-
A secret API key, made under Developers in the dashboard:
`Authorization: Bearer shoply_sk_...`
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.