iOS
Insights Overview
| № | Name | API Code | Required Module |
|---|---|---|---|
| 1 | Device | deviceInfo | Core Module |
| 2 | Velocity | velocity | Core Module |
| 3 | IP Info | ipInfo | Core Module |
| 4 | Apps Info | application | Core Module |
| 5 | Permissions | permissions | Core Module |
| 6 | Calendar Events | calendar | Calendar Events Module |
| 7 | Calendar Reminders | reminders | Calendar Reminders Module |
| 8 | Contacts | contacts | Contact Module |
| 9 | Images | images | Media Module |
| 10 | Video | video | Media Module |
Accessing API Fields
Discover how to retrieve the API fields listed below through the Dataset Insights API.
Note
Our API typically returns non-null values as
string. For type spec on each field, see the Data Type column in the tables below.For detailed type specifications, check out the Type Specification
Device
Requires integration of Core Module
| Field | Data Type | Description |
|---|---|---|
deviceId | string | Unique device identifier. Max length: 100 |
deviceIsSimulator | boolean | Indicates whether the device is simulator or not |
deviceIsJailBroken | boolean | Indicates whether the device is JailBroken or not |
deviceBrand | string | Brand or manufacturer of the device. Max length: 100 |
deviceModel | string | Model of the device. Max length: 100 |
deviceOsVersion | string | Operating System version of the device. Max length: 100 |
deviceScreenSize | string | Screen size. Max length: 100 |
deviceMainStorageTotal | float | Total main storage in Megabytes |
deviceMainStorageFree | float | Free main storage in Megabytes |
deviceRamTotalSize | float | Total RAM size |
deviceLocationEnabled | boolean | Indicates if location is enabled |
deviceAllowsVOIP | boolean | Indicates is VOIP is allowed |
deviceCurrencyCode | string | Currency code. Max length: 100 |
deviceNetworkOperatorName | string | Name of the mobile network operator (only active SiM card is detected). Max length: 100 |
deviceNetworkConnectionType | string | Active network connection type. Max length: 100 |
deviceSimCountryIso | string | ISO country code of the SIM card. Max length: 100 |
deviceLanguageCode | string | Code for the primary language. Max length: 100 |
deviceRegionCode | string | Code for the region or country based on locale settings of the device. Max length: 100 |
deviceTimeZoneId | string | Time zone setting of the device. Max length: 100 |
deviceLocaleDisplayLanguage | string | Language for displaying text and UI. Max length: 100 |
deviceBatteryIsCharging | boolean | Indicates whether the battery is charging or not |
deviceBatteryStatus | float | Indicates the current battery level in percentage (for ios only in case the battery monitoring is enabled) |
deviceCPUType | string | The name of CPU type. Max length: 100 |
deviceIsLying | boolean | The approximate device position: is lying flat or not |
deviceIsAngled | boolean | The approximate device position: is angled or not |
deviceIsStanding | boolean | The approximate device position: is standing or not |
Response body example (application/json)
{
"code":"deviceInfo",
"value":{
"deviceId":"B01634BF-C7E6-4BA1-9384-3D862E8DF050",
"deviceIsSimulator":"false",
"deviceIsJailBroken":"false",
"deviceBrand":"iPhone",
"deviceModel":"iPhone12,5",
"deviceOsVersion":"16.5",
"deviceScreenSize":"2688x1242",
"deviceMainStorageTotal":"60907.11328125",
"deviceMainStorageFree":"38180.22265625",
"deviceRamTotalSize":"3750.15625",
"deviceLocationEnabled":"true",
"deviceAllowsVOIP":"true",
"deviceCurrencyCode":"UAH",
"deviceNetworkOperatorName":"--",
"deviceNetworkConnectionType":"wifi",
"deviceSimCountryIso":"--",
"deviceLanguageCode":"en",
"deviceRegionCode":"UA",
"deviceTimeZoneId":"Europe/Kiev",
"deviceLocaleDisplayLanguage":"en_UA",
"deviceBatteryIsCharging":"true",
"deviceBatteryStatus":null,
"deviceCPUType":"ARM_64",
"deviceIsLying":"true",
"deviceIsAngled":"false",
"deviceIsStanding":"false"
},
"calculatedDate":"2023-08-14T08:29:27.853634Z"
}Velocity
Requires integration of Core Module
| Field | Data Type | Description |
|---|---|---|
datasetsCountAllFromDeviceId | integer | Total number of datasets uploaded from the same device |
datasetsCountAllFromIp | integer | Total number of datasets uploaded from the same IP |
datasetsCountAllFromDeviceIdAndIp | integer | Total number of datasets uploaded from the same device and IP |
datasetsUniqueIpFromDeviceId | integer | Unique IP adresses for given device |
datasetsUniqueDeviceIdFromIp | integer | Unique devices for given IP address |
Response body example (application/json)
{
"code":"velocity",
"value":{
"datasetsCountAllFromDeviceId":"1",
"datasetsCountAllFromIp":"37",
"datasetsCountAllFromDeviceIdAndIp":"1",
"datasetsUniqueIpFromDeviceId":"1",
"datasetsUniqueDeviceIdFromIp":"14"
},
"calculatedDate":"2023-08-14T08:29:27.8536355Z"
}IP Info
Requires integration of Core Module
Note
If you're using a Proxy or Reverse Proxy configuration with the IP Info, ensure you submit the actual device IP address in your request
| Field | Data Type | Description |
|---|---|---|
ip | string | Unique identifier assigned to a device on a network. Max length: 100 |
hostname | string | Host name of an IP address. Max length: 100 |
city | string | Urban area where an IP address is located. Max length: 100 |
region | string | Geographical subdivision of a country where an IP address is situated. Max length: 100 |
country | string | Country where an IP address is registered. Max length: 100 |
loc | string | GPS location of area where an IP address is registered. Max length: 100 |
postal | string | Postal code associated with an IP address's location. Max length: 100 |
timezone | string | Standard time of an IP address's geographical area. Max length: 100 |
privacyVpn | boolean | Connection via VPN (IP address masking) |
privacyProxy | boolean | Connection via proxy (IP address masking) |
privacyTor | boolean | Connection via tor (IP address masking) |
privacyRelay | boolean | Connection via privat relay (IP address masking) |
privacyHosting | boolean | Connection via hosting provider (IP address masking) |
Response body example (application/json)
{
"code":"ipInfo",
"value":{
"ip":"62.216.42.130",
"hostname":null,
"city":"Kyiv",
"region":"Kyiv City",
"country":"UA",
"loc":"50.4547,30.5238",
"postal":"03027",
"timezone":"Europe/Kyiv",
"privacyVpn":"true",
"privacyProxy":"false",
"privacyTor":"false",
"privacyRelay":"false",
"privacyHosting":"false"
},
"calculatedDate":"2023-08-14T08:29:27.8536353Z"
}Apps Info
Requires integration of Core Module
| Field | Data Type | Description |
|---|---|---|
isInstalled | integer | Indicates whether an application of the particular URL Schema is installed |
urlSchemaName | string | Name of the URL Schema |
Response body example (application/json)
{
"code":"application",
"value":[
{
"isInstalled":"0",
"urlSchemaName":"th.co.amoney"
},
{
"isInstalled":"0",
"urlSchemaName":"com.ntl.cxm-mobile"
},
{
"isInstalled":"0",
"urlSchemaName":"mtls"
},
{
"isInstalled":"0",
"urlSchemaName":"kbank.kplus"
},
{
"isInstalled":"0",
"urlSchemaName":"scbeasy"
},
{
"isInstalled":"1",
"urlSchemaName":"ktbnext"
},
{
"isInstalled":"0",
"urlSchemaName":"tmbtouch"
},
{
"isInstalled":"0",
"urlSchemaName":"krungsri-kma"
},
{
"isInstalled":"0",
"urlSchemaName":"bblapptoappmbanking"
},
{
"isInstalled":"0",
"urlSchemaName":"chaiyomobile"
},
{
"isInstalled":"0",
"urlSchemaName":"line3rdp.com.ccc.game.pcr"
},
{
"isInstalled":"0",
"urlSchemaName":"com.gameindy.dummyth"
},
{
"isInstalled":"0",
"urlSchemaName":"bornrich"
},
{
"isInstalled":"0",
"urlSchemaName":"goldwing-global"
},
{
"isInstalled":"1",
"urlSchemaName":"gsbmymo"
},
{
"isInstalled":"0",
"urlSchemaName":"com.scbabacus.l2020"
},
{
"isInstalled":"0",
"urlSchemaName":"monix"
},
{
"isInstalled":"0",
"urlSchemaName":"ghb-allgen"
},
{
"isInstalled":"0",
"urlSchemaName":"srisawadapp"
},
{
"isInstalled":"0",
"urlSchemaName":"com.huoys.royalcasinoonline"
},
{
"isInstalled":"0",
"urlSchemaName":"fb507039520732712"
}
],
"calculatedDate":"2023-08-14T08:29:27.8536343Z"
}Permissions
Requires integration of Core Module
| Field | Data Type | Description |
|---|---|---|
NSAppleMusicUsageDescription | integer | Permission that allows reading metadata related to music and music albums |
NSContactsUsageDescription | integer | Permission that allows reading metadata related to Contacts and Contacts Group |
NSRemindersUsageDescription | integer | Permission that allows reading metadata related to Calendar reminders |
NSCalendarsUsageDescription | integer | Permission that allows reading metadata related to Calendar events |
NSPhotoLibraryUsageDescription | integer | Permission that allows reading metadata related to images and videos |
Response body example (application/json)
{
"code":"permissions",
"value":{
"NSAppleMusicUsageDescription":"1",
"NSContactsUsageDescription":"1",
"NSRemindersUsageDescription":"1",
"NSCalendarsUsageDescription":"1",
"NSPhotoLibraryUsageDescription":"1"
},
"calculatedDate":"2023-08-14T08:29:27.8536343Z"
}Permission Value Description
| Value | Description |
|---|---|
null | The corresponding SDK module is not integrated |
0 | Permission is not granted |
1 | Permission is granted |
Calendar Events
Requires integration of Calendar Events Module
| Field | Data Type | Description |
|---|---|---|
CalendarEventsPastCount | integer | Total number of past events |
calendarEventsTotalCount | integer | Total number of calendar events |
calendarEventsAsOrganizerCount | integer | Total number of organized calendar events |
calendarEventsStatusConfirmedCount | integer | Total number of calendar events with confirmed status |
calendarEventsDuringWeekdayCount | integer | Total number of calendar events during the weekday |
calendarEventsMoreThan1AttendeeCount | integer | Total number of calendar events with more than 1 attendee |
calendarEventsDifferentTimeZonesCount | integer | Total number of calendar events in different time zone |
calendarEventsLast30DaysCount | integer | Total number of calendar events in the last 30 days |
calendarEventsNext30DaysCount | integer | Total number of events in the next 30 days |
calendarEventsLast30DaysRepetitiveCount | integer | Total number of repetitive calendar events in the last 30 days |
calendarEventsDuringWeekdayLast30DaysCount | integer | Total number of calendar events during the weekday in the last 30 days |
The values in the API response will be
nullif the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"calendar",
"value":{
"calendarEventsPastCount":" 5993",
"calendarEventsTotalCount":"6461",
"calendarEventsAsOrganizerCount":"1",
"calendarEventsStatusConfirmedCount":"3985",
"calendarEventsDuringWeekdayCount":"6455",
"calendarEventsMoreThan1AttendeeCount":"1",
"calendarEventsDifferentTimeZonesCount":"1",
"calendarEventsLast30DaysCount":"0",
"calendarEventsNext30DaysCount":"418",
"calendarEventsLast30DaysRepetitiveCount":"0",
"calendarEventsDuringWeekdayLast30DaysCount":"0"
},
"calculatedDate":"2023-08-14T08:29:27.8536346Z"
}Calendar Reminders
Requires integration of Calendar Reminders Module
| Field | Data Type | Description |
|---|---|---|
remindersTotalCount | integer | Total number of reminders |
remindersDuringWeekdayCount | integer | Total number of reminders during the weekdays |
remindersMoreThan1AttendeeCount | integer | Total number of reminders with more than one attendee |
remindersDifferentTimeZonesCount | integer | Total number of reminders with different time zones |
remindersLast30DaysCount | integer | Total number of reminders in last 30 days |
remindersLast30DaysRepetitiveCount | integer | Total number of reminders for repetitive events in last 30 days |
remindersDuringWeekdayLast30DaysCount | integer | Total number of reminders during the weekday in last 30 days |
The values in the API response will be
nullif the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"reminders",
"value":{
"remindersTotalCount":"7",
"remindersDuringWeekdayCount":"7",
"remindersMoreThan1AttendeeCount":"0",
"remindersDifferentTimeZonesCount":"0",
"remindersLast30DaysCount":"7",
"remindersLast30DaysRepetitiveCount":"0",
"remindersDuringWeekdayLast30DaysCount":"7"
},
"calculatedDate":"2023-08-14T08:29:27.8536354Z"
}Contacts
Requires integration of Contact Module
| Field | Data Type | Description |
|---|---|---|
contactsTotalCount | integer | Total number of contacts |
contactsWithoutNumberCount | integer | Total number of contacts without any phone number |
contactsMultipleNumbersCount | integer | Total number of contacts with multiple associated phone numbers |
contactsWithPictureCount | integer | Total number of contacts with associated picture |
phoneNumberTotalCount | integer | Total number of phone numbers |
contactsEmailCount | integer | Total number of contacts with email address |
contactsWorkCount | integer | Total number of contacts with company name |
The values in the API response will be
nullif the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"contacts",
"value":{
"contactsTotalCount":"3",
"contactsWithoutNumberCount":"1",
"contactsMultipleNumbersCount":"1",
"contactsWithPictureCount":"0",
"phoneNumberTotalCount":"3",
"contactsEmailCount":"2",
"contactsWorkCount":"1"
},
"calculatedDate":"2023-08-14T08:29:27.8536345Z"
}Images
Requires integration of Media Module
| Field | Data Type | Description |
|---|---|---|
imagesCount | integer | Total number of images |
imagesCountWithLocation | integer | Total number of images with location property |
imageResolution | string | Most frequent image resolution. Max length: 100 |
imagesLast30DaysCount | integer | Total number of images created in the last 30 days |
imagesLast360DaysCount | integer | Total number of images created in the last 360 days |
imagesFirstMonth10Images | string | First month with more than 10 images. Max length: 100 |
The values in the API response will be
nullif the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"images",
"value":{
"imagesCount":"73",
"imagesCountWithLocation":"6",
"imageResolution":"3024x4032",
"imagesLast30DaysCount":"0",
"imagesLast360DaysCount":"72",
"imagesFirstMonth10Images":"2021-03"
},
"calculatedDate":"2023-08-08T13:40:16.3508145Z"
}Video
Requires integration of Media Module
| Field | Data Type | Description |
|---|---|---|
videoCount | integer | Total number of video files |
videoLast30DaysCount | integer | Total number of video files created in the last 30 days |
The values in the API response will be
nullif the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"video",
"value":{
"videoCount":"4",
"videoLast30DaysCount":"1"
},
"calculatedDate":"2023-08-14T08:29:27.8536352Z"
}Type Specification
Type | Description | Example |
|---|---|---|
| A string is a sequence of characters. It can include letters, numbers, symbols, and spaces. |
|
| Boolean represents values |
|
| Float represents decimal numbers with fractional parts |
|
| Integer represents whole numbers without decimals |
|
| Date and time values expressed in UTC and have the following format |
|
Updated 11 days ago