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

GET /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

Was this article helpful?

Have more questions? Submit a request