How to use TripSay API

An example how tips are
displayed in TripSay.
Click picture to zoom.

Step 1 - API KEY

You need a valid API key in order to use TripSay API. If you should have one but you have lost it, you can request a new one by sending email to info@tripsay.com. In this example we use API key "TEST" to perform all queries. Replace TEST with you own API key when developing your own client.

Step 2 - Unique name of your place

Let's say you want tips from Paris. But from which Paris? Paris in Texas, Paris in Idaho, Paris in Maine or even Paris in France? In order to query tips from a location you have to find the unique name of that place which is simply a unique string which we have attached to every place. The unique name will never change, so you have to do this step only once for every location you are interested in.

Query the unique names by entering a name of a place (or part of it) - you can try it here:
Name of the place you're interested in:
Maximum number of results (default is 5):

Your query URL with the above parameters is:
http://www.tripsay.com/api/json/uniqueNames?api_key=TEST&query=&maxResults=
Click the URL to see what kind of result you get with the above parameters!

Step 3 - Tip query

Now that you know the unique name of the location of your interest (for example "Paris,Île-de-France,France" for the Paris), it's easy to query the required amount of tips from that location:

Unique name obtained from previous query:
Maximum number of results (default is 5):

Your query URL with the above parameters is:
http://www.tripsay.com/api/json/tips/?api_key=TEST&maxResults=
Click the URL to see what kind of result you get with the above parameters!

Step 4 - That's it!

Easy, isn't it?
If you need further assistance, don't hesitate to contact us at info@tripsay.com !