The Sedo API enables you to access the Sedo database from your own applications. For example, you can download your domain parking statistics and easily import them into your own analysis program / tools. You can also manage your Sedo domain portfolio and search the Sedo database for domains for sale.
Sedo uses the SOAP and WSDL standards in order to allow an implementation in your favorite environment e.g. Java, Perl, PHP or .NET.
The Sedo API is currently in the beta test phase. Nevertheless, all functions available to you in this version of the API have been thoroughly tested and will remain in their current form in future. This ensures that your programs will continue to be compatible with future versions of the API.
We welcome your feedback, any suggestions you may have for further functions that we could include in the API, or information about any bugs you may find in the API at email@example.com.
The following functions are currently available in the Sedo API:
The Sedo interface is accessible through the Simple Object Access Protocol (SOAP) which you can use to make Remote Procedure Calls (RPC). A description of the Sedo interface can be found at the following URL:
The corresponding WSDL file can be found at:
For most functions, the documentation contains examples including both PHP and Java source code.
You can find further links on working with SOAP and WSDL at the end of the introduction.
The client sends a request for a specified function to the API. Before this can be done, however, the transferred data must be converted into the correct format. All data sent has to be UTF-8 encoded.
Müller should be transferred to the
IDN domains (domains with special characters) should be transferred in Punycode format.
sedoköln.com should be transferred to the
Depending on the requested function, the interface will send back various types of values. The types of value returned by the interface are described in the documentation for each function.
The interface returns data in the following format:
If you work with UTF-8 on your system or if you don't send us any strings with special characters, you do not have to decode the data we send you. In all other cases, you will need to convert the data we send you into the encoding used by your system (e.g. ISO-8859-1) before you can process it further.
If the parameters sent with a request do not correspond to the function's specifications, the interface delivers an error message as an array. The fields of the array are always the same and contain the following information:
SOAP is a protocol for exchange of information. Communication in SOAP is based on transferring messages written in XML. The SOAP message is sent from a SOAP client to a SOAP server by means of various protocols (e.g. HTTP). The XML message makes it possible for different operating systems with different programming languages and technologies to exchange messages with each other.
Information and sources on SOAP:
The documentation contains examples in both PHP and Java for each function on offer.
For the PHP examples, we used the nusoap.php class ( Sourceforge Project Site ).
For the Java examples, we created Stub classes from the WSDL file and used this off line. We used the Apache Axis library ( http://ws.apache.org/axis/ ) to create the Stub classes.
In order to use nusoap with PHP5 you require version: 0.7.3.
With this version, there has been a important change to the programming of a client. In the documents we give examples in PHP with the line:
$client = new soapclient('https://api.sedo.com/api/sedointerface.php');
With PHP 5 this call will produce an error. In order to avoid this error occurring, this line should be changed as follows:
$client = new nusoap_client('https://api.sedo.com/api/sedointerface.php');
In version 5, PHP has integrated an internal module. So that a client can be created, the following changes should be taken into account:
$client = new SoapClient( NULL, array( 'location' => "https://api.sedo.com/api/sedointerface.php", 'soap_version' => SOAP_1_1, 'encoding' => 'UTF-8', 'uri' => 'urn:SedoInterface', 'style' => SOAP_RPC, 'use' => SOAP_ENCODED ) );