Posts: list

  • Support for the v2.0 JSON API will be discontinued on September 30th, 2024, requiring updates to applications using this API version.

  • This method retrieves a list of posts for a given blog ID.

  • Authentication is required for private blogs but not for public blogs.

  • The request uses an HTTP GET method and includes required and optional parameters for filtering and paginating posts.

  • A successful response returns a JSON object containing the list of posts and pagination tokens.

Important: We will discontinue support for the v2.0 JSON API on September 30th, 2024. To ensure continued functionality, update your applications that rely on the v2.0 JSON API to the latest API version. For the latest version, use the links in the left-side navbar.

Retrieves a list of posts. Try it now.

Authentication is required if the posts are on a blog that is private. If the posts are on a blog that is public, then this method can be called without authentication.

Request

HTTP Request

GET https://www.googleapis.com/blogger/v2/blogs/blogId/posts

Parameters

Parameter Name Value Description
Required Parameters
blogId string ID of the blog to fetch posts from.
Optional Parameters
fetchBodies boolean Whether the body content of posts is included.
maxResults unsigned integer Maximum number of posts to fetch.
pageToken string Continuation token if the request is paged.
startDate datetime Earliest post date to fetch, a date-time with RFC 3339 formatting.

Request Body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "prevPageToken": string,
  "items": [
    posts Resource
  ]
}
Property Name Value Description Notes
kind string The kind of this entity. Always blogger#postList.
nextPageToken string Pagination token to fetch the next page, if one exists.
prevPageToken string Pagination token to fetch the previous page, if one exists.
items[] list The list of posts for this blog.

Try It!

Use the explorer below to call this method on live data and see the response.