📂

Technical Documentation

💡
In this section you are going to find all the definitions for the Data Packs we offer. In principle each pack listed below is available as a standalone item or in combination with others. 🔑 All POI packages use the poi_id field as a key to link the different files therefore a basic package that includes the poi_id is always needed to act as a link between the different data points. This means that the Core Attributes file is always included in all deliveries.

The general structure of our Data Packs is as follows:

POI Data Packs Basic Packages

These packages allow you to have a basic list of POIs with potentially some enriched information attached to each individual item.

Package Name
Description
Example Use Case
Fields Definitions
Core Attributes
This file contains basic POI information that are useful to perform simple analyses.
Count the number of POIs that belong to different Categories (e.g. bars or restaurants) within a certain Industry (e.g. Food & Beverage).
Rich Attributes
This file contains more information around the POIs such as the Popularity or the Date when they first opened.
I want to complement my Core data with additional information around the POIs.
Contacts & Brands
In this file, in addition to the Rich Attributes above, we append to each POI also Contact and Brand informations.
I want to know all the public websites of the POIs of a certain Industry or belonging to a certain Brand. —> For more information on the Brand feature please visit this page.
Accommodation Focus
Only available for the Hospitality and Short Term Rentals Industry this files adds to each POI information around the travellers staying in the different establishments.
I want to know the origin of people staying in a certain group of hotels.

POI Data Packs Add on Packages

These additional files allow you to complement the POI information you’ve obtained in the previous iteration with some extra details.

Package Name
Description
Example Use Case
Fields Definitions
Characterisation
This is an additional file containing information around the services and facilities of a given POI. Full list of Characterisation Types & Values here.
I want to know how many POIs in a certain group offer a swimming pool in their facilities.
Opening Hours
This additional file contains information about the opening and closing time of the selected establishments.
I want to know when bars close in a certain region.
Sentiment Trend
This file contains the Sentiment Score of a certain POI sampled over time. You can select both how long you want the data to be available in the past and also how frequently you want the data to be sampled.
I want to know how well perceived are hostels in a certain region. I also want to know if this is increasing over time using data sampled every week for the past 24 months.
Popularity Trend
Similarly this file provides Popularity information of a certain POI tracked over time. The Popularity Score here represents a proxy for the number of people visiting the POI in the unit of time. More info about the Popularity Index here.
I want an estimate of how popular a certain establishment is.
Popularity Time Of Day Breakdown
This file provides Popularity information grouped by time of day brackets.
I want to know if a certain business is more popular in the morning or in the afternoon.
OTA Offers Price
This file contains information about prices found online on OTAs (Online Travel Agencies) for Hospitality and Short Term Rentals POIs. Please note this data is available for a time range in the future from the moment it is shopped.
I want an estimate of the sort of prices that are visibile online for a certain group of POIs for the next 6 months sampled daily.
OTA Offers Saturation
For Hospitality and Short Term Rentals looking at the future this file provides an estimation of the number of units that have been sold for certain dates compared to the number of units ever available for that same date using public data from OTA websites.
I want an estimate of how “busy” a certain location is in the next few months.
Digital Trace Summarisation
For those interested in a detailed understanding of how a Point of Interest (POI) is discussed by its customers, this add-on provides a comprehensive list of digital traces (reviews, social media, posts, etc.) associated with each POI. The data is summarised using a LLMs to highlight the most relevant insights on each content.
I want to analyse in detail what customers say about the requested POIs.
Benchmark Layer
For those who need to understand how their Point of Interest (POI) compares within a local context, the Benchmark Add-On offers a comprehensive analysis. It benchmarks up to 25 similar POIs within a 5 km radius, providing insights into sentiment and popularity scores, key cluster identification, and relevant topic discussions.
I want to analyse in detail how a specific POI compares to others.

Product SKU

To enhance the ease of identification for each Data Pack Product, we utilise SKUs. Below, you will find the updated list of SKUs specifically for POI Data Packs.

POI Data Pack Product
DPK-POI-CORE
POI Data Pack Core Information
DPK-POI-RICH
POI Data Pack Rich Information
DPK-POI-CONTACT
POI Data Pack Rich Information including Contact and Brand information
DPK-POI-OTA
POI Data Pack Rich Information including Accommodation Focus information
POI Data Pack Add-ons
DPK-POIADD-CHAR
Characterisation add on
DPK-POIADD-SENT
Sentiment Trend add on
DPK-POIADD-POP
Popularity Trend add on
DPK-POIADD-OPHO
Opening Hours add on
DPK-POIADD-OTAP
OTA Prices add on
DPK-POIADD-OTAS
OTA Saturation add on
DPK-POIADD-POPTOD
Popularity time of day add on
DPK-POIADD-DTS
Digital Trace Summarisation add on
DPK-POIADD-BKL
Benchmark Layer add on
POI Data Pack Additional Services
DPK-POISER-VVA
VAT Matcher Service
DPK-POISER-CSA
Search by input
DPK-POISER-CBE
Custom Brands Extraction

Additional information

Please find below the links to further resources helpful to understand how our data is organised.

🔢POI Data Fields Definitions🗒️POI CharacterisationPOI Opening HoursPOI Sentiment Trends🍿POI Popularity Trends🕰️POI Popularity Time Of Day Breakdown💰POI OTA Offers Price🧪POI OTA Offers Saturation✍🏼POI Digital Trace Summarisation📊POI Benchmark Layer🧋Brand FAQs📙Dictionary: Administrative Level Detail📗Dictionary: Characterisation Types & Values📗Dictionary: Industries & Categories📕Dictionary: Clusters📘Dictionary: Brand Names📘Dictionary: Popularity Index📙Dictionary: Sentiment Score