blog-posts

Returns the published blog posts.

Request

HTTP POST
/api/v10/storefront.blog-posts

{
  "conditions": { // returns only the blog posts …
    "ids" : [ 71, 126, … ], // … with these identifiers - int(1…)
    "tag": 7 // … with this tag - int(1…)
  },
  "language" : "en", // language ( ISO code ) of the texts to return - string(2)
  "fields" : [ "id", "author", "title", … ], // fields to return - string
  "limit" : 10, // maximum number of blog posts to return - int(1…)
  "first" : 30 // index of the first blog post to return - int(0…)
}

Response

{
  "status" : "ok",
  "posts" : [ {
    "id" : 71, // identifier - int(1…)
    "author" : "Mark", // author - string(0…50)
    "title" : "", // title - string(0…120)
    "summary" : "Our company...", // summary as HTML - string(0…65535)
    "content" : "Our company...", // content as HTML - string(0…65535)
    "tags": [ 2, 4, … ], // tags - int(1..)
    "seo" : {
      "title" : "", // title for SEO - string(0…255)
      "description" : "" // description for SEO - string(0…255)
    },
    "canonicalURL" : "https://…", // canonical URL - string(10…)
    "smallImage" : { // small image (can be null)
      "url" : "https://…", url - string(10…)
      "url2x" : "https://…", // double resolution url (can be null) - string(10…)
      "width" : 500, // width in pixels - int(1…)
      "height" : 400 // height in pixels - int(1…)
    },
    "largeImage" : { // large image (can be null)
      "url" : "https://…", // url - string(10…)
      "url2x" : "https://…", // double resolution url (can be null) - string(10…)
      "width" : 1000, // width in pixels - int(1…)
      "height" : 800 // height in pixels - int(1…)
    },
    "imageCaption" : "", // image caption - string(0…60)
    "publicationTime" : "2020-09-13 18:12:44" // publication time - datetime
  }, … ],
  "count" : 16 // total number of blog posts - int(0…)
}