Posts
Stay organized with collections
Save and categorize content based on your preferences.
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.
Posts contain the HTML content of a blog post.
Methods
You can retrieve the list of Posts for a Blog using the blogger.posts.list method, and retrieve an individual Post using the blogger.posts.get method.
- list
- Retrieves a list of posts.
- get
- Retrieves one post by postId.
Resource Representations
The Posts Resource contains the data and metadata for a post in a blog.
{
"kind": "blogger#post",
"id": long,
"blog": {
"id": long
},
"published": datetime,
"updated": datetime,
"url": string,
"selfLink": string,
"title": string,
"content": string,
"author": {
"id": string,
"displayName": string,
"url": string,
"image": {
"url": string
}
},
"replies": {
"totalItems": long,
"selfLink": string
},
"labels": [
string
]
}
Property Name |
Value |
Description |
Notes |
kind |
string |
The kind of this entity. Always blogger#post . |
|
id |
long |
The identifier of this post. |
|
blog |
object |
Data about the blog containing this post. |
|
blog.id |
long |
The identifier 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 API REST URL to fetch this resource from. |
|
title |
string |
The title of the post. |
|
content |
string |
The content of the post. May contain HTML markup. |
|
author |
object |
The author of this post. |
|
author.id |
string |
The identifier 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 URL of the comments on this post. |
|
labels[] |
list |
The list of labels this post was tagged with. |
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-26 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-06-26 UTC."],[[["\u003cp\u003eSupport for the v2.0 JSON API will be discontinued on September 30, 2024, requiring applications to update to the latest API version.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows retrieval of blog posts using the \u003ccode\u003eblogger.posts.list\u003c/code\u003e and \u003ccode\u003eblogger.posts.get\u003c/code\u003e methods, enabling access to post data.\u003c/p\u003e\n"],["\u003cp\u003ePosts contain HTML content and metadata such as title, author information, publication date, and associated labels.\u003c/p\u003e\n"],["\u003cp\u003eThe "Posts Resource" provides a structured representation of a blog post, including details like ID, content, author, and comments.\u003c/p\u003e\n"]]],[],null,["# Posts\n\n**Important**:\nWe will discontinue support for the v2.0 JSON API on September 30th, 2024.\nTo ensure continued functionality, update your applications that rely on the v2.0 JSON API\nto the latest API version. For the latest version, use the links in the left-side navbar.\nPosts contain the HTML content of a blog post.\n\nMethods\n-------\n\nYou can retrieve the list of Posts for a Blog using the [blogger.posts.list](/blogger/docs/2.0/json/reference/posts/list) method, and retrieve an individual Post using the [blogger.posts.get](/blogger/docs/2.0/json/reference/posts/get) method.\n\n[list](/blogger/docs/2.0/json/reference/posts/list)\n: Retrieves a list of posts.\n\n[get](/blogger/docs/2.0/json/reference/posts/get)\n: Retrieves one post by postId.\n\nResource Representations\n------------------------\n\nThe Posts Resource contains the data and metadata for a post in a blog.\n\n```text\n{\n \"kind\": \"blogger#post\",\n \"id\": long,\n \"blog\": {\n \"id\": long\n },\n \"published\": datetime,\n \"updated\": datetime,\n \"url\": string,\n \"selfLink\": string,\n \"title\": string,\n \"content\": string,\n \"author\": {\n \"id\": string,\n \"displayName\": string,\n \"url\": string,\n \"image\": {\n \"url\": string\n }\n },\n \"replies\": {\n \"totalItems\": long,\n \"selfLink\": string\n },\n \"labels\": [\n string\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|----------------------|------------|-----------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#post`. | |\n| `id` | `long` | The identifier of this post. | |\n| `blog` | `object` | Data about the blog containing this post. | |\n| blog.`id` | `long` | The identifier of the blog that contains this post. | |\n| `published` | `datetime` | RFC 3339 date-time when this post was published. | |\n| `updated` | `datetime` | RFC 3339 date-time when this post was last updated. | |\n| `url` | `string` | The URL where this post is displayed. | |\n| `selfLink` | `string` | The API REST URL to fetch this resource from. | |\n| `title` | `string` | The title of the post. | |\n| `content` | `string` | The content of the post. May contain HTML markup. | |\n| `author` | `object` | The author of this post. | |\n| author.`id` | `string` | The identifier of the post creator. | |\n| author.`displayName` | `string` | The post creator's display name. | |\n| author.`url` | `string` | The URL of the post creator's Profile page. | |\n| author.`image` | `object` | The post creator's avatar. | |\n| author.image.`url` | `string` | The post creator's avatar URL. | |\n| `replies` | `object` | The container for this post's comments. | |\n| replies.`totalItems` | `long` | The total number of comments on this post. | |\n| replies.`selfLink` | `string` | The URL of the comments on this post. | |\n| `labels[]` | `list` | The list of labels this post was tagged with. | |"]]