Welcome to the 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.

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 except, what the JSON object’s parameters will be in the response, and an example query/response.

---

Users

User information including profile data.

Resource	Description
GET/me	Meta data about auth token's User

Sites

Metadata on a blog.

Resource	Description
GET/sites/$site	Information about a site ID/domain

Posts

Information and management of posts including reblogs and likes.

Resource	Description
GET/sites/$site/posts/	Return matching Posts
GET/sites/$site/posts/$post_ID	Return a single Post (by ID)
POST/sites/$site/posts/$post_ID	Edit a Post
GET/sites/$site/posts/slug:$post_slug	Return a single Post (by slug)
POST/sites/$site/posts/new	Create a Post
POST/sites/$site/posts/$post_ID/delete	Delete a Post
GET/sites/$site/posts/$post_ID/likes/	List 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	Remove your Like from a Post
GET/sites/$site/posts/$post_ID/likes/mine/	Get your Like status for a Post
GET/sites/$site/posts/$post_ID/reblogs/mine	Get Reblog status for a Post
POST/sites/$site/posts/$post_ID/reblogs/new	Reblog a Post

Comments

View and manage a post's comments

Resource	Description
GET/sites/$site/comments/	Return recent Comments
GET/sites/$site/posts/$post_ID/replies/	Return recent Comments for a Post
GET/sites/$site/comments/$comment_ID	Return a single Comment
POST/sites/$site/comments/$comment_ID	Edit a Comment
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

Taxonomy

Control a site's tags and categories.

Resource	Description
GET/sites/$site/categories/slug:$category	Returns information on a single Category
POST/sites/$site/categories/slug:$category	Edit a Category
GET/sites/$site/tags/slug:$tag	Returns information on a single Tag
POST/sites/$site/tags/slug:$tag	Edit a Tag
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

Follow

Follow and unfollow another blog.

Resource	Description
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 this User

Freshly Pressed

Freshly Pressed posts from the WordPress.com homepage.

Resource	Description
GET/freshly-pressed/	List Freshly Pressed Posts

Tests

Endpoints for testing API calls.

Resource	Description
GET/test/$ID	Test GET requests
POST/test/$ID	Test POST requests