Posts
Stay organized with collections
Save and categorize content based on your preferences.
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
}
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.
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 2025-05-15 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 2025-05-15 UTC."],[[["\u003cp\u003eA posts resource stores a blog post's HTML content and metadata, such as title, author, and publication date.\u003c/p\u003e\n"],["\u003cp\u003eThe resource representation includes details like post ID, blog ID, content, author information, comments, labels, and location.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage posts using various methods: list to retrieve multiple posts, get to retrieve a specific post by ID, and others for searching, inserting, deleting, updating, and publishing.\u003c/p\u003e\n"],["\u003cp\u003ePosts can include custom metadata and images, along with details about the post's location if it is geotagged.\u003c/p\u003e\n"]]],[],null,["# Posts\n\nA posts resource contain the HTML content of a blog post, along with post metadata.\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```objective-c\n{\n \"kind\": \"blogger#post\",\n \"id\": string,\n \"blog\": {\n \"id\": string\n },\n \"published\": datetime,\n \"updated\": datetime,\n \"url\": string,\n \"selfLink\": string,\n \"title\": string,\n \"titleLink\": string,\n \"content\": string,\n \"images\": [\n {\n \"url\": string\n }\n ],\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 \"items\": [\n comments Resource\n ]\n },\n \"labels\": [\n string\n ],\n \"location\": {\n \"name\": string,\n \"lat\": double,\n \"lng\": double,\n \"span\": string\n },\n \"status\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------------|------------|----------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#post`. | |\n| `id` | `string` | The ID of this post. | |\n| `blog` | `object` | Data about the blog containing this post. | |\n| blog.`id` | `string` | The ID of the blog that contains this post. | |\n| `published` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this post was published. | |\n| `updated` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this post was last updated. | |\n| `url` | `string` | The URL where this post is displayed. | |\n| `selfLink` | `string` | The Blogger API URL to fetch this resource from. | |\n| `title` | `string` | The title of the post. | |\n| `content` | `string` | The content of the post. Can contain HTML markup. | |\n| `author` | `object` | The author of this post. | |\n| author.`id` | `string` | The ID 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 Blogger API URL of to retrieve the comments for this post. | |\n| `labels[]` | `list` | The list of labels this post was tagged with. | |\n| replies.`items[]` | `list` | The list of comments for this post. | |\n| `location` | `object` | The location, if this post is geotagged. | |\n| location.`name` | `string` | Location name. | |\n| location.`lat` | `double` | Location's latitude. | |\n| location.`lng` | `double` | Location's longitude. | |\n| location.`span` | `string` | Location's viewport span. Can be used when rendering a map preview. | |\n| `titleLink` | `string` | The title link URL, similar to atom's related link. | |\n| `images[]` | `list` | Display image for the Post. | |\n| images[].`url` | `string` | | |\n| `status` | `string` | Status of the post. Only set for admin-level requests | |\n\nMethods\n-------\n\nYou can retrieve the list of posts for a blog using the [list](/blogger/docs/3.0/reference/posts/list) method, and retrieve an individual post using the [get](/blogger/docs/3.0/reference/posts/get) method.\n\n[list](/blogger/docs/3.0/reference/posts/list)\n: Retrieves a list of posts.\n\n[get](/blogger/docs/3.0/reference/posts/get)\n: Retrieves one post by post ID.\n\n[search](/blogger/docs/3.0/reference/posts/search)\n: Searches for a post that matches the given query terms.\n\n[insert](/blogger/docs/3.0/reference/posts/insert)\n: Adds a post.\n\n[delete](/blogger/docs/3.0/reference/posts/delete)\n: Deletes a post by ID.\n\n[getByPath](/blogger/docs/3.0/reference/posts/getByPath)\n: Retrieves a post by path.\n\n[patch](/blogger/docs/3.0/reference/posts/patch)\n: Updates a post. This method supports [patch semantics](/blogger/docs/3.0/performance).\n\n[update](/blogger/docs/3.0/reference/posts/update)\n: Updates a post.\n\n[publish](/blogger/docs/3.0/reference/posts/publish)\n: Publish a draft post.\n\n[revert](/blogger/docs/3.0/reference/posts/revert)\n: Revert a published or scheduled post to draft state, which removes the post from the publicly viewable content."]]
