Since v3.1.0, Contextual Related Posts has included support for viewing the related posts via the WordPress REST API.

The plugin registers one namespace i.e. contextual-related-posts/v1 that can be used to retrieve the related posts for a particular post ID.


To use the latest version of the REST API you must be using:

  • Contextual Related Posts 3.1+.
  • WordPress 4.4+.
  • Pretty permalinks in Settings > Permalinks so that the custom endpoints are supported. Default permalinks will not work.
  • You may access the API over either HTTP or HTTPS, but HTTPS is recommended where possible.


The plugin registers one namespace contextual-related-posts/v1 and currently, there is a single endpoint available at posts.



idPost ID. This is also passed as part of the path as noted above. This is mandatory
limitNumber of posts to retrieve. You can also use posts_per_page instead
post_typesComma-separated list of post types to which the related posts belong to. Alternatively use post_type
same_post_typeOnly retrieve posts from the same post type as that of the post with the id as above
same_authorOnly retrieve posts from the same author as that of the post with the id as above
exclude_post_idsComma-separated list of post IDs to exclude
exclude_categoriesComma-separated list of Taxonomy IDs from which posts are excluded