As of version 4.7 of WordPress the REST API plugin merged into the core. I notice the following major changes:

  1. filter[key] = value not working anymore.
  2. ?taxonomy = slug not working. Works only by id.
  3. rest_query_vars is no longer a filter.

Is there any other major changes ? How you can register rest query vars with the new updates? Can you query by slug and not by id?

  • Sad to witness the continued self-destruction of WP with the maniacal rush to this immature API. Sorry to be of no help on this; I'm sticking with 4.6 for the foreseeable future.
    – C C
    Feb 24, 2017 at 14:16
  • Thanks! I will stick for the moment also to 4.6 but at some point we have to move on :)
    – Laxmana
    Feb 24, 2017 at 15:17

1 Answer 1


As of WordPress 4.7 now we have the following filter to hook to:

$args = apply_filters( "rest_{$this->post_type}_query", $args, $request );

So if you would like to perform a request like:




you can do it through the following piece of code (within your functions.php):

 * This function will allow custom parameters within API request URL.
 * @link    https://codex.wordpress.org/Class_Reference/WP_Query
 * @see     Wp-includes/Rest-api/Endpoints/Class-wp-rest-posts-controller.php
 * @param   array   $args       Contains by default pre written params.
 * @param   array   $request    Contains params values passed through URL request.
 * @return  array   $args       New array with added custom params and its values.
public function posts_allow_custom_request_params( $args, $request ) {

    $args += array(
        'meta_key' => $request['meta_key'],
        'meta_value' => $request['meta_value'],
        'meta_query' => $request['meta_query'],

    return $args;


add_filter( 'rest_post_query', 'posts_allow_custom_request_params', 99, 2 );

Note that I'm supposing you are requesting posts from the post type 'post'.

You can add as many parameters as you want provided that your array indexes match the correct parameters accepted by WP_Query class. And if you look through my comments along the code you might find something useful to look into.

By the way here are some parameters you have by default that you can use within your query string:

'author'            => 'author__in',
'author_exclude'    => 'author__not_in',
'exclude'           => 'post__not_in',
'include'           => 'post__in',
'menu_order'        => 'menu_order',
'offset'            => 'offset',
'order'             => 'order',
'orderby'           => 'orderby',
'page'              => 'paged',
'parent'            => 'post_parent__in',
'parent_exclude'    => 'post_parent__not_in',
'search'            => 's',
'slug'              => 'post_name__in',
'status'            => 'post_status',
'per_page'          => 'posts_per_page',

Considering the WP_Query class, 'page' is equivalent to 'paged', 'status' is equivalent to 'post_status', so on...

Using the above parameters we'd end up with something like:


Hope this helps. And be optimistic believing that if they did it it's for the best, always!

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.