Overview

OpenDover API is exposed to the public as SOAP-based web service and RESTful web service with JSON and XML response. SOAP Web Service definition file can be downloaded here:

WSDL: opendover_api_v1_soap.wsdl

Use URL below to make API calls to SOAP-based service:

Endpoint URL: http://api.opendover.nl/api_v1/soap

RESTful Web Service Endpoint URLs are the following

JSON: http://api.opendover.nl/rest/v1/json/<method_name>?apiKey=<your_api_key>

XML: http://api.opendover.nl/rest/v1/xml/<method_name>?apiKey=<your_api_key>

OpenDover API  Web Service exposes the following methods. The names in brakets are for RESTful Web Service.

• searchSentiments (search_sentiments)
• searchBareSentiments (search_bare_sentiments)
• detectSubjectDomain (detect_subject_domain)
• getAvailableSubjectDomains (get_available_subject_domains)
• getSubjectDomainByCode (get_subject_domain_by_code)

The search methods (searchSentiment and searchBareSentiments)  are the primary methods of the API. These methods search for sentiments in a given text. They accept at least two parameters. The first one is your API key. The second one is a text to process. The methods return sentiments found. In addition to sentiments some of these methods also return the list of subject domains a given text is related to.

detectSubjectDomain method calculates a list of subject domains for a given text. The result consists of domains which are currently supported by OpenDover. Some of sentiment search methods perform subject domain detection as well. So detectSubjectDomain can be considered as auxiliary method.

getAvailableSubjectDomains method returns the complete list of subject domains which are currently supported by OpenDover. getSubjectDomainByCode returns the code and name of a subject domain.

You can try making calls to RESTful OpenDover Web Service using this simple html-based example.

An example of Java client for RESTful OpenDover Web Service can be found here.