References

References are entities that represent places' relations to other websites, articles, social networks, rental options, passes, tickets, tours, accomodation providers, parkings, transfers and other services. They are included as the references array in the place details and they are explained in depth in the full API specification.

Displaying references

Let's get the detail of the Eiffel Tower:

GET https://alpha-api.sygictraveldata.com/1.0/en/places/poi:530

Now we can focus on the references array in the response. There we should find a link to the Eiffel Tower's official website (type link:official), Facebook page (type link:facebook), Wikipedia article (type wiki) and other sites. Then there are the tours, tickets, passes and other related products from our partners, a Wikivoyage Travel Guide and other data. For details continue to the full API specification.

Reference availability

If you need to check availability of specific tours, tickets or passes for certain dates, you can use the reference availability endpoint.

Let's say we want to check a ticket with the ID 2739588 and a tour with the ID 3940264 for dates between 1st and 5th November 2017 for two people. The request is as follows:

GET https://api.sygictraveldata.com/1.0/en/references-availability?ids=2739588|3940264&date_from=2017-11-01&date_to=2017-11-05&persons=2

We'll get a simple response indicating whether the references are available for the given dates (is_available) along with their price.