Posts

  • A posts resource contains the HTML content and metadata of a blog post.

  • The resource representation includes details such as post ID, blog information, publication and update times, URL, title, content, author details, comment information, labels, location data, and status.

  • Several methods are available for working with posts, including retrieving lists of posts, getting individual posts, searching, inserting, deleting, updating, publishing, and reverting posts.

A posts resource contain the HTML content of a blog post, along with post metadata. 

For a list of methods for this resource, see the end of this page.

Resource representations

{
  "kind": "blogger#post",
  "id": string,
  "blog": {
    "id": string
  },
  "published": datetime,
  "updated": datetime,
  "url": string,
  "selfLink": string,
  "title": string,
  "titleLink": string,
  "content": string,
  "images": [
    {
      "url": string
    }
  ],
  "author": {
    "id": string,
    "displayName": string,
    "url": string,
    "image": {
      "url": string
    }
  },
  "replies": {
    "totalItems": long,
    "selfLink": string,
    "items": [
      comments Resource
    ]
  },
  "labels": [
    string
  ],
  "location": {
    "name": string,
    "lat": double,
    "lng": double,
    "span": string
  },
  "status": string
}
Property name Value Description Notes
kind string The kind of this entity. Always blogger#post.
id string The ID of this post.
blog object Data about the blog containing this post.
blog.id string The ID of the blog that contains this post.
published datetime RFC 3339 date-time when this post was published.
updated datetime RFC 3339 date-time when this post was last updated.
url string The URL where this post is displayed.
title string The title of the post.
content string The content of the post. Can contain HTML markup.
author object The author of this post.
author.id string The ID of the post creator.
author.displayName string The post creator's display name.
author.url string The URL of the post creator's profile page.
author.image object The post creator's avatar.
author.image.url string The post creator's avatar URL.
replies object The container for this post's comments.
replies.totalItems long The total number of comments on this post.
labels[] list The list of labels this post was tagged with.
replies.items[] list The list of comments for this post.
location object The location, if this post is geotagged.
location.name string Location name.
location.lat double Location's latitude.
location.lng double Location's longitude.
location.span string Location's viewport span. Can be used when rendering a map preview.
images[] list Display image for the Post.
images[].url string
status string Status of the post. Only set for admin-level requests

Methods

You can retrieve the list of posts for a blog using the list method, and retrieve an individual post using the get method.  

list
Retrieves a list of posts.
get
Retrieves one post by post ID.
search
Searches for a post that matches the given query terms.
insert
Adds a post.
delete
Deletes a post by ID.
getByPath
Retrieves a post by path.
patch
Updates a post. This method supports patch semantics.
update
Updates a post.
publish
Publish a draft post.
revert
Revert a published or scheduled post to draft state, which removes the post from the publicly viewable content.