AI Engine for WordPress

List posts, pages or another post type, newest first. Returns ID, title, status, excerpt and link for each, without the full content. Filter by post_type, post_status, search text, author (user ID or slug) or a date range. Returns 10 items unless limit is set; page with offset or paged.

Get one post or page by ID: title, content, status, dates and permalink. Set content_format to "prose" to return the text without block markup.

Get everything about one post by ID: all fields, custom fields, terms, featured image and author. Use include or exclude to limit the sections returned.

Count posts by status (published, draft, scheduled, pending, private, trash) for one post type. The default post type is post.

List the public post types on the site with their key and label, such as post, page or product.

Takes no parameters.

Get the custom fields of a post by ID. Pass key to read a single field; without it, all custom fields are returned.

List comments with their post, author, content, date and approval status. Filter by post_id, status, search text, user_id or author_email. Returns 10 unless limit is set. With type set to "note", it lists the editor notes on posts, where an approval status of 1 means the note thread is resolved.

List the taxonomies available for a post type, such as categories and tags.

List the terms of a taxonomy (for example every category), optionally filtered by search text or parent term.

Count the terms in a taxonomy.

List the terms attached to a post, optionally for one taxonomy only.

List items in the Media Library with their ID, title and URL. Filter by search text, uploader or date range. Returns 10 unless limit is set.

Count the items in the Media Library, optionally within a date range.

List the block patterns available on the site (ready-made layouts from WordPress, the theme and plugins), with name, title, categories and description. Filter by search text or category. Set include_content to true to also get each pattern's block markup, which can be placed in a post with Update post or Edit post text.

Create a post, page or item of another post type. post_title is required. post_content accepts HTML, blocks or Markdown. The status is draft unless post_status says otherwise, and the type is post unless post_type says otherwise. meta_input sets custom fields.

Update an existing post by ID: title, content, excerpt, status, slug, date or custom fields. Pass the fields to change in fields and custom fields in meta_input. Set schedule_for to schedule publication. Passing post_category replaces all of the post's categories.

Find and replace text inside one field of a post (for example its content), without sending the whole content again. Supports regular expressions with regex set to true and modifiers in flags.

Write block editor content to an existing post from a list of block specs. Types and fields: paragraph (content), heading (content, level 1-6), list (items, ordered), quote (content, citation), image (url, alt, caption), buttons (buttons: text, url), group (blocks), columns (columns: arrays of blocks), separator, spacer (height), code (content), html (content). mode is replace (default), append or prepend.

Move a post, page or item of another post type to the trash by ID. It can be restored from the trash in WordPress.

Set the featured image of a post to a Media Library item, or remove it when media_id is empty.

Create a term in a taxonomy, such as a new category or tag, with an optional slug, description and parent.

Update the name, slug, description or parent of an existing term.

Attach terms to a post. With append set to true they are added to the existing terms; otherwise they replace all terms of that taxonomy on the post.

Add a file to the Media Library, either from a public URL that WordPress downloads or from base64 content with a filename. Optional title, description and alt text.

Update the title, caption, description or alt text of a Media Library item.

Add a comment to a post. post_id and comment_content are required; author name, email, URL and approval status are optional.

Update a comment by ID: its content or its approval status (approve, hold or mark as spam).

Add an editor note to a block of a post (WordPress 6.9 or later), as shown in the editor's Notes panel. Locate the block with anchor_text (a short exact snippet of its text) or block_index, or reply to an existing note with parent_id.

Edit the text of an editor note, or mark its thread as resolved or reopen it.

Get the site's name, tagline, address and time zone.

Takes no parameters.