WordPress.com
WordPress content management and publishing platform
Actions (214)
Sites · 27
- Activate site widgetPOST /sites/{site}/widgets/new
Activate a widget on a site.
documented - Approve WordAdsPOST /sites/{site}/wordads/approve
Request streamlined approval to join the WordAds program.
documented - Deactivate site widgetPOST /sites/{site}/widgets/widget:{id}/delete
Deactivate a widget on a site by its ID.
documented - Get WordAds TOSGET /sites/{site}/wordads/tos
Get WordAds TOS information about a site.
documented - Get WordAds earningsGET /sites/{site}/wordads/earnings
Get WordAds earnings information about a site.
documented - Get WordAds settingsGET /sites/{site}/wordads/settings
Get detailed WordAds settings information about a site.
documented - Get WordAds statsGET /sites/{site}/wordads/stats
Get WordAds stats for a site.
documented - Get site headers (mine)GET /sites/{site}/headers/mine
Get the custom header options for a site.
documented - Get site headers (theme)GET /sites/{site}/headers/{theme_slug}
Get the custom header options for a site with a particular theme.
documented - Get site informationGET /sites/{site}
Get information about a site.
documented - Get site page templatesGET /sites/{site}/page-templates
Get a list of page templates supported by a site.
documented - Get site post counts by typeGET /sites/{site}/post-counts/{post_type}
Get number of posts in the post type groups by post status.
documented - Get site post typesGET /sites/{site}/post-types
Get a list of post types available for a site.
documented - Get site widgetGET /sites/{site}/widgets/widget:{id}
Retrieve a widget on a site by its ID.
documented - Get site widgetsGET /sites/{site}/widgets
Retrieve the active and inactive widgets for a site.
documented - List current user sites featuresGET /me/sites/features
Get a list of the current user’s sites features.
documented - List current user sites pluginsGET /me/sites/plugins
Get a list of the current user’s sites plugins.
documented - List current user’s sitesGET /me/sites
Get a list of the current user’s sites.
documented - List site embedsGET /sites/{site}/embeds
Get a list of embeds available on a site. Note: The current user must have publishing access.
documented - List site shortcodesGET /sites/{site}/shortcodes
Get a list of shortcodes available on a site. Note: The current user must have publishing access.
documented - Render site embedGET /sites/{site}/embeds/render
Get a rendered embed for a site. Note: The current user must have publishing access.
documented - Render site shortcodeGET /sites/{site}/shortcodes/render
Get a rendered shortcode for a site. Note: The current user must have publishing access.
documented - Search within a sitePOST /sites/{site}/search
Search within a site using an Elasticsearch Query API.
documented - Set site headers (mine)POST /sites/{site}/headers/mine
Set the custom header options for a site.
documented - Update WordAds TOSPOST /sites/{site}/wordads/tos
Update WordAds TOS setting for a site.
documented - Update WordAds settingsPOST /sites/{site}/wordads/settings
Update WordAds settings for a site.
documented - Update site widgetPOST /sites/{site}/widgets/widget:{id}
Update a widget on a site by its ID.
documented
Posts · 26
- Create postPOST /sites/{site}/posts/new
Create a new post.
documented - Delete multiple postsPOST /sites/{site}/posts/delete
Delete multiple posts.
documented - Delete postPOST /sites/{site}/posts/{post_ID}/delete
Delete a post (trash vs permanent depending on site settings).
documented - Get my like status for a postGET /sites/{site}/posts/{post_ID}/likes/mine/
Get whether the current user likes the post.
documented - Get postGET /sites/{site}/posts/{post_ID}
Get a single post by ID.
documented - Get post by slugGET /sites/{site}/posts/slug:{post_slug}
Get a single post by slug.
documented - Get post subscription statusGET /sites/{site}/posts/{post_ID}/subscribers/mine
Get current user’s subscription status for a post.
documented - Get reblog statusGET /sites/{site}/posts/{post_ID}/reblogs/mine
Get reblog status for a post.
documented - Get rendered embedGET /sites/{site}/embeds/render
Get a rendered embed for a site.
documented - Get rendered shortcodeGET /sites/{site}/shortcodes/render
Render a shortcode for a site.
documented - Like a postPOST /sites/{site}/posts/{post_ID}/likes/new
Like a post.
documented - List embedsGET /sites/{site}/embeds
List embeds available on a site.
documented - List post likesGET /sites/{site}/posts/{post_ID}/likes/
Get a list of the likes for a post.
documented - List post subscribersGET /sites/{site}/posts/{post_ID}/subscribers/
Get a list of subscribers for a post.
documented - List postsGET /sites/{site}/posts/
Get a list of matching posts.
documented - List posts across all user’s sitesGET /me/posts
Get a list of posts across all the user’s sites.
documented - List shortcodesGET /sites/{site}/shortcodes
List available shortcodes.
documented - Reblog a postPOST /sites/{site}/posts/{post_ID}/reblogs/new
Reblog a post.
documented - Restore multiple postsPOST /sites/{site}/posts/restore
Restore multiple posts from trash.
documented - Restore postPOST /sites/{site}/posts/{post_ID}/restore
Restore a post from trash.
documented - Search related postsPOST /sites/{site}/posts/{post}/related
Search within a site for related posts.
documented - Subscribe to postPOST /sites/{site}/posts/{post_ID}/subscribers/new
Subscribe current user to post comments.
documented - Unlike a postPOST /sites/{site}/posts/{post_ID}/likes/mine/delete
Unlike a post.
documented - Unsubscribe from postPOST /sites/{site}/posts/{post_ID}/subscribers/mine/delete
Unsubscribe current user from a post.
documented - Update postPOST /sites/{site}/posts/{post_ID}
Edit a post.
documented - Update post subscriptionPOST /sites/{site}/posts/{post_ID}/subscribers/mine/update
Update subscription for current user on a post.
documented
Taxonomy · 24
- Create categoryPOST /sites/{site}/categories/new
Create a new category.
documented - Create categoryPOST /sites/{site}/categories/new
Create a new category.
documented - Create tagPOST /sites/{site}/tags/new
Create a new tag.
documented - Create tagPOST /sites/{site}/tags/new
Create a new tag.
documented - Create termPOST /sites/{site}/taxonomies/{taxonomy}/terms/new
Create a new term.
documented - Create termPOST /sites/{site}/taxonomies/{taxonomy}/terms/new
Create a new term.
documented - Delete categoryPOST /sites/{site}/categories/slug:{category}/delete
Delete a category.
documented - Delete categoryPOST /sites/{site}/categories/slug:{category}/delete
Delete a category.
documented - Delete tagPOST /sites/{site}/tags/slug:{tag}/delete
Delete a tag.
documented - Delete tagPOST /sites/{site}/tags/slug:{tag}/delete
Delete a tag.
documented - Delete termPOST /sites/{site}/taxonomies/{taxonomy}/terms/slug:{slug}/delete
Delete term.
documented - Delete termPOST /sites/{site}/taxonomies/{taxonomy}/terms/slug:{slug}/delete
Delete a term.
documented - Edit categoryPOST /sites/{site}/categories/slug:{category}
Edit a category.
documented - Edit tagPOST /sites/{site}/tags/slug:{tag}
Edit a tag.
documented - Edit termPOST /sites/{site}/taxonomies/{taxonomy}/terms/slug:{slug}
Edit a term.
documented - Get category by slugGET /sites/{site}/categories/slug:{category}
Get information about a single category.
documented - Get tag by slugGET /sites/{site}/tags/slug:{tag}
Get information about a single tag.
documented - Get term by slugGET /sites/{site}/taxonomies/{taxonomy}/terms/slug:{slug}
Get information about a single term.
documented - List site categoriesGET /sites/{site}/categories
Get a list of a site’s categories.
documented - List site tagsGET /sites/{site}/tags
Get a list of a site’s tags.
documented - List taxonomies for a post typeGET /sites/{site}/post-types/{post_type}/taxonomies
Get a list of taxonomies associated with a post type.
documented - List taxonomies for a post typeGET /sites/{site}/post-types/{post_type}/taxonomies
Get a list of taxonomies associated with a post type.
documented - List terms by taxonomyGET /sites/{site}/taxonomies/{taxonomy}/terms
Get a list of a site’s terms by taxonomy.
documented - List terms by taxonomyGET /sites/{site}/taxonomies/{taxonomy}/terms
Get a list of a site’s terms by taxonomy.
documented
Users · 22
- Create profile linkPOST /me/settings/profile-links/new
Add a link to current user’s profile.
documented - Delete connected applicationPOST /me/connected-applications/{ID}/delete
Delete one of the current user’s connected applications.
documented - Delete profile linkPOST /me/settings/profile-links/{slug}/delete
Delete a link from current user’s profile.
documented - Delete site userPOST /sites/{site}/users/{user_ID}/delete
Deletes or removes a user of a site.
documented - Get connected applicationGET /me/connected-applications/{ID}
Get one of current user’s connected applications.
documented - Get current userGET /me
Get metadata about the current user.
documented - Get current user preferencesGET /me/preferences/
Get the current user’s preferences.
documented - Get current user settingsGET /me/settings/
Get the current user’s settings.
documented - Get profile linksGET /me/settings/profile-links/
Get current user’s profile links.
documented - Get site user by loginGET /sites/{site}/users/login:{user_id}
Get details of a user of a site by login.
documented - Get two-step configurationGET /me/two-step
Get information about current user’s two-factor configuration.
documented - Invite site usersPOST /sites/{site}/invites/new
Invite one or more users to your site.
documented - List billing historyGET /me/billing-history
Get list of current user’s billing history and upcoming charges.
documented - List connected applicationsGET /me/connected-applications/
Get current user’s connected applications.
documented - List my likesGET /me/likes/
Get a list of the current user’s likes.
documented - List site usersGET /sites/{site}/users
List the users of a site.
documented - Send two-step code via SMSPOST /me/two-step/sms/new
Sends a two-step code via SMS to the current user.
documented - Suggest usersGET /users/suggest
Get a list of possible users to suggest for @mentions.
documented - Update current user preferencesPOST /me/preferences
Update the current user’s preferences.
documented - Update current user settingsPOST /me/settings/
Update the current user’s settings.
documented - Update site userPOST /sites/{site}/users/{user_id}
Update details of a user of a site.
documented - Validate password strengthPOST /me/settings/password/validate
Verify strength of a user’s new password.
documented
Reader · 21
- Follow reader feedPOST /read/following/mine/new
Follow a blog in Reader.
documented - Get reader email settingsGET /read/email-settings/
Returns the email settings
documented - Get reader feedGET /read/feed/{feed_url_or_id}
Get details about a feed.
documented - Get reader menuGET /read/menu/
Get default reader menu.
documented - Get reader postGET /read/sites/{site}/posts/{post_ID}
Get a single post by ID in Reader.
documented - Get reader recommendationsGET /read/recommendations/mine/
Get a list of blog recommendations for the current user.
documented - Get reader subscriptions countsGET /read/subscriptions-count/
Returns the number of blog, comment and pending subscriptions.
documented - Get reader tagGET /read/tags/{tag}
Get details about a specified tag.
documented - Get reader tag subscriptionGET /read/tags/{tag}/mine
Get the subscribed status of the user to a given tag.
documented - List following (mine)GET /read/following/mine
Get the feeds the user is following.
documented - List following in ReaderGET /read/following/
Get a list of posts from blogs you follow.
documented - List liked posts (Reader)GET /read/liked/
Get a list of posts you’ve liked.
documented - List posts by tag (Reader)GET /read/tags/{tag}/posts
Get a list of posts for a given tag.
documented - List subscribed tags (Reader)GET /read/tags
Get a list of tags subscribed to by the user.
documented - List top tags alphabeticallyGET /read/tags/{tag}/alphabetic
Get a filtered list of top tags, grouped by letter.
documented - List trending tags (Reader)GET /read/trending/tags
Get a list of trending tags.
documented - Search reader feedGET /read/feed/
Get ID and subscribe URL of matching feeds.
documented - Subscribe to reader tagPOST /read/tags/{tag}/mine/new
Subscribe to a new tag.
documented - Unfollow reader feedPOST /read/following/mine/delete
Unfollow a blog in Reader.
documented - Unsubscribe from reader tagPOST /read/tags/{tag}/mine/delete
Unsubscribe from a tag.
documented - Update reader email settingsPOST /read/email-settings/
Returns the email settings
documented
Sharing · 17
- Create site publicize connectionPOST /sites/{site}/publicize-connections/new
Create a new publicize connection for the site.
documented - Delete Keyring connectionPOST /me/keyring-connections/{keyring_connection_ID}/delete
Delete the Keyring connection (and associated token).
documented - Delete publicize connectionPOST /me/publicize-connections/{publicize_connection_ID}/delete
Delete the specified publicize connection.
documented - Delete site publicize connectionPOST /sites/{site}/publicize-connections/{publicize_connection_ID}/delete
Delete the specified publicize connection.
documented - Get Keyring connectionGET /me/keyring-connections/{keyring_connection_ID}
Get a single Keyring connection.
documented - Get external serviceGET /meta/external-services/{service}
Get information about a single external service.
documented - Get publicize connectionGET /me/publicize-connections/{publicize_connection_ID}
Get a single publicize connection for the current user.
documented - Get site publicize connectionGET /sites/{site}/publicize-connections/{publicize_connection_ID}
Get a publicize connection for a site.
documented - List Keyring connectionsGET /me/keyring-connections/
Get a list of all the keyring connections associated with the current user.
documented - List external servicesGET /meta/external-services/
Get a list of third-party services WordPress.com or Jetpack sites can integrate with.
documented - List external sharing servicesGET /meta/sharing-buttons
Get a list of external services for which sharing buttons are supported.
documented - List publicize connectionsGET /me/publicize-connections/
Get a list of publicize connections for the current user.
documented - List sharing buttonsGET /sites/{site}/sharing-buttons/
Get a list of a site’s sharing buttons.
documented - List site publicize connectionsGET /sites/{site}/publicize-connections/
Get a list of publicize connections for the specified site.
documented - Update publicize connectionPOST /me/publicize-connections/{publicize_connection_ID}
Update a publicize connection.
documented - Update sharing buttonsPOST /sites/{site}/sharing-buttons
Edit all sharing buttons for a site.
documented - Update site publicize connectionPOST /sites/{site}/publicize-connections/{publicize_connection_ID}
Update a site publicize connection.
documented
Stats · 16
- Get site clicksGET /sites/{site}/stats/clicks
View a site’s outbound clicks.
documented - Get site comment followersGET /sites/{site}/stats/comment-followers
View a site’s comment followers.
documented - Get site country viewsGET /sites/{site}/stats/country-views
View a site’s views by country.
documented - Get site file downloadsGET /sites/{site}/stats/file-downloads
View a site’s file downloads.
documented - Get site followersGET /sites/{site}/stats/followers
View a site’s followers.
documented - Get site post viewsGET /sites/{site}/stats/post/{post_id}
View a post’s views.
documented - Get site referrersGET /sites/{site}/stats/referrers
View a site’s referrers.
documented - Get site statsGET /sites/{site}/stats
Get a site’s stats
documented - Get site stats by tagsGET /sites/{site}/stats/tags
View a site’s views by tags and categories.
documented - Get site stats highlightsGET /sites/{site}/stats/highlights
View highlight metrics from the last seven days.
documented - Get site stats summaryGET /sites/{site}/stats/summary
View a site’s summarized views, visitors, likes and comments.
documented - Get site top authorsGET /sites/{site}/stats/top-authors
View a site’s top authors.
documented - Get site top comment authorsGET /sites/{site}/stats/comments
View a site’s top comment authors and most-commented posts.
documented - Get site top postsGET /sites/{site}/stats/top-posts
View a site’s top posts and pages by views.
documented - Get site video playsGET /sites/{site}/stats/video-plays
View a site’s video plays.
documented - Get site video statsGET /sites/{site}/stats/video/{post_id}
View the details of a single video.
documented
Comments · 14
- Comment audit historyGET /sites/{site}/comment-history/{comment_ID}
Get the audit history for a given comment.
documented - Comment countsGET /sites/{site}/comment-counts
Get comment counts for each available status.
documented - Comment likesGET /sites/{site}/comments/{comment_ID}/likes/
Get likes for a comment.
documented - Create comment as replyPOST /sites/{site}/posts/{post_ID}/replies/new
Create a comment as a reply to another comment.
documented - Create reply to a commentPOST /sites/{site}/comments/{comment_ID}/replies/new
Create a reply to a comment.
documented - Delete commentPOST /sites/{site}/comments/{comment_ID}/delete
Delete a comment.
documented - Edit commentPOST /sites/{site}/comments/{comment_ID}
Edit a comment.
documented - Get a single commentGET /sites/{site}/comments/{comment_ID}
Get a single comment.
documented - Get my like status for a commentGET /sites/{site}/comments/{comment_ID}/likes/mine/
Get whether the current user likes the comment.
documented - Kill comment likesGET /kill-switch/comment-likes
Kill all comment likes (kill switch).
documented - Like a commentPOST /sites/{site}/comments/{comment_ID}/likes/new
Like a comment.
documented - List commentsGET /sites/{site}/comments/
Get a list of recent comments.
documented - List post repliesGET /sites/{site}/posts/{post_ID}/replies/
Get a list of recent comments on a post.
documented - Unlike a commentPOST /sites/{site}/comments/{comment_ID}/likes/mine/delete
Remove your like from a comment.
documented
GitHub Deployments · 8
- Create code deploymentPOST /sites/{wpcom_site}/hosting/code-deployments
Create or update a deployment configuration for this site.
documented - Delete code deploymentDELETE /wpcom/v2/sites/{wpcom_site}/hosting/code-deployments/{deployment_id}
Delete a deployment configuration for a site.
documented - Get deployment run logsGET /sites/{wpcom_site}/hosting/code-deployments/{deployment_id}/runs/{deployment_run_id}/logs
Get the logs for a deployment run.
documented - Initiate deployment runPOST /sites/{wpcom_site}/hosting/code-deployments/{deployment_id}/runs
Initiate a manual deployment run.
documented - List GitHub installationsGET /hosting/github/installations
Return a list of installations that a GitHub user has access to.
documented - List GitHub repositoriesGET /hosting/github/repositories
Get a list of repositories and their external_repository_ids.
documented - List code deployment runsGET /wpcom/v2/sites/{wpcom_site}/hosting/code-deployments/{deployment_id}/runs
Get code deployment runs.
documented - List code deploymentsGET /sites/{wpcom_site}/hosting/code-deployments
Get a list of site code deployments configured for this site.
documented
Agencies · 7
- Create staging sitePOST /wpcom/v2/sites/{wpcom_site}/staging-site
Create a staging site for an existing site.
documented - Delete staging siteDELETE /wpcom/v2/sites/{wpcom_site}/staging-site/{staging_site_id}
Delete the staging site.
documented - Get Automated Transfer statusGET /sites/{site}/automated-transfers/status
Returns the current status of Automated Transfer for a site.
documented - Get staging siteGET /wpcom/v2/sites/{wpcom_site}/staging-site
Retrieves the staging site associated with a production site.
documented - List agency sitesGET /wpcom/v2/agency/{agency_id}/sites
Get a list of sites managed by the agency.
documented - List pending agency sitesGET /wpcom/v2/agency/{agency_id}/sites/pending
Get a list of sites that are available for provision.
documented - Provision new agency sitePOST /wpcom/v2/agency/{agency_id}/sites/{site_id}/provision
Provision a new site for the agency.
documented
Videos · 7
- Delete video trackPOST /videos/{guid}/tracks/delete
Delete a subtitle track for a VideoPress video.
documented - Get videoGET /videos/{guid}
Get the metadata for a specified VideoPress video.
documented - Get video chaptersGET /videos/{guid}/chapters
Get the chapters for a VideoPress video.
documented - Get video posterGET /videos/{guid}/poster
Get the poster for a specified VideoPress video.
documented - Get video poster (alternate)GET /videos/{guid}/playlist/{format}
Get the poster for a VideoPress video.
documented - Upload subtitle trackPOST /videos/{guid}/tracks
Upload a subtitle track for a VideoPress video.
documented - Upload video posterPOST /videos/{guid}/poster
Upload and set a poster for a VideoPress video.
documented
Media · 6
- Delete mediaPOST /sites/{site}/media/{media_ID}/delete
Delete a piece of media.
documented - Edit mediaPOST /sites/{site}/media/{media_ID}/edit
Edit a media item.
documented - Get mediaGET /sites/{site}/media/{media_ID}
Get a single media item.
documented - List mediaGET /sites/{site}/media/
Get a list of media items.
documented - Update mediaPOST /sites/{site}/media/{media_ID}
Edit basic information about a media item.
documented - Upload mediaPOST /sites/{site}/media/new
Upload a new piece of media.
documented
Menus · 5
- Create menuPOST /sites/{site}/menus/new
Create a new navigation menu.
documented - Delete menuPOST /sites/{site}/menus/{menu_id}/delete
Delete a navigation menu.
documented - Get menuGET /sites/{site}/menus/{menu_id}
Get a single navigation menu.
documented - List menusGET /sites/{site}/menus
Get a list of all navigation menus.
documented - Update menuPOST /sites/{site}/menus/{menu_id}
Update a navigation menu.
documented
Follow · 4
- Follow sitePOST /sites/{site}/follows/new
Follow a blog.
documented - Get blog following statusGET /sites/{site}/follows/mine
Get blog following status for the current user.
documented - List site followsGET /sites/{site}/follows/
List a site’s followers in reverse chronological order.
documented - Unfollow sitePOST /sites/{site}/follows/mine/delete
Unfollow a blog.
documented
SSH Management · 4
- Create SSH userPOST /wpcom/v2/sites/{wpcom_site}/hosting/ssh-user
Create an SSH user for a site.
documented - Get SSH access typeGET /wpcom/v2/sites/{wpcom_site}/hosting/ssh-access
Get SSH access setting type for a site.
documented - List SSH usersGET /wpcom/v2/sites/{wpcom_site}/hosting/ssh-users
Get SSH users for a site.
documented - Reset SSH user passwordPOST /wpcom/v2/sites/{wpcom_site}/hosting/ssh-user/{ssh_user}/reset-password
Rotate the SSH user password and return the new password.
documented