Developers Overview

Choose a section from the menu at the right

Overview

Trip On A Deal provides you with a REST API. Access to the API is free for commercial and non-commercial use within certain usage limits.

All data is accessed through calls to http://api.triponadeal.com. A version identifier is used to distinguish future versions of the API, as in http://api.triponadeal.com/v1. Please set the user header to something appropriate for your application. Other than that no special headers are required.

Status

Our API is in an early beta. Please let us know if you discover any bugs or are missing a feature. You can reach us through support@triponadeal.com .

Authentication

We support the OAuth2 protocol which means that you need a valid key and secret which can be obtained here . This can then be used to obtain an Oauth2 access token.

Format

Our API expects and returns JSON encoded values. We also support the JSONP extension to allow for calls directly from browser clients. To receive a JSONP result add the callback=yourmethodname parameter to your request, like in %code

http://api.triponadeal.com/v1/me?callback=callmeplease

This returns a JSON result packaged in a method call callmeplease({result ...})

Rate Limits

By default we limit you to 2000 calls per day per application and one call every 2 seconds. If you need higher limits, both for commercial and non commercial use, please contact us. Unless you are on one of our paid plans we provide no guarantees about the availability of our service, however we try to keep it running 24x7 and strive for a response time of less than 100ms.

Usage

Please take a look at our terms of service regarding your rights and obligations when using our API. The terms of service always supersede any other documentation. Here is quick roundup for less legally inclined readers:

  • You are allowed to use the API as you see fit, with the exception of creating a competing service.
  • You must not alter any links rendered by the system, especially not if they contain affiliate system parameters.
  • You must include a reference to triponadeal.com on pages that use data from triponadeal.com. Contact us if you need this to be waived or modified.
  • If we provide data received from a third party and you make use of it you have to adhere to their terms of services as well. API request documentation will contain the necessary information.

Write Access

The public API does supports write access (create, update, delete) by default, however certain internal limits apply to prevent abuse.

Caching

Use good judgement when accessing the API. You can cache data for up to 6 months, with the exception of ranking and score data, which can be cached for up to 7 days.