Open Data Initiative - API: Overview
OverviewCalls
Objects
Fault
Authentication
API calls for searchCompanyByNameOrDomain and getCompanyById must contain an Authentication Token in the header of the input terms. To obtain an Authentication Token, please register at http://developer.jigsaw.com/member/register
All API calls must be transmitted in HTTPS for security.
Error Handling
If an error occurs during the invocation of a call, the web service returns an ApiFault with an associated ExceptionCode. When the call is properly formatted and processed, but the result of the operation is an erroneous result, the result has an ErrorCode.
Request Metering
The number of API calls per Token are limited as follows:
- 5,000 calls per day
- 1 query per second
WSDL URL
Jigsaw publishes its API through Web Services Description Language (WSDL), which can be used to construct SOAP requests. The Jigsaw WSDL can be accessed at the following URL:
http://www.jigsaw.com/api/services/CompanyService?wsdl
Sample code
A sample file that calls the Jigsaw API can be downloaded by clicking here. This code is a sample Java client application that uses the Apache Axis SOAP client