Skip to main content
GET
/
blogs
List blogs
curl --request GET \
  --url https://store.salesive.com/api/v1/blogs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-shop-id: <api-key>'
{
  "blogs": [
    {
      "id": "<string>",
      "title": "<string>",
      "slug": "<string>",
      "excerpt": "<string>",
      "thumbnail": "<string>",
      "publishedAt": "2023-11-07T05:31:56Z",
      "status": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "content": "<string>",
      "author": {
        "name": "<string>",
        "avatar": "<string>"
      }
    }
  ],
  "total": 1,
  "page": 2,
  "limit": 2
}

​
Request

GET /blogs?page=1&limit=10
x-shop-id: {{shopId}}

​
Headers

HeaderTypeDescription
x-shop-idstringIdentify the shop context.

​
Query parameters

ParameterTypeDescription
pageintegerPage number to return (default: 1).
limitintegerMaximum number of blog posts per page (default: 10).
qstringOptional search string applied to blog titles or content.

​
Successful response

{
    "status": 200,
    "success": true,
    "message": "Blogs found",
    "data": {
        "blogs": [
            {
                "_id": "6a17abd9c12ba5b55a03afa8",
                "title": "The Art of Acquisition",
                "image": "https://cdn.dribbble.com/userupload/43590559/file/original.png",
                "description": "",
                "content": "<p>Full blog post content here...</p>",
                "tags": ["art", "new"],
                "shop": "68b8f52575da81b332af29f1",
                "author": {
                    "_id": "68b8f4aecafb9a1167c25b8e",
                    "name": "Jane Smith",
                    "avatar": "https://cdn.salesive.com/avatars/jane.jpg"
                },
                "published": true,
                "publishedAt": "2026-05-28T02:43:37.081Z",
                "views": 2,
                "createdAt": "2026-05-28T02:43:37.083Z",
                "updatedAt": "2026-06-09T08:49:17.600Z",
                "slug": "the-art-of-acquisition",
                "__v": 0,
                "id": "6a17abd9c12ba5b55a03afa8"
            }
        ],
        "pagination": {
            "total": 2,
            "page": 1,
            "limit": 10,
            "pages": 1,
            "hasNext": false,
            "hasPrev": false,
            "nextPage": null,
            "prevPage": null
        }
    }
}

​
Error response

{
    "status": 500,
    "success": false,
    "message": "Internal server error",
    "data": {}
}

Authorizations

​
Authorization
string
header
required

JWT issued by the Salesive Store API for authenticated shoppers.

​
x-shop-id
string
header
required

Optional storefront identifier sent as a header to scope responses to a specific shop. Try It requests remember this value once provided.

Headers

​
x-shop-id
string

Optional identifier that scopes responses to a specific storefront when the referer cannot be inferred.

Query Parameters

​
page
integer
default:1

Page number to return (defaults to 1).

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

Maximum number of blog posts per page (defaults to 10).

Required range: x >= 1
​
q
string

Optional search phrase applied to blog titles or excerpts.

Response

Paginated blogs response.

​
blogs
object[]
required
​
total
integer
required
Required range: x >= 0
​
page
integer
required
Required range: x >= 1
​
limit
integer
required
Required range: x >= 1