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.

Requirements

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.

Endpoint

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

GET https://example.com/wp-json/contextual-related-posts/v1/posts/<id>/

Arguments

ParameterDescription
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