Filtering opinions in the API
Query structure
Data returned by the API can be filtered in the same way as stories returned in the web site search.
All the filters (search terms) available to a web site user are also available to an API consumer. In addition, the uri representing a web site search can be reused as an API search with minimal change.
For example, the uri for a search for stories tagged with "diabetes" is:
https://www.careopinion.org.uk/opinions?tag=diabetes
If you are using HTTP header authentication, then the uri for an API call to access the same set of stories is:
https://www.careopinion.org.uk/api/v2/opinions?tag=diabetes
If you require a complex search, you can create it first using the web site search, and then reuse it in an API call.
Available uri query parameters
There is a wide range of filtering parameteres (search terms) available. Many of them are documented in our help pages for search.
Please note that all incoming/outgoing datetime values will be in UTC.
Last updated 14/01/2021