Files
openclaw-workspace/skills/api-gateway/references/wordpress.md
2026-04-11 09:45:12 -05:00

3.2 KiB

WordPress.com Routing Reference

App name: wordpress Base URL proxied: public-api.wordpress.com

API Path Pattern

/wordpress/rest/v1.1/{endpoint}

Important: WordPress.com uses REST API v1.1. Site-specific endpoints use /sites/{site_id_or_domain}/{resource}.

Site Identifiers

Sites can be identified by:

  • Numeric site ID (e.g., 252505333)
  • Domain name (e.g., myblog.wordpress.com)

Common Endpoints

Sites

Get Site Information

GET /wordpress/rest/v1.1/sites/{site}

Posts

List Posts

GET /wordpress/rest/v1.1/sites/{site}/posts

Query parameters: number, offset, page_handle, status, search, category, tag, author

Get Post

GET /wordpress/rest/v1.1/sites/{site}/posts/{post_id}

Create Post

POST /wordpress/rest/v1.1/sites/{site}/posts/new
Content-Type: application/json

{
  "title": "Post Title",
  "content": "<p>Post content...</p>",
  "status": "draft",
  "categories": "news",
  "tags": "featured"
}

Update Post

POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}
Content-Type: application/json

{
  "title": "Updated Title",
  "content": "<p>Updated content...</p>"
}

Delete Post

POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/delete

Pages

List Pages

GET /wordpress/rest/v1.1/sites/{site}/posts?type=page

Create Page

POST /wordpress/rest/v1.1/sites/{site}/posts/new?type=page
Content-Type: application/json

{
  "title": "Page Title",
  "content": "<p>Page content...</p>",
  "status": "publish"
}

Post Likes

Get Post Likes

GET /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/likes

Like Post

POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/likes/new

Users

List Site Users

GET /wordpress/rest/v1.1/sites/{site}/users

User Settings

Get My Settings

GET /wordpress/rest/v1.1/me/settings

Update My Settings

POST /wordpress/rest/v1.1/me/settings/
Content-Type: application/json

{
  "enable_translator": false
}

Post Types

List Post Types

GET /wordpress/rest/v1.1/sites/{site}/post-types

Post Counts

Get Post Counts

GET /wordpress/rest/v1.1/sites/{site}/post-counts/{post_type}

Pagination

WordPress.com uses cursor-based pagination with page_handle:

GET /wordpress/rest/v1.1/sites/{site}/posts?number=20
# Response includes "meta": {"next_page": "..."}

GET /wordpress/rest/v1.1/sites/{site}/posts?number=20&page_handle={next_page}

Alternatively, use offset for simple pagination.

Notes

  • API version is v1.1 (not v2)
  • POST is used for updates (not PUT/PATCH)
  • POST to /delete endpoint is used for deletes (not HTTP DELETE)
  • Categories and tags are created automatically when referenced in posts
  • Content is HTML-formatted
  • Date/time values are in ISO 8601 format

Resources