# Posts

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

For a list of [methods](https://developers.google.com/blogger/docs/3.0/reference/posts#methods) for this resource, see the end of this page.

## Resource representations

<br />

```
{
  "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](http://www.ietf.org/rfc/rfc3339.txt) `date-time` when this post was published. |   |
| `updated` | `datetime` | [RFC 3339](http://www.ietf.org/rfc/rfc3339.txt) `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](https://developers.google.com/blogger/docs/3.0/reference/posts/list) method, and retrieve an individual post using the [get](https://developers.google.com/blogger/docs/3.0/reference/posts/get) method.

[list](https://developers.google.com/blogger/docs/3.0/reference/posts/list)
:   Retrieves a list of posts.

[get](https://developers.google.com/blogger/docs/3.0/reference/posts/get)
:   Retrieves one post by post ID.

[search](https://developers.google.com/blogger/docs/3.0/reference/posts/search)
:   Searches for a post that matches the given query terms.

[insert](https://developers.google.com/blogger/docs/3.0/reference/posts/insert)
:   Adds a post.

[delete](https://developers.google.com/blogger/docs/3.0/reference/posts/delete)
:   Deletes a post by ID.

[getByPath](https://developers.google.com/blogger/docs/3.0/reference/posts/getByPath)
:   Retrieves a post by path.

[patch](https://developers.google.com/blogger/docs/3.0/reference/posts/patch)
:   Updates a post. This method supports [patch semantics](https://developers.google.com/blogger/docs/3.0/performance).

[update](https://developers.google.com/blogger/docs/3.0/reference/posts/update)
:   Updates a post.

[publish](https://developers.google.com/blogger/docs/3.0/reference/posts/publish)
:   Publish a draft post.

[revert](https://developers.google.com/blogger/docs/3.0/reference/posts/revert)
:   Revert a published or scheduled post to draft state, which removes the post from the publicly viewable content.