WP Headless REST API Documentation

Endpoint Reference, Auth Setup, and Integration Examples

Namespace `rest-api-pro/v1` · Plugin reference v3.0

REST endpoints for headless WordPress content, taxonomies, menus, search, media, and authenticated CRUD workflows.

Enter home URL or full API base. If needed, `/wp-json/rest-api-pro/v1` is appended automatically.

Filter endpoint cards in real time.

Authentication and Usage

Protected routes require either Application Password (Basic auth) or API key (Bearer). Public read routes can be used without authentication unless your site adds restrictions.

cURL Bearer example
curl -X POST "https://yoursite.com/wp-json/rest-api-pro/v1/create-post/" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"title":"Hello","status":"draft"}'

Endpoint Reference

GETPublic
https://yoursite.com/wp-json/rest-api-pro/v1/health/

Health

Returns plugin and WordPress health details, namespace, and capability flags.

GETPublic
https://yoursite.com/wp-json/rest-api-pro/v1/site/

Site Identity

Returns site title, tagline, home URL, timezone, language, logo, and icon.

GETPublic
https://yoursite.com/wp-json/rest-api-pro/v1/category-posts/?per_page=10&page=1&orderby=date&order=desc

Posts List

Paginated post list with optional category, status, and post_type filters.

GETPublic
https://yoursite.com/wp-json/rest-api-pro/v1/search/?search=keyword&post_type=post,page&per_page=10&page=1

Search

Search published content by keyword across one or many post types.

GETPublic
https://yoursite.com/wp-json/rest-api-pro/v1/post/?slug=sample-post

Single Post

Fetches a single post/CPT by id or slug with SEO and adjacent metadata when available.

GETPublic
https://yoursite.com/wp-json/rest-api-pro/v1/page/?slug=sample-page

Single Page

Fetches a single page by id or slug.

GETPublic
https://yoursite.com/wp-json/rest-api-pro/v1/menu/?location=primary

Menu by Location

Returns nested menu tree by registered WordPress menu location.

POSTAuth required
https://yoursite.com/wp-json/rest-api-pro/v1/create-post/

Create Post

Creates a post using title/content/status/taxonomy/meta payload fields.

PUTAuth required
https://yoursite.com/wp-json/rest-api-pro/v1/update-post/1

Update Post

Updates an existing post with partial payload fields from create endpoint.

DELETEAuth required
https://yoursite.com/wp-json/rest-api-pro/v1/delete-post/1?force=false

Delete Post

Trashes or permanently deletes a post based on force query.

POSTAuth required
https://yoursite.com/wp-json/rest-api-pro/v1/media/

Media Upload

Uploads media using multipart form-data with file field and returns attachment details.