▪ List URLs

List URLs API returns the list of network URLs associated to a POI.

Request

Endpoint

GET /v4/{billing_plan}/account/{account_id}/management/poi/{poi_id}/url

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/{billing_plan}/account/{account_id}/management/poi/XXeUNbmtYZTsH7UGvNfXWo/url' \
-H 'x-api-key: {x_api_key}' \
-H 'Authorization: Bearer {jwt_bearer}' \

Response

Status

Status	Description
200	List URLs data has been successfully returned.

Body

URLs

Field	Description	Type
*urls	List of URLs.	array[URL]

URL

Field	Description	Type	Examples
*id	Identifier of the URL.	int	3152963
*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

{
    "urls": [
        {
            "id": 3152963,
            "network": "tripadvisor",
            "url": "https://www.tripadvisor.it/Hotel_Review-g187890-d233480-Reviews-Astoria_Palace_Hotel-Palermo_Province_of_Palermo_Sicily.html"
        },
        {
            "id": 144973,
            "network": "booking",
            "url": "http://www.booking.com/hotel/it/astoria-palace.it.html"
        },
        {
            "id": 144977,
            "network": "agoda",
            "url": "https://www.agoda.com/it-it/astoria-palace-hotel/hotel/palermo-it.html"
        },
        {
            "id": 3152964,
            "network": "expedia",
            "url": "https://www.expedia.it/Palermo-Hotel-Astoria-Palace-Hotel.h523541.Informazioni-Hotel"
        },
        {
            "id": 5815928,
            "network": "hrs",
            "url": "https://www.hrs.com/en/hotel/astoria-palace/a-22625"
        },
        {
            "id": 144980,
            "network": "facebook",
            "url": "https://www.facebook.com/astoriapalacehotel"
        },
        {
            "id": 451357,
            "network": "twitter",
            "url": "https://twitter.com/ghs_hotels"
        },
        {
            "id": 144981,
            "network": "instagram",
            "url": "https://www.instagram.com/ghshotels"
        }
    ]
}