WordPress.com API integration with managed OAuth. Manage posts, pages, sites, and content. Use this skill when users want to create, read, update, or delete WordPress.com posts, pages, or manage site
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access the WordPress.com REST API with managed OAuth authentication. Create and manage posts, pages, and site content on WordPress.com hosted sites.
# List posts from a site python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/wordpress/rest/v1.1/sites/{site_id}/posts?number=10') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/wordpress/rest/v1.1/{endpoint}
The gateway proxies requests to
public-api.wordpress.comNote: WordPress.com uses the REST v1.1 API. Site-specific endpoints use the pattern
/sites/{site_id_or_domain}/{resource}All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as
MATON_API_KEYexport MATON_API_KEY="YOUR_API_KEY"
Manage your WordPress.com OAuth connections at
https://ctrl.maton.aipython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=wordpress&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'wordpress'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
{ "connection": { "connection_id": "fb327990-1a43-4325-9c15-bad771b6a288", "status": "ACTIVE", "creation_time": "2026-02-10T07:46:26.908898Z", "last_updated_time": "2026-02-10T07:49:33.440422Z", "url": "https://connect.maton.ai/?session_token=...", "app": "wordpress", "metadata": {} } }
Open the returned
urlpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple WordPress.com connections, specify which one to use with the
Maton-Connectionpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/wordpress/rest/v1.1/sites/{site_id}/posts') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', 'fb327990-1a43-4325-9c15-bad771b6a288') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
GET /wordpress/rest/v1.1/sites/{site_id_or_domain}
Response:
{ "ID": 252505333, "name": "My Blog", "description": "Just another WordPress.com site", "URL": "https://myblog.wordpress.com", "capabilities": { "edit_pages": true, "edit_posts": true, "edit_others_posts": true, "delete_posts": true } }
The site identifier can be either:
252505333myblog.wordpress.comen.blog.wordpress.comGET /wordpress/rest/v1.1/sites/{site}/posts
Query Parameters:
numberoffsetpagepage_handlemeta.next_pageorderDESCASCorder_bydatemodifiedtitlecomment_countIDstatuspublishdraftpendingprivatefuturetrashanytypepostpageanysearchcategorytagauthorfieldsResponse:
{ "found": 150, "posts": [ { "ID": 83587, "site_ID": 3584907, "author": { "ID": 257479511, "login": "username", "name": "John Doe" }, "date": "2026-02-09T15:00:00+00:00", "modified": "2026-02-09T16:30:00+00:00", "title": "My Post Title", "excerpt": "<p>Post excerpt...</p>", "content": "<p>Full post content...</p>", "slug": "my-post-title", "status": "publish", "type": "post", "categories": {...}, "tags": {...} } ], "meta": { "next_page": "value=2026-02-09T15%3A00%3A00%2B00%3A00&id=83587" } }
GET /wordpress/rest/v1.1/sites/{site}/posts/{post_id}
Response:
{ "ID": 83587, "site_ID": 3584907, "author": {...}, "date": "2026-02-09T15:00:00+00:00", "title": "My Post Title", "content": "<p>Full post content...</p>", "slug": "my-post-title", "status": "publish", "type": "post", "categories": { "news": { "ID": 123, "name": "News", "slug": "news" } }, "tags": { "featured": { "ID": 456, "name": "Featured", "slug": "featured" } } }
POST /wordpress/rest/v1.1/sites/{site}/posts/new Content-Type: application/json{ "title": "New Post Title", "content": "<p>Post content here...</p>", "status": "draft", "categories": "news, updates", "tags": "featured, important" }
Parameters:
titlecontentexcerptstatuspublishdraftpendingprivatefuturedatecategoriestagsformatstandardasidechatgallerylinkimagequotestatusvideoaudioslugfeatured_imagestickypasswordResponse:
{ "ID": 123, "site_ID": 252505333, "title": "New Post Title", "status": "draft", "date": "2026-02-10T09:50:35+00:00" }
POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id} Content-Type: application/json{ "title": "Updated Title", "content": "<p>Updated content...</p>" }
Uses the same parameters as Create Post.
POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/delete
Moves post to trash. Returns the deleted post with
status: "trash"Pages use the same endpoints as posts with
type=pageGET /wordpress/rest/v1.1/sites/{site}/posts?type=page
POST /wordpress/rest/v1.1/sites/{site}/posts/new?type=page Content-Type: application/json{ "title": "About Us", "content": "<p>About page content...</p>", "status": "publish" }
GET /wordpress/rest/v1.1/sites/{site}/dropdown-pages/
Returns a simplified list of pages for dropdowns/menus.
GET /wordpress/rest/v1.1/sites/{site}/page-templates
Returns available page templates for the site's theme.
GET /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/likes
Response:
{ "found": 99, "i_like": false, "can_like": true, "site_ID": 3584907, "post_ID": 83587, "likes": [...] }
POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/likes/new
POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/likes/mine/delete
GET /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/reblogs/mine
Response:
{ "can_reblog": true, "can_user_reblog": true, "is_reblogged": false }
GET /wordpress/rest/v1.1/sites/{site}/post-types
Response:
{ "found": 3, "post_types": { "post": { "name": "post", "label": "Posts", "labels": {...} }, "page": { "name": "page", "label": "Pages", "labels": {...} } } }
GET /wordpress/rest/v1.1/sites/{site}/post-counts/{post_type}
Example:
/sites/{site}/post-counts/post/sites/{site}/post-counts/pageResponse:
{ "counts": { "all": {"count": 150}, "publish": {"count": 120}, "draft": {"count": 25}, "trash": {"count": 5} } }
GET /wordpress/rest/v1.1/sites/{site}/users
Response:
{ "found": 3, "users": [ { "ID": 277004271, "login": "username", "name": "John Doe", "email": "john@example.com", "roles": ["administrator"] } ] }
GET /wordpress/rest/v1.1/me/settings
Response:
{ "enable_translator": true, "surprise_me": false, "holidaysnow": false, "user_login": "username" }
POST /wordpress/rest/v1.1/me/settings/ Content-Type: application/json{ "enable_translator": false }
GET /wordpress/rest/v1.1/me/likes
Response:
{ "found": 10, "likes": [ { "ID": 83587, "site_ID": 3584907, "title": "Liked Post Title" } ] }
GET /wordpress/rest/v1.1/sites/{site}/embeds
Returns available embed handlers for the site.
GET /wordpress/rest/v1.1/sites/{site}/shortcodes
Returns shortcodes available on the site.
WordPress.com uses cursor-based pagination with
page_handleimport os import requestsheaders = { 'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}' }
Initial request
response = requests.get( 'https://gateway.maton.ai/wordpress/rest/v1.1/sites/{site}/posts', headers=headers, params={'number': 20} ) result = response.json() all_posts = result['posts']
Continue with page_handle
while result.get('meta', {}).get('next_page'): response = requests.get( 'https://gateway.maton.ai/wordpress/rest/v1.1/sites/{site}/posts', headers=headers, params={'number': 20, 'page_handle': result['meta']['next_page']} ) result = response.json() all_posts.extend(result['posts'])
print(f"Total posts: {len(all_posts)}")
Alternatively, use
offsetGET /wordpress/rest/v1.1/sites/{site}/posts?number=20&offset=20
const response = await fetch( 'https://gateway.maton.ai/wordpress/rest/v1.1/sites/{site}/posts?number=10', { headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}` } } ); const data = await response.json(); console.log(`Found ${data.found} posts`);
import os import requestsresponse = requests.get( 'https://gateway.maton.ai/wordpress/rest/v1.1/sites/{site}/posts', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}, params={'number': 10, 'status': 'publish'} ) data = response.json() print(f"Found {data['found']} posts")
import os import requestsresponse = requests.post( 'https://gateway.maton.ai/wordpress/rest/v1.1/sites/{site}/posts/new', headers={ 'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}', 'Content-Type': 'application/json' }, json={ 'title': 'My New Post', 'content': '<p>Hello World!</p>', 'status': 'draft', 'categories': 'news', 'tags': 'hello, first-post' } ) post = response.json() print(f"Created post ID: {post['ID']}")
/posts/{id}/posts/{id}/deletejq$MATON_API_KEY| Status | Meaning |
|---|---|
| 400 | Missing WordPress connection or bad request |
| 401 | Invalid or missing Maton API key |
| 403 | Insufficient permissions or OAuth scope |
| 404 | Site or resource not found |
| 429 | Rate limited |
| 4xx/5xx | Passthrough error from WordPress.com API |
Error responses include details:
{ "error": "unauthorized", "message": "User cannot view users for specified site" }
MATON_API_KEYecho $MATON_API_KEY
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
wordpresshttps://gateway.maton.ai/wordpress/rest/v1.1/sites/{site_id}/postshttps://gateway.maton.ai/rest/v1.1/sites/{site_id}/postsNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.