Skip to content

▪ Contact Info

Pricing Tier Licence Type

Contact Info API returns basic and contact information for a Point of Interest.

Request

Endpoint

GET /v4/{billing_plan}/account/{account_id}/poi/{poi_id}/data/contact

Path Parameters

Name                       Description Type Examples
*{billing_plan} Billing plan to be applied to the call. string licence
ondemand
*{account_id} Provided identifier of the account. string
*{poi_id} Identifier of the POI to retrieve data for.
Value obtainable either :
- if {billing_plan}= licence, from $.results[*].resource.id field of List Licences Response Body
- if {billing_plan}= ondemand, from $.results.pois[*].id field of any Search API Response Body.		 string XXeUNbmtYZTsH7UGvNfXWo

Header Parameters

Name                          Description Type Examples                         
*x-api-key Provided API key {x_api_key} that allows authentication. string
*Authorization Provided token {jwt_bearer} that allows authorization. string Bearer {jwt_bearer}
Example 
curl -X GET 'https://api.datappeal.io/v4/licence/account/{account_id}/poi/HF8xjSQW4W43NGr56denSh/data/contact' \
-H 'x-api-key: {x_api_key}' \
-H 'Authorization: Bearer {jwt_bearer}' \

Response

Status

Status Description
200 Contact info has been successfully returned.

Body

ContactInfo

Field                     Description Type Examples
*id Hashed identifier of the POI. string Fx1iZYDScrSAy1yD57wktx
*name Description of the POI. string Albert Cuyp Market
*address Textual address of the POI along with its spatial coordinates. Address
:fontawesome-solid-exclamation-circle: *type Identifies the super-typology of the POI. string Dictionary
*category Identifies the sub-typology of the POI. string Dictionary
:fontawesome-solid-sync-alt: industry Identifies the super-typology of the POI. string Dictionary
rooms Number of rooms, only for POI with "type": "hotel". int 326
stars Hotel stars rating in the range [1,5], only for POI with "type": "hotel". int 4
picture URL of an image related to the POI. string https://media-cdn.tripadvisor.com/media/photo-s/0d/8f/e0/42/solarium.jpg
*websites List of institutional websites of the POI. array[string] ["http://www.ghshotels.it/astoria"]
*contacts List of direct contacts of the POI. array[Contact]
*networks List of networks where the POI is present. array[Network]
Address
Field Description Type Examples
*fullAddress Textual address. string Joulumaantie 1, 96930 Rovaniemi, Finland
*latitude Latitude expressed in the range [-90, 90]. decimal 66.54362
*longitude Longitude expressed in the range [-180, 180]. decimal 25.847197
Contact
Field Description Type Examples
*type Type of contact. string PHONE
EMAIL
*value Contact reference value. string +39 091 6281111
[email protected]
Network
Field Description Type Examples
*network Identifier of the network. string booking
facebook
*url URL of the POI in the relative network. string http://www.booking.com/hotel/it/astoria-palace.it.html
https://www.facebook.com/astoriapalacehotel

Example 
{
    "id": "XXeUNbmtYZTsH7UGvNfXWo",
    "name": "Astoria Palace Hotel",
    "address": {
        "fullAddress": "Via Montepellegrino, 62, 90142 Palermo PA, Italy",
        "latitude": 38.1394445,
        "longitude": 13.3574275
    },
    "type": "hotel",
    "category": "hotel",
    "industry": "hospitality",
    "rooms": 326,
    "stars": 4,
    "picture": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/16/b8/2c/45/img-20190221-171241-largejpg.jpg?w=2400&h=-1&s=1",
    "websites": [
        "http://www.ghshotels.it/astoria"
    ],
    "contacts": [
        {
            "type": "PHONE",
            "value": "+39 091 6281111"
        },
        {
            "type": "EMAIL",
            "value": "[email protected]"
        }
    ],
    "networks": [
        {
            "network": "tripadvisor",
            "url": "https://www.tripadvisor.it/Hotel_Review-g187890-d233480-Reviews-Astoria_Palace_Hotel-Palermo_Province_of_Palermo_Sicily.html"
        },
        {
            "network": "booking",
            "url": "http://www.booking.com/hotel/it/astoria-palace.it.html"
        },
        {
            "network": "holidaycheck",
            "url": "https://www.holidaycheck.de/hi/hotel-astoria-palace/fd766a57-211e-39cb-b06f-88eee40cc048"
        },
        {
            "network": "zoover",
            "url": "https://www.zoover.nl/italie/sicilie/palermo/astoria-palace/hotel"
        },
        {
            "network": "yelp",
            "url": "https://www.yelp.it/biz/astoria-palace-hotel-grande-albergo-palermo"
        },
        {
            "network": "agoda",
            "url": "https://www.agoda.com/it-it/astoria-palace-hotel/hotel/palermo-it.html"
        },
        {
            "network": "foursquare",
            "url": "https://it.foursquare.com/v/astoria-palace-hotel/4c2f778ded37a593df4b6703"
        },
        {
            "network": "expedia",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel"
        },
        {
            "network": "hrs",
            "url": "https://www.hrs.com/en/hotel/astoria-palace/a-22625"
        },
        {
            "network": "ctrip",
            "url": "https://www.trip.com/hotels/palermo-hotel-detail-772550/astoria-palace-hotel"
        },
        {
            "network": "facebook",
            "url": "https://www.facebook.com/astoriapalacehotel"
        },
        {
            "network": "twitter",
            "url": "https://twitter.com/ghs_hotels"
        },
        {
            "network": "instagram",
            "url": "https://www.instagram.com/ghshotels"
        },
        {
            "network": "venere",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=venere"
        },
        {
            "network": "hotels",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=hotels"
        },
        {
            "network": "ebookers",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=ebookers"
        },
        {
            "network": "orbitz",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=orbitz"
        },
        {
            "network": "homelidays",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=homelidays"
        },
        {
            "network": "hotwire",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=hotwire"
        },
        {
            "network": "travelocity",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=travelocity"
        },
        {
            "network": "wotif",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=wotif"
        },
        {
            "network": "hotelclub",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=hotelclub"
        },
        {
            "network": "cheaptickets",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=cheaptickets"
        },
        {
            "network": "mrjet",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel?source=mrjet"
        }
    ]
}