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
`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.
`selfLink`	`string`	The Blogger API URL to fetch this resource from.
`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.
`replies.selfLink`	`string`	The Blogger API URL of to retrieve the comments for 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.
`titleLink`	`string`	The title link URL, similar to atom's related link.
`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.

Posts Stay organized with collections Save and categorize content based on your preferences.

Resource representations

Methods

Posts