Skip to main content
GET
List blog posts
Returns the store’s blog posts newest first with the author populated, excluding soft-deleted posts and with optional filtering by published state. The store is bound to your app token server-side — never send a shop id.

Authorizations

Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.

Query Parameters

page
integer
default:1

1-based page number.

Required range: x >= 1
limit
integer
default:10

Items per page. Defaults to 10, capped at 100.

Required range: 1 <= x <= 100
published
boolean

Filter by published state. Pass true for published posts or false for drafts. Omit to return all.

Response

Paginated list of blog posts.

Standard Salesive response envelope. The operation-specific payload is carried in data.

status
integer
required

HTTP status code, echoed in the body.

success
boolean
required

Whether the request succeeded.

message
string
required

Human-readable result message.

data
object

Flat pagination metadata returned alongside the items array on list responses.