> For the complete documentation index, see [llms.txt](https://githubichsan.gitbook.io/journal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://githubichsan.gitbook.io/journal/wordpress-development/rest-api/posts.md).
# /posts
Query this endpoint to retrieve a collection of posts. The response you receive can be controlled and filtered using the URL query parameters below.
`GET /wp/v2/posts`
| `context` | Scope under which the request is made; determines fields present in response.
Default: view
One of: view, embed, edit
|
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `page` | Current page of the collection.
Default: 1
|
| `per_page` | Maximum number of items to be returned in result set.
Default: 10
|
| `search` | Limit results to those matching a string. |
| `after` | Limit response to posts published after a given ISO8601 compliant date. |
| `modified_after` | Limit response to posts modified after a given ISO8601 compliant date. |
| `author` | Limit result set to posts assigned to specific authors. |
| `author_exclude` | Ensure result set excludes posts assigned to specific authors. |
| `before` | Limit response to posts published before a given ISO8601 compliant date. |
| `modified_before` | Limit response to posts modified before a given ISO8601 compliant date. |
| `exclude` | Ensure result set excludes specific IDs. |
| `include` | Limit result set to specific IDs. |
| `offset` | Offset the result set by a specific number of items. |
| `order` | Order sort attribute ascending or descending.
Default: desc
One of: asc, desc
|
| `orderby` | Sort collection by post attribute.
Default: date
One of: author, date, id, include, modified, parent, relevance, slug, include\_slugs, title
|
| `search_columns` | Array of column names to be searched. |
| `slug` | Limit result set to posts with one or more specific slugs. |
| `status` | Limit result set to posts assigned one or more statuses.
Default: publish
|
| `tax_relation` | Limit result set based on relationship between multiple taxonomies.
One of: AND, OR
|
| `categories` | Limit result set to items with specific terms assigned in the categories taxonomy. |
| `categories_exclude` | Limit result set to items except those with specific terms assigned in the categories taxonomy. |
| `tags` | Limit result set to items with specific terms assigned in the tags taxonomy. |
| `tags_exclude` | Limit result set to items except those with specific terms assigned in the tags taxonomy. |
| `sticky` | Limit result set to items that are sticky. |
`POST /wp/v2/posts`
| [`date`](https://developer.wordpress.org/rest-api/reference/posts/#schema-date) | The date the post was published, in the site's timezone. |
| --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`date_gmt`](https://developer.wordpress.org/rest-api/reference/posts/#schema-date_gmt) | The date the post was published, as GMT. |
| [`slug`](https://developer.wordpress.org/rest-api/reference/posts/#schema-slug) | An alphanumeric identifier for the post unique to its type. |
| [`status`](https://developer.wordpress.org/rest-api/reference/posts/#schema-status) | A named status for the post.
One of: publish, future, draft, pending, private
|
| [`password`](https://developer.wordpress.org/rest-api/reference/posts/#schema-password) | A password to protect access to the content and excerpt. |
| [`title`](https://developer.wordpress.org/rest-api/reference/posts/#schema-title) | The title for the post. |
| [`content`](https://developer.wordpress.org/rest-api/reference/posts/#schema-content) | The content for the post. |
| [`author`](https://developer.wordpress.org/rest-api/reference/posts/#schema-author) | The ID for the author of the post. |
| [`excerpt`](https://developer.wordpress.org/rest-api/reference/posts/#schema-excerpt) | The excerpt for the post. |
| [`featured_media`](https://developer.wordpress.org/rest-api/reference/posts/#schema-featured_media) | The ID of the featured media for the post. |
| [`comment_status`](https://developer.wordpress.org/rest-api/reference/posts/#schema-comment_status) | Whether or not comments are open on the post.
One of: open, closed
|
| [`ping_status`](https://developer.wordpress.org/rest-api/reference/posts/#schema-ping_status) | Whether or not the post can be pinged.
One of: open, closed
|
| [`format`](https://developer.wordpress.org/rest-api/reference/posts/#schema-format) | The format for the post.
One of: standard, aside, chat, gallery, link, image, quote, status, video, audio
|
| [`meta`](https://developer.wordpress.org/rest-api/reference/posts/#schema-meta) | Meta fields. |
| [`sticky`](https://developer.wordpress.org/rest-api/reference/posts/#schema-sticky) | Whether or not the post should be treated as sticky. |
| [`template`](https://developer.wordpress.org/rest-api/reference/posts/#schema-template) | The theme file to use to display the post. |
| [`categories`](https://developer.wordpress.org/rest-api/reference/posts/#schema-categories) | The terms assigned to the post in the category taxonomy. |
| [`tags`](https://developer.wordpress.org/rest-api/reference/posts/#schema-tags) | The terms assigned to the post in the post\_tag taxonomy. |
`GET /wp/v2/posts/`
`POST /wp/v2/posts/`Update a post
`DELETE /wp/v2/posts/`
\