REST API Resources

Welcome to the WordPress.com REST API. Below, you’ll find a full listing of all the available endpoints. As we add more endpoints, they will be automatically documented here and available through the Developer Console.

If you’re not sure how to make calls to the API, you might want to check out the Getting Started guide or the walkthrough on authentication.

For more information about a particular endpoint, click on its name under the Resource header. You’ll be taken to the endpoint’s documentation page, which includes what query parameters the endpoint will accept, what the JSON object’s parameters will be in the response, and an example query/response.

This documentation is for our most recent version of the REST API, version 1.1. Documentation is still available for version 1 of the REST API.

If you’re looking for the WordPress REST API that shipped as part of WordPress core in version 4.7, see its documentation.  Note that this API is also enabled on WordPress.com, but the URL structure on WordPress.com is slightly different than for self-hosted sites.  See this post for more details.

---

Users

View user information data such as username, name, email, blog, and Gravatar.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/users	List the users of a site.
POST 강남오피|광주오피|광주오피/sites/$site/users/$user_id	Update details of a user of a site.
GET 강남오피|광주오피|광주오피/sites/$site/users/login:$user_id	Get details of a user of a site by login.
POST 강남오피|광주오피|광주오피/sites/$site/users/$user_ID/delete	Deletes or removes a user of a site.
GET 강남오피|광주오피|광주오피/users/suggest	Get a list of possible users to suggest for @mentions.
GET 강남오피|광주오피|광주오피/me	Get metadata about the current user.
GET 강남오피|광주오피|광주오피/me/billing-history	Get list of current user's billing history and upcoming charges.
GET 강남오피|광주오피|광주오피/me/settings/	Get the current user's settings.
POST 강남오피|광주오피|광주오피/me/settings/	Update the current user's settings.
GET 강남오피|광주오피|광주오피/me/preferences/	Get the current user's settings.
POST 강남오피|광주오피|광주오피/me/preferences/	Update the current user's preferences.
POST 강남오피|광주오피|광주오피/me/settings/password/validate	Verify strength of a user's new password.
GET 강남오피|광주오피|광주오피/me/settings/profile-links/	Get current user's profile links.
POST 강남오피|광주오피|광주오피/me/settings/profile-links/new	Add a link to current user's profile.
POST 강남오피|광주오피|광주오피/me/settings/profile-links/$slug/delete	Delete a link from current user's profile.
GET 강남오피|광주오피|광주오피/me/connected-applications/	Get current user's connected applications.
GET 강남오피|광주오피|광주오피/me/connected-applications/$ID	Get one of current user's connected applications.
POST 강남오피|광주오피|광주오피/me/connected-applications/$ID/delete	Delete one of current user's connected application access tokens.
GET 강남오피|광주오피|광주오피/me/two-step	Get information about current user's two factor configuration.
POST 강남오피|광주오피|광주오피/me/two-step/sms/new	Sends a two-step code via SMS to the current user.
GET 강남오피|광주오피|광주오피/me/likes/	Get a list of the current user's likes.

Sites

View general site information and options.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/shortcodes/render	Get a rendered shortcode for a site. Note: The current user must have publishing access.
GET 강남오피|광주오피|광주오피/sites/$site/shortcodes	Get a list of shortcodes available on a site. Note: The current user must have publishing access.
GET 강남오피|광주오피|광주오피/sites/$site/embeds/render	Get a rendered embed for a site. Note: The current user must have publishing access.
GET 강남오피|광주오피|광주오피/sites/$site/embeds	Get a list of embeds available on a site. Note: The current user must have publishing access.
GET 강남오피|광주오피|광주오피/sites/$site	Get information about a site.
GET 강남오피|광주오피|광주오피/sites/$site/page-templates	Get a list of page templates supported by a site.
GET 강남오피|광주오피|광주오피/sites/$site/post-types	Get a list of post types available for a site.
GET 강남오피|광주오피|광주오피/sites/$site/post-counts/$post_type	Get number of posts in the post type groups by post status
GET 강남오피|광주오피|광주오피/sites/$site/widgets	Retrieve the active and inactive widgets for a site.
POST 강남오피|광주오피|광주오피/sites/$site/widgets/new	Activate a widget on a site.
GET 강남오피|광주오피|광주오피/sites/$site/wordads/settings	Get detailed WordAds settings information about a site.
POST 강남오피|광주오피|광주오피/sites/$site/wordads/settings	Update WordAds settings for a site.
GET 강남오피|광주오피|광주오피/sites/$site/wordads/earnings	Get detailed WordAds earnings information about a site.
GET 강남오피|광주오피|광주오피/sites/$site/wordads/tos	Get WordAds TOS information about a site.
POST 강남오피|광주오피|광주오피/sites/$site/wordads/tos	Update WordAds TOS setting for a site.
POST 강남오피|광주오피|광주오피/sites/$site/wordads/approve	Request streamlined approval to join the WordAds program.
GET 강남오피|광주오피|광주오피/sites/$site/wordads/stats	Get WordAds stats for a site
GET 강남오피|광주오피|광주오피/me/sites	Get a list of the current user's sites.
POST 강남오피|광주오피|광주오피/sites/$site/search	Search within a site using an Elasticsearch Query API.
GET 강남오피|광주오피|광주오피/sites/$site/widgets/widget:$id	Retrieve a widget on a site by its ID.
POST 강남오피|광주오피|광주오피/sites/$site/widgets/widget:$id	Update a widget on a site by its ID.
POST 강남오피|광주오피|광주오피/sites/$site/widgets/widget:$id/delete	Deactivate a widget on a site by its ID. Will delete if already deactivated.
GET 강남오피|광주오피|광주오피/sites/$site/headers/$theme_slug	Get the custom header options for a site with a particular theme.
GET 강남오피|광주오피|광주오피/sites/$site/headers/mine	Get the custom header options for a site.
POST 강남오피|광주오피|광주오피/sites/$site/headers/mine	Set the custom header options for a site.

Posts

View and manage posts including reblogs and likes.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID	Get a single post (by ID).
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID	Edit a post.
GET 강남오피|광주오피|광주오피/sites/$site/posts/slug:$post_slug	Get a single post (by slug).
GET 강남오피|광주오피|광주오피/sites/$site/posts/	Get a list of matching posts.
POST 강남오피|광주오피|광주오피/sites/$site/posts/new	Create a post.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/delete	Delete a post. Note: If the trash is enabled, this request will send the post to the trash. A second request will permanently delete the post.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/restore	Restore a post or page from the trash to its previous status.
POST 강남오피|광주오피|광주오피/sites/$site/posts/delete	Delete multiple posts. Note: If the trash is enabled, this request will send non-trashed posts to the trash. Trashed posts will be permanently deleted.
POST 강남오피|광주오피|광주오피/sites/$site/posts/restore	Restore multiple posts.
GET 강남오피|광주오피|광주오피/me/posts	Get a list of posts across all the user's sites.
GET 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/likes/	Get a list of the likes for a post.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/likes/new	Like a post.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/likes/mine/delete	Unlike a post.
GET 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/likes/mine/	Get the current user's like status for a post.
GET 강남오피|광주오피|광주오피/sites/$site/posts/$post/subscribers/	Get a list of the specified post's subscribers.
GET 강남오피|광주오피|광주오피/sites/$site/posts/$post/subscribers/mine	Get subscription status of the specified post for the current user.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post/subscribers/new	Subscribe current user to be notified of the specified post's comments.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post/subscribers/mine/delete	Unsubscribe the current user from the specified post.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/reblogs/new	Reblog a post.
GET 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/reblogs/mine	Get reblog status for a post.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post/related	Search within a site for related posts.

Comments

View and manage a post's comments.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID	Get a single comment.
POST 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID	Edit a comment.
GET 강남오피|광주오피|광주오피/sites/$site/comments/	Get a list of recent comments.
GET 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/replies/	Get a list of recent comments on a post.
POST 강남오피|광주오피|광주오피/sites/$site/posts/$post_ID/replies/new	Create a comment on a post.
POST 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID/replies/new	Create a comment as a reply to another comment.
POST 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID/delete	Delete a comment.
GET 강남오피|광주오피|광주오피/sites/$site/comment-counts	Get comment counts for each available status
GET 강남오피|광주오피|광주오피/sites/$site/comment-history/$comment_ID	Get the audit history for given comment
GET 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID/likes/	Get the likes for a comment.
POST 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID/likes/new	Like a comment.
POST 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID/likes/mine/delete	Remove your like from a comment.
GET 강남오피|광주오피|광주오피/sites/$site/comments/$comment_ID/likes/mine/	Get your like status for a comment.
GET 강남오피|광주오피|광주오피/kill-switch/comment-likes	Kill comment likes

Taxonomy

View and manage a site's tags and categories.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/categories	Get a list of a site's categories.
GET 강남오피|광주오피|광주오피/sites/$site/tags	Get a list of a site's tags.
GET 강남오피|광주오피|광주오피/sites/$site/categories/slug:$category	Get information about a single category.
POST 강남오피|광주오피|광주오피/sites/$site/categories/slug:$category	Edit a category.
GET 강남오피|광주오피|광주오피/sites/$site/tags/slug:$tag	Get information about a single tag.
POST 강남오피|광주오피|광주오피/sites/$site/tags/slug:$tag	Edit a tag.
GET 강남오피|광주오피|광주오피/sites/$site/taxonomies/$taxonomy/terms/slug:$slug	Get information about a single term.
POST 강남오피|광주오피|광주오피/sites/$site/taxonomies/$taxonomy/terms/slug:$slug	Edit a term.
GET 강남오피|광주오피|광주오피/sites/$site/post-types/$post_type/taxonomies	Get a list of taxonomies associated with a post type.
GET 강남오피|광주오피|광주오피/sites/$site/taxonomies/$taxonomy/terms	Get a list of a site's terms by taxonomy.
POST 강남오피|광주오피|광주오피/sites/$site/categories/new	Create a new category.
POST 강남오피|광주오피|광주오피/sites/$site/tags/new	Create a new tag.
POST 강남오피|광주오피|광주오피/sites/$site/categories/slug:$category/delete	Delete a category.
POST 강남오피|광주오피|광주오피/sites/$site/tags/slug:$tag/delete	Delete a tag.
POST 강남오피|광주오피|광주오피/sites/$site/taxonomies/$taxonomy/terms/new	Create a new term.
POST 강남오피|광주오피|광주오피/sites/$site/taxonomies/$taxonomy/terms/slug:$slug/delete	Delete a term.

Follow

Follow and unfollow blogs.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/follows/	List a site's followers in reverse chronological order.
POST 강남오피|광주오피|광주오피/sites/$site/follows/new	Follow a blog.
POST 강남오피|광주오피|광주오피/sites/$site/follows/mine/delete	Unfollow a blog.
GET 강남오피|광주오피|광주오피/sites/$site/follows/mine	Get blog following status for the current user.

Sharing

Connect social media services to automatically share new posts and manage sharing buttons on a site.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/sharing-buttons/	Get a list of a site's sharing buttons.
POST 강남오피|광주오피|광주오피/sites/$site/sharing-buttons	Edit all sharing buttons for a site.
GET 강남오피|광주오피|광주오피/meta/external-services/	Get a list of third-party services that WordPress.com or Jetpack sites can integrate with via keyring.
GET 강남오피|광주오피|광주오피/meta/external-services/$service	Get information about a single external service that WordPress.com or Jetpack sites can integrate with via keyring.
GET 강남오피|광주오피|광주오피/me/publicize-connections/	Get a list of publicize connections that the current user has set up.
GET 강남오피|광주오피|광주오피/me/publicize-connections/$publicize_connection_ID	Get a single publicize connection that the current user has set up.
POST 강남오피|광주오피|광주오피/me/publicize-connections/$publicize_connection_ID	Update a single publicize connection belonging to the current user.
POST 강남오피|광주오피|광주오피/me/publicize-connections/$publicize_connection_ID/delete	Delete the specified publicize connection.
GET 강남오피|광주오피|광주오피/me/keyring-connections/	Get a list of all the keyring connections associated with the current user.
GET 강남오피|광주오피|광주오피/me/keyring-connections/$keyring_connection_ID	Get a single Keyring connection that the current user has setup.
POST 강남오피|광주오피|광주오피/me/keyring-connections/$keyring_connection_ID/delete	Delete the Keyring connection (and associated token) with the provided ID. Also deletes all associated publicize connections.
GET 강남오피|광주오피|광주오피/sites/$site/publicize-connections/	Get a list of publicize connections that are associated with the specified site.
GET 강남오피|광주오피|광주오피/sites/$site/publicize-connections/$publicize_connection_ID	Get a single publicize connection that is associated with the specified site.
POST 강남오피|광주오피|광주오피/sites/$site/publicize-connections/$publicize_connection_ID	Update a single publicize connection belonging to the specified site.
POST 강남오피|광주오피|광주오피/sites/$site/publicize-connections/new	Create a new publicize connection that is associated with the specified site.
POST 강남오피|광주오피|광주오피/sites/$site/publicize-connections/$publicize_connection_ID/delete	Delete the specified publicize connection.
GET 강남오피|광주오피|광주오피/meta/sharing-buttons	Get a list of external services for which sharing buttons are supported.

Freshly Pressed

View Freshly Pressed posts from the WordPress.com homepage.

Resource	Description
GET 강남오피|광주오피|광주오피/freshly-pressed/	Get a list of Freshly Pressed posts. (Note: Freshly Pressed has been retired. Please visit https://discover.wordpress.com to get the best content published across our network.)

Notifications

View and manage a user's notifications.

Resource	Description
POST 강남오피|광주오피|광주오피/notifications/seen	Set the timestamp of the most recently seen notification.
POST 강남오피|광주오피|광주오피/notifications/read	Mark a set of notifications as read.

Insights

View analytics for your application.

Resource	Description
GET 강남오피|광주오피|광주오피/insights	Get a list of stats/metrics/insights that the current user has access to.
GET 강남오피|광주오피|광주오피/insights/$slug	Get raw data for a particular graph.

Reader

Manage and view a user's subscriptions to the WordPress.com Reader.

Resource	Description
GET 강남오피|광주오피|광주오피/read/menu/	Get default reader menu.
GET 강남오피|광주오피|광주오피/read/feed/$feed_url_or_id	Get details about a feed.
GET 강남오피|광주오피|광주오피/read/sites/$site/posts/$post_ID	Get a single post (by ID).
GET 강남오피|광주오피|광주오피/read/following/	Get a list of posts from the blogs a user follows.
GET 강남오피|광주오피|광주오피/read/liked/	Get a list of posts from the blogs a user likes.
GET 강남오피|광주오피|광주오피/read/tags/$tag/posts	Get a list of posts from a tag.
GET 강남오피|광주오피|광주오피/read/tags	Get a list of tags subscribed to by the user.
GET 강남오피|광주오피|광주오피/read/trending/tags	Get a list of trending tags.
GET 강남오피|광주오피|광주오피/read/tags/$tag	Get details about a specified tag.
GET 강남오피|광주오피|광주오피/read/tags/$tag/mine	Get the subscribed status of the user to a given tag.
POST 강남오피|광주오피|광주오피/read/tags/$tag/mine/new	Subscribe to a new tag.
POST 강남오피|광주오피|광주오피/read/tags/$tag/mine/delete	Unsubscribe from a tag.
GET 강남오피|광주오피|광주오피/read/following/mine	Get a list of the feeds the user is following.
POST 강남오피|광주오피|광주오피/read/following/mine/new	Follow the specified blog.
POST 강남오피|광주오피|광주오피/read/following/mine/delete	Unfollow the specified blog.
GET 강남오피|광주오피|광주오피/read/feed/	Get the ID and subscribe URL of one or more matching feeds by domain or URL.
GET 강남오피|광주오피|광주오피/read/recommendations/mine/	Get a list of blog recommendations for the current user.

Stats

View stats for a site.

Resource	Description
GET 강남오피|광주오피|광주오피/sites/$site/stats	Get a site's stats
GET 강남오피|광주오피|광주오피/sites/$site/stats/summary	View a site's summarized views, visitors, likes and comments
GET 강남오피|광주오피|광주오피/sites/$site/stats/top-posts	View a site's top posts and pages by views
GET 강남오피|광주오피|광주오피/sites/$site/stats/video/$post_id	View the details of a single video
GET 강남오피|광주오피|광주오피/sites/$site/stats/referrers	View a site's referrers
GET 강남오피|광주오피|광주오피/sites/$site/stats/clicks	View a site's outbound clicks
GET 강남오피|광주오피|광주오피/sites/$site/stats/tags	View a site's views by tags and categories
GET 강남오피|광주오피|광주오피/sites/$site/stats/top-authors	View a site's top authors
GET 강남오피|광주오피|광주오피/sites/$site/stats/comments	View a site's top comment authors and most-commented posts
GET 강남오피|광주오피|광주오피/sites/$site/stats/video-plays	View a site's video plays
GET 강남오피|광주오피|광주오피/sites/$site/stats/file-downloads	View a site's file downloads
GET 강남오피|광주오피|광주오피/sites/$site/stats/post/$post_id	View a post's views
GET 강남오피|광주오피|광주오피/sites/$site/stats/country-views	View a site's views by country
GET 강남오피|광주오피|광주오피/sites/$site/stats/followers	View a site's followers
GET 강남오피|광주오피|광주오피/sites/$site/stats/comment-followers	View a site's comment followers
POST 강남오피|광주오피|광주오피/sites/$site/stats/referrers/spam/new	Report a referrer as spam
POST 강남오피|광주오피|광주오피/sites/$site/stats/referrers/spam/delete	Unreport a referrer as spam
GET 강남오피|광주오피|광주오피/sites/$site/stats/publicize	View a site's publicize follower counts
GET 강남오피|광주오피|광주오피/sites/$site/stats/search-terms	View search terms used to find the site
GET 강남오피|광주오피|광주오피/sites/$site/stats/views/posts	View the total number of views for each post.
GET 강남오피|광주오피|광주오피/sites/$site/stats/streak	Get stats for Calendar Heatmap. Returns data with each post timestamp.

Media

Manage a site's media library.

Resource	Description
POST 강남오피|광주오피|광주오피/sites/$site/media/$media_ID/delete	Delete a piece of media. Note: Media is deleted and not trashed.
GET 강남오피|광주오피|광주오피/sites/$site/media/$media_ID	Get a single media item (by ID).
POST 강남오피|광주오피|광주오피/sites/$site/media/$media_ID	Edit basic information about a media item.
GET 강남오피|광주오피|광주오피/sites/$site/media/	Get a list of items in the media library.
POST 강남오피|광주오피|광주오피/sites/$site/media/new	Upload a new piece of media.
POST 강남오피|광주오피|광주오피/sites/$site/media/$media_ID/edit	Edit a media item.

Menus

View and manage a site's menus.

Resource	Description
POST 강남오피|광주오피|광주오피/sites/$site/menus/new	Create a new navigation menu.
POST 강남오피|광주오피|광주오피/sites/$site/menus/$menu_id	Update a navigation menu.
GET 강남오피|광주오피|광주오피/sites/$site/menus/$menu_id	Get a single navigation menu.
GET 강남오피|광주오피|광주오피/sites/$site/menus	Get a list of all navigation menus.
POST 강남오피|광주오피|광주오피/sites/$site/menus/$menu_id/delete	Delete a navigation menu

Batch

Batch several API GET requests into one.

Resource	Description
GET 강남오피|광주오피|광주오피/batch/	Run several GET endpoints and return them as an array.

Videos

View video information.

Resource	Description
GET 강남오피|광주오피|광주오피/videos/$guid	Get the metadata for a specified VideoPress video.
GET 강남오피|광주오피|광주오피/videos/$guid/poster	Get the poster for a specified VideoPress video.
POST 강남오피|광주오피|광주오피/videos/$guid/poster	Upload and set a poster for a specified VideoPress video.