Posts: list
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.
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.
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, and users should update to the latest API version.\u003c/p\u003e\n"],["\u003cp\u003eThis API retrieves a list of posts from a specified blog, requiring authentication only for private blogs.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use parameters like \u003ccode\u003efetchBodies\u003c/code\u003e, \u003ccode\u003emaxResults\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003estartDate\u003c/code\u003e to customize their requests for retrieving posts.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses will provide a list of posts along with pagination tokens for navigating through results.\u003c/p\u003e\n"]]],[],null,["# Posts: list\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.\n\nRetrieves a list of posts.\n[Try it now](#try-it).\n\nAuthentication 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.\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/blogger/v2/blogs/blogId/posts\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|--------------------|--------------------------------------------------------------------|\n| **Required Parameters** |||\n| `blogId` | `string` | ID of the blog to fetch posts from. |\n| **Optional Parameters** |||\n| `fetchBodies` | `boolean` | Whether the body content of posts is included. |\n| `maxResults` | `unsigned integer` | Maximum number of posts to fetch. |\n| `pageToken` | `string` | Continuation token if the request is paged. |\n| `startDate` | `datetime` | Earliest post date to fetch, a date-time with RFC 3339 formatting. |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#postList\",\n \"nextPageToken\": string,\n \"prevPageToken\": string,\n \"items\": [\n posts Resource\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|-----------------|----------|-------------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList`. | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `prevPageToken` | `string` | Pagination token to fetch the previous page, if one exists. | |\n| `items[]` | `list` | The list of posts for this blog. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
