Surprise.me affiliate program API
This document contains a list of API methods that are available when working with Surprise.me.
The API allows you to get data about Surprise.me quest tours, languages of quest tours and currently available cities on the website.
Request URL and response format
All requests are sent to https://app.surprizeme.ru/api with the addition of the endpoint.
Response format: Content-Type: application/json; charset=utf-8.
Information requests
List of languages
GET /languages
Request example
https://app.surprizeme.ru/api/languages
Response example
{
"data": [
{
"id": 1,
"name": "Russian",
"code": "ru"
},
{
"id": 2,
"name": "English",
"code": "en"
},
{
"id": 5,
"name": "Spanish",
"code": "es"
}
]
}
List of cities
Request parameters
- lang — specifies the response language (name, description). The value of the code field from the GET /languages/ query is used.
Request example
https://app.surprizeme.ru/api/cities/?lang=en
Response example
{
"data": [
{
"id": 1,
"name": "Saint Petersburg",
"slug": "saint-petersburg",
"bg_image": "https://app.surprizeme.ru/media/world/Saint_Petersburg_Surprise_Me.jpg",
"preview_image": "https://app.surprizeme.ru/media/CACHE/images/world/Saint_Petersburg_Surprise_Me/a3ca495104075ec257b05fc2814fec47.jpg",
"country": {
"name": "Russia",
"code": "RU"
},
"meta_title": "",
"meta_description": "",
"description": "<h2>Northern capital</h2>\r\n\r\n The northern capital is rich in architectural beauties and historical places, where every stone keeps a memory of great people and events. St. Petersburg is a symbol of the imperial power of Russia, the center of three revolutions, survived floods, fires and blockade and did not lose its charm after so many hardships. \r\n\r\n Great streets were walking along these streets ",
"cover_position": 60,
"items_count": 3
}
]
}
City search
Specify three symbols of the city name or more in the request parameter.
GET /search/
Request parameters
- lang — specifies the response language (name). Use the value of the code field from the GET /languages/ request.
Request example
https://app.surprizeme.ru/api/collections/?lang=en
Response example
{
"data": [
{
"name": "Moscow",
"language_code": "en",
"city": {
"id": 524901,
"slug": "moscow"
},
"region": {
"name": "Moscow",
"code": "48"
},
"country": {
"name": "Russia",
"code": "RU"
}
}
]
}
City collections
GET /collections/
Request parameters
- city — city name from the request List of cities.
Request example
https://app.surprizeme.ru/api/collections/?city=barcelona
Response example
{
"data": [
{
"category": {
"title": "Sightseeing",
"slug": "review"
},
"description": "<h2>Обзорные экскурсии в столице.</h2>",
"preview_image": "https://app.surprizeme.ru/media/CACHE/images/world/%D0%BC%D0%BE%D1%81%D0%BA%D0%B2%D0%B0_%D0%BE%D0%B1%D0%B7%D0%BE%D1%80%D0%BD%D1%8B%D0%B5_%D1%8D%D0%BA%D1%81%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B8/78e190c515cb99bb1a20666f06574375.jpg",
"city": {
"id": 2,
"name": "Moscow",
"slug": "moscow",
"country": {
"name": "Russia",
"code": "RU"
},
"bg_image": "https://app.surprizeme.ru/media/world/%D0%BC%D0%BE%D1%81%D0%BA%D0%B2%D0%B0_%D0%BE%D0%B1%D0%B7%D0%BE%D1%80%D0%BD%D1%8B%D0%B5_%D1%8D%D0%BA%D1%81%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B8_Uy4lqzE_BUEee4w.jpg",
"preview_image": "https://app.surprizeme.ru/media/CACHE/images/world/%D0%BC%D0%BE%D1%81%D0%BA%D0%B2%D0%B0_%D0%BE%D0%B1%D0%B7%D0%BE%D1%80%D0%BD%D1%8B%D0%B5_%D1%8D%D0%BA%D1%81%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B8_Uy4lqzE_BUEee4w/d20b67564e46e506e966b4d89f3901aa.jpg"
},
"items_count": 0,
"items": []
}
]
}
Products
GET /products/?city=barcelona&lang=en
Request parameters
- lang — the response language. Use the value of the code field from the GET /languages/ request
- city — unique identifier of the city. Use the value of slug field from GET /search/ or GET /cities/ requests.
Request example
https://app.surprizeme.ru/api/products/?city=barcelona&lang=en
Response example
{
"data":[
{
"id":646,
"name":"The Dali Museum in Figueres",
"hidden":false,
"caption":"The Dalí Theatre and Museum is a museum of the artist Salvador Dalí in his home town of Figueres, in Catalonia, Spain. Dalí is buried there in a crypt below the stage. Immerse yourself in an exciting journey through the world of the genius of surrealism. Reveal the meaning of his ambiguous creations and learn the history of the artist's life. Enjoy the unique world of Dali in this excursion.\r\n\r\nIMPORTANT: Tickets to the Dali Theatre and Museum aren't included in this tour, but we can provide them additionally if you ask in advance.",
"short_caption":"Discover the Dalí Theatre and Museum, reveal the meaning of his ambiguous creations and learn the history of the artist's life",
"attractions":"— Discover The Rainy Taxi installation\r\n— Visit The Mae West Face Room\r\n— See The Galatea Tower\r\n— Find such famous objects as Port Alguer, The Spectre of Sex-appeal, Soft self-portrait with grilled bacon, Basket of Bread and others",
"distance":"2 km",
"complexity":"easy",
"locale":{
"id":2,
"name":"English",
"code":"en"
},
"city":{
"id":15,
"name":"Barcelona",
"slug":"barcelona",
"country":{
"name":"Spain",
"code":"ES"
},
"bg_image":"https://app.surprizeme.ru/media/world/%D0%91%D0%B0%D1%80%D1%81%D0%B5%D0%BB%D0%BE%D0%BD%D0%B0_%D1%8D%D0%BA%D1%81%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B8.jpg",
"preview_image":"https://app.surprizeme.ru/media/CACHE/images/world/%D0%91%D0%B0%D1%80%D1%81%D0%B5%D0%BB%D0%BE%D0%BD%D0%B0_%D1%8D%D0%BA%D1%81%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B8/a7679db867b40c53ec2f32da303303f6.jpg"
},
"start_location":"The area in front of The Dalí Museum in Figueres.",
"location_geo":{
"type":"Point",
"coordinates":[
2.9588413238525395,
42.26829425831263
]
},
"duration":"2 – 3 hours",
"price":"17",
"discount":0,
"price_mobile":{
"itunes_id":"45",
"google_id":"45",
"price":"1290"
},
"exprice":null,
"bg_image":"https://app.surprizeme.ru/media/store/figueres-oleguer_s3k6yOZ.jpg",
"preview_image":"https://app.surprizeme.ru/media/CACHE/images/store/figueres-oleguer_s3k6yOZ/6e235762abe9235418279f32490fa066.jpg",
"currency":{
"id":2,
"rate":0.0109902912,
"code":"EUR",
"symbol":"€"
},
"access_codes":[
],
"slug":"the-dal-museum-in-figueres",
"rating":null,
"types":{
"audioguide":true,
"ar":true
},
"author":{
"avatar":"",
"name":"Aleh",
"first_name":"Aleh",
"bio":"I am a lover of Catalan province. Mountains, bays, medieval villages, good food, mysterious legends and stuff like this.",
"nickname":"id25081",
"rating":null,
"reviews_count":0,
"cities":[
{
"id":15,
"name":"Barcelona",
"slug":"barcelona",
"country":{
"name":"Spain",
"code":"ES"
},
"bg_image":"https://app.surprizeme.ru/media/world/%D0%91%D0%B0%D1%80%D1%81%D0%B5%D0%BB%D0%BE%D0%BD%D0%B0_%D1%8D%D0%BA%D1%81%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B8.jpg",
"preview_image":"https://app.surprizeme.ru/media/CACHE/images/world/%D0%91%D0%B0%D1%80%D1%81%D0%B5%D0%BB%D0%BE%D0%BD%D0%B0_%D1%8D%D0%BA%D1%81%D0%BA%D1%83%D1%80%D1%81%D0%B8%D0%B8/a7679db867b40c53ec2f32da303303f6.jpg"
}
],
"locales":[
{
"id":2,
"name":"English",
"code":"en"
}
],
"participants":10,
"initial_city":null,
"initial_tour_title":"",
"initial_tour_description":"",
"initial_tour_language":null
},
"reviews":[
],
"reviews_count":0,
"images":[
{
"id":1689,
"preview":"https://app.surprizeme.ru/media/CACHE/images/store/646/figueres-oleguer/d577fef43a3683ae176f68aaa770c5b8.jpg",
"full":"https://app.surprizeme.ru/media/store/646/figueres-oleguer.jpg"
}
],
"location":"['private', 'store']",
"bounding_circle":null,
"city_slug":"barcelona",
"collection_slug":"popular",
"cover_position":70,
"status":"approved",
"meta_title":"",
"meta_description":"",
"is_favorite":false,
"is_online":false,
"content_types":{
"image":true,
"video":false,
"audio":true,
"streetview":false
}
}
]
}
Link creation
To create affiliate links to the quest tours, you will need the field values:
- locale.code — the country code from the request Products
- city.slug — the name of the city from the request Products
- category.slug — the name of the category from the request City collection
- slug — unique identifier of the excursion from the request for the Products.
Create a link of the view:
https://surprizeme.ru/<locale.code>/<city.slug>/<categor.slug>/<slug>/?sub_id=<sub_id>.
where sub_id is your affiliate marker in Travelpayouts.
An example for the "The Basilica of the Sagrada Família":
https://surprizeme.ru/en/barcelona/popular/the-basilika-of-the-sagrada-famlia/?sub_id=78606