API Documentation

API Key

​​Every API call must include a unique API Key, as in the following examples.

Sign up and get started.

Template

http://api.v1.trippinin.com/match/[place name]?coordinates=[lat,lng]&KEY=[your API key]

Example

 

 

​http://api.v1.trippinin.com/match/Hard Rock Cafe Barcelona?coordinates=41.38605,2.1700&KEY=298jkefwhfjwe82323h

* When the API key is the request’s first parameter, the [&] should be replaced with a [?].

TRY THE API NOW

Choosing the right API call

 

We've assembeled a bounch of API calls that should answer most [if not all] of your needs.

  • LBS DATA
    .../GeoSearch/[coordinates]/[Main Category]?day=[weekday]&time=[time]&limit=[limit]&radius=[radius]&offset=[offset]
    To be used when you want to know what's Trippin' around an exact location.
    Provide with coordinates (Lat/Lng) and get a list of the most recommended places. This can filtered by radius category, day and time.
    Then use the  READ   API call and get all information for each place .
     

  • CITY DATA
    .../City/[City Name]/[main category]/[Weekday]/[Time]?Limit=[Limit]&Offset=[Offset]
    To be used when you want to know what's Trippin' in a specific city.
    Provide with a city mane and get basic information about recommended places. This can be filtered by category, day and time.
    Then use the   READ   API call and get all information for each place.
     

  • RESOLVE
    .../resolve/[place name]?coordinates=[lat,lng]
    To be used when having your own listing and wanting to add amazing complementary insights as added value.

    Provide with the place's name and coordinates (Lat/Lng) and get its rating, activity graph, social stats, Instagram feed, and more.

    *The  RESOLVE  API call does both  MATCH  and  READ  at once. 

    It's easier to implement but not as "server friendly" for the long term.

     


  • MATCH
    .../match/[place name]?coordinates=[lat,lng]
    Use the MATCH plus the READ API calls when wanting to add amazing complementary insights as added value.
    MATCH  your own specific point of interest to ours (only once!) by providig a name and coordinates (Lat/Lng), get its ID and  READ  it again and again for full and up to date information.
     

  • READ
    .../place/[trippininid]
    To be used when wanting to get all available info and insights about a place.
    Provide with the place's ID (Trippinin_ID) and get its rating, activity graph, social stats, Instagram feed, and more.
     

  • CITY LIST
    .../citylist?key=[API Key]
    To be used when wanting to know which cities we support and how many points of interest we currently have for each of them.
    Please note that we're expanding our coverage within cities and to new cities at all times, and if your places of interest aren't covered, contact us .
     

  • PLACE SEARCH
    .../PlaceSearch/[City Name]?q=[Search term]&offset=0&key=[API Key]
    To be used when wanting to search a specific place by its name, in a certain city.
    Provide with a city name and a place name as a search term and get a list of places as results for your query.
     

TRY THE API NOW