Introduction
The quintly API is made for you to access all data points you already know from our tool. You need to have a quintly business account in order to access this API. Please get in touch with our support if you like to get access.
Authenticating
For authentication we use Basic Auth via HTTPS. For the username you have to send your quintly client id and for the password your API secret. If you don't have these details yet, please get in touch with our support.
Handling errors
In case of errors, the HTTP status code returns either 404 for a non-existing resource or 500 for any other error. You can expect the following JSON response to be sent in the response's body. There is success set to false and errors and errors.reason holding more specific information about the error. In most cases errors.errorType will return a unique identifier you can use to identify the specific type of error.
{ "success": false, "errors": { "reason": "The underlying SQL query failed: no such table: instagramInsight", "errorType": "qqlMalformed" } }
Requesting endpoints
All endpoints can be requested using both GET and POST requests. We recommend using POST requests because of much higher request size limits. Using POST, parameters need to be passed within the body of the request in application/x-www-form-urlencoded format.
Rate limits
So far rate limits have been set very loose and you should not hit any limits at all.
Understanding the concept of spaces
Business accounts can be split into fully isolated environments named spaces. By default, an account starts by having a single space named "Main". When it comes to operations like adding profiles, you need to specify the space a new profile should be added to.
Using the following endpoint you can access the list of available spaces within your account.
https://api.quintly.com/v0.9/list-spaces
Managing users
Access the list of users in your account using the following endpoint. Certain operations require you to specify a user in whoms name the operation will be performed, for example when creating a new profile.
https://api.quintly.com/v0.9/list-users
Managing profiles
There is full support to search, add, remove and list profiles within your account via the API.
Searching profiles
Before adding a new profile, you will need to uniquely identify the profile to be added. For this purpose, you can use the following endpoint for search. For Facebook, Twitter, YouTube and LinkedIn you can use free text search to find profiles by name or term. For Instagram, use the profile's username. For all these networks, you can also search by using the profile URL (e.g., https://www.facebook.com/quintly). TikTok and Snapchat Shows are special, because they are not searchable by name or URL and require authentication instead (read Adding profiles for TikTok and Snapchat Shows).
https://api.quintly.com/v0.9/search-profiles?q=quintly https://api.quintly.com/v0.9/search-profiles?q=quintly&network=facebook https://api.quintly.com/v0.9/search-profiles?q=https%3A%2F%2Fwww.facebook.com%2Fquintly
Adding profiles for Facebook, Twitter, YouTube and LinkedIn
To add profiles, please specify the ID of the space you would like to add the new profile to (read Understanding the concept of spaces), and the social network URL for the profile to be added. Usually you will use the search-profiles endpoint described above to identify the social network URL of a profile.
https://api.quintly.com/v0.9/add-profile?userId=1&spaceId=1&q=https%3A%2F%2Fwww.facebook.com%2Fquintly
Adding profiles for TikTok or Snapchat Shows
Adding TikTok or Snapchat Show profiles requires authentication. You can use the following endpoint to generate a link that can be shared with an external user. On this page, the external user can grant access to their TikTok or Snapchat Show profile. This page does not require credentials and it does not expire. It can safely be used and sent to all users you need to authenticate externally for the purpose of profile adding later on. The quintly user specified by its id (parameter "userId") will be notified, whenever access to new profiles has been granted.
https://api.quintly.com/v0.9/generate-private-statistics-authentication-link?spaceId=1&userId=1
With the following endpoint you can list all profiles, that have recently been authenticated by external users on the pages generated via the endpoint above.
https://api.quintly.com/v0.9/list-recent-private-statistics-authentications-for-profile-adding?spaceId=1
Finally, you can add a profile available in the list of recently authenticated profiles, by using the following endpoint and the "platformType" and "platformId" attributes of a specific profile returned by the endpoint described above.
https://api.quintly.com/v0.9/add-profile-from-recent-private-statistics-authentication?userId=1&spaceId=1&platformType=facebook&platformId=128340270541979
Removing profiles
To remove an existing profile from your account, provide the space and profile id to be deleted. Use the list-profiles endpoint to obtain the profile id.
https://api.quintly.com/v0.9/remove-profile?userId=1&spaceId=1&profileId=92
Listing profiles
For listing all profiles within your account, use the following endpoint. Here you can also obtain the profile ids necessary to fetch data later on. Parameters "spaceId" and "groupId" are optional and can be used to filter the list of profiles.
https://api.quintly.com/v0.9/list-profiles?spaceId=1&groupId=1
Accessing private statistics
To access private stats for a profile, it is important to understand the concept of private stats use cases. In order to not ask for too wide permissions when accessing private stats data of your profiles, we have introduced different use cases when accessing this data. E.g., the use case of Facebook Basic Insights allows you to fetch basic Page and Post Insights. You can explore all available private stats use cases using the following endpoint.
https://api.quintly.com/v0.9/list-private-stats-use-cases
Once you have identified the use cases covering the data points you would like to access, you have to activate these use cases for a specific profile. Use the following endpoint to do so.
https://api.quintly.com/v0.9/activate-private-stats-use-cases?userId=1&spaceId=1&profileId=1&useCaseIds=1,2
After having activated use cases for a specific profile, you have to fulfill this use case by authenticating and granting the required permissions. You can retrieve an authentication link to do so using the following endpoint. This link can be shared with an external user and does not require credentials. It expires 7 days after creation.
https://api.quintly.com/v0.9/generate-private-statistics-authentication-link?spaceId=1&profileId=1&userId=1&useCaseIds=1,2
To deactivate a profile's private stats use cases, use the following endpoint.
https://api.quintly.com/v0.9/deactivate-private-stats-use-cases?userId=1&spaceId=1&profileId=1&useCaseIds=1,2
Fetching data
Loading data is handled via the qql endpoint. We recommend using the Metric Builder to easily build API requests. After you pressed Run QQL within Metric Builder, there is an API section within the Query results tab holding the complete API request for this metric and the current selection (profile, date and additional filters).
The qql endpoint offers the following parameters:
- qqlQuery: The QQL query describing the data to be loaded. Find further information on how to write QQL queries in our knowledge base.
- startTime: The beginning of the period you want to get the data for in format YYYY-MM-DD
- endTime: The end of the period you want to get the data for in format YYYY-MM-DD
- interval: The aggregation interval used for the analysis (daily, weekly, monthly, total)
- timezone (optional): By default our API does fetch and aggregate data using the timezone setting of the admin user of your quintly account. We strongly recommend to set an explicit timezone to not rely on settings of one of your users. The list of supported timezones can be found here. E.g. for fetching data in UTC timezone just use "UTC" here.
- sortBy (optional): Represents the qql field which will be used for sorting the data.
- sortDir (optional): Represents the sorting direction which will be used to sort the data. Expected values are 'asc' or 'desc'.
- start (optional): Represents the index of the first item of the requested data.This parameter can be used for pagination in combination with the 'limit' parameter.
- limit (optional): Represents the value to limit the requested data. This parameter can be also used for pagination in combination with the 'start' parameter.
- adAccountIds (optional): A comma-separated list of ad account ids (you can find the id of an ad account by using the list-ad-accounts endpoint described above). You can only fetch data for ad accounts added to your quintly account.
- profileIds (optional): A comma-separated list of profile ids (you can find the id of a profile by using the list-profiles endpoint described above). You can only fetch data for profiles added to your quintly account.
- postTags (optional): A configuration in JSON format describing what post tags to filter post/item-level data by. E.g. {"conjunction":"any","values":[<tagId1>,<tagId2>],"untagged":false}
- postText (optional): A configuration in JSON format describing what text to filter post/item-level data by. E.g. {"values":["keyword1", "keyword2"],"conjunction":"any"}
- adCampaign (optional): A configuration in JSON format describing what ad campaigns to filter ad data sources by. E.g. {"values":["Campaign name A", "Campaign name B"],"conjunction":"any"}
The following is an example for fetching the number of Page Likes for Facebook Pages.
https://api.quintly.com/v0.9/qql?qqlQuery=SELECT%20profileId,%20time,%20fans%20FROM%20facebook&startTime=2014-01-01&endTime=2014-01-31&interval=weekly&profileIds=13,14
The response will be sent in JSON format. Here is a sample response for the example above.
{ "success":true, "data":[ {"profileId":13,"time":"2013-12-30 00:00:00","fans":1372}, {"profileId":14,"time":"2013-12-30 00:00:00","fans":218}, {"profileId":13,"time":"2014-01-06 00:00:00","fans":1371}, {"profileId":14,"time":"2014-01-06 00:00:00","fans":219}, {"profileId":13,"time":"2014-01-13 00:00:00","fans":1371}, {"profileId":14,"time":"2014-01-13 00:00:00","fans":219}, {"profileId":13,"time":"2014-01-20 00:00:00","fans":1371}, {"profileId":14,"time":"2014-01-20 00:00:00","fans":219}, {"profileId":13,"time":"2014-01-27 00:00:00","fans":1372}, {"profileId":14,"time":"2014-01-27 00:00:00","fans":219} ] }
Managing interactive shared dashboards links
Once you have created dashboards in the tool, there are several ways to share them. One option is to share the dashboard as an interactive version in form of a link.
Listing shared dashboard links
You can list all shared links in your account using the following endpoint.
https://api.quintly.com/v0.9/list-dashboard-share-links
Creating shared dashboard links
You can create a new link to share an interactive version of a dashboard using the following endpoint.
https://api.quintly.com/v0.9/create-dashboard-share-link
The following parameters are available for link creation.
- dashboardId: The ID of the dashboard to create an interactive version to be shared as a link. You usually extract the ID of a dashboard from its URL in the tool.
- userId: The ID of the user to be shown as the creator of the shared link
- groupId or profileIds: Provide either the ID of a group or a list of concrete profiles as a comma-separated list of profile IDs
- startTime, endTime or dynamicDate: Provide either a fixed time period in the form of a start and end time (in YYYY-MM-DD format) or provide a relative date definition using the dynamic date parameter (e.g., "last 30 days"). The dynamic date parameters supports all inputs accepted in the "Custom range" input of our date selector.
- interval: The aggregation interval used for the analysis (daily, weekly, monthly, total)
- timezone: The timezone used for the analysis. The list of supported timezones can be found here. E.g. for fetching data in UTC timezone just use "UTC" here.
- postTags (optional): A configuration in JSON format describing what post tags to filter post/item-level data by. E.g. {"conjunction":"any","values":[<tagId1>,<tagId2>],"untagged":false}
- postText (optional): A configuration in JSON format describing what text to include post/item-level data by. E.g. {"values":["keyword1", "keyword2"],"conjunction":"any"}
- postTextExclude (optional): A configuration in JSON format describing what text to exclude post/item-level data by. E.g. {"values":["keyword1", "keyword2"],"conjunction":"any"}
- hasExpiry (optional): If set to 1, the link will expire at the provided valid until date. The default is no expiry.
- validUntil (optional): If the link is set to expire, provide the expiration date in YYYY-MM-DD format
- isPasswordProtected (optional): If set to 1, a password is required to access the interactive version of the dashboard. The default is no password.
- password (optional): If the link requires a password, provide the password here
Updating shared dashboard links
Similar to creating a new shared link, you can also update existing ones.
https://api.quintly.com/v0.9/update-dashboard-share-link
The following parameters are available for updating links.
- id: The ID of the link to be updated
- groupId or profileIds: Provide either the ID of a group or a list of concrete profiles as a comma-separated list of profile IDs
- startTime, endTime or dynamicDate: Provide either a fixed time period in the form of a start and end time (in YYYY-MM-DD format) or provide a relative date definition using the dynamic date parameter (e.g., "last 30 days"). The dynamic date parameters supports all inputs accepted in the "Custom range" input of our date selector.
- interval: The aggregation interval used for the analysis (daily, weekly, monthly, total)
- timezone: The timezone used for the analysis. The list of supported timezones can be found here. E.g. for fetching data in UTC timezone just use "UTC" here.
- postTags (optional): A configuration in JSON format describing what post tags to filter post/item-level data by. E.g. {"conjunction":"any","values":[<tagId1>,<tagId2>],"untagged":false}
- postText (optional): A configuration in JSON format describing what text to include post/item-level data by. E.g. {"values":["keyword1", "keyword2"],"conjunction":"any"}
- postTextExclude (optional): A configuration in JSON format describing what text to exclude post/item-level data by. E.g. {"values":["keyword1", "keyword2"],"conjunction":"any"}
- hasExpiry (optional): If set to 1, the link will expire at the provided valid until date. The default is no expiry.
- validUntil (optional): If the link is set to expire, provide the expiration date in YYYY-MM-DD format
- isPasswordProtected (optional): If set to 1, a password is required to access the interactive version of the dashboard. The default is no password.
- password (optional): If the link requires a password, provide the password here
Removing shared dashboard links
To remove an existing link, use the following endpoint.
https://api.quintly.com/v0.9/remove-dashboard-share-link?id=<ID of the shared link>
Fetching data source meta data
Please use the following endpoint to access meta data for all available data sources.
https://api.quintly.com/v0.9/list-data-sources
Fetching data push task configurations
Please use the following endpoint to access meta data for your data push task configurations.
https://api.quintly.com/v0.9/list-data-push-tasks
To fetch recent logs for a data push task, use the following endpoint.
https://api.quintly.com/v0.9/list-data-push-task-logs?dataPushTaskId=<ID of the data push task>
Data sources are represented by tables you can use within your QQL queries. Below you can find all available data tables and their columns. Just click the respective table name to get further information and to see the table schema.
Summary
Holding public data for Facebook Pages and their development over time. All numbers are aggregates across the whole Facebook Page.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- For Pages that switched to the New Pages Experience, Fan metrics return the Follower count instead.
- Except for fans, checkins and people talking about metrics this data source calculates account-wide metrics by aggregating the results of all the posts (data source facebookOwnPosts) created in each interval. This also means that days, weeks or months without any posts published show 0 for all engagement metrics. This is to be differentiated from Facebook Insights data (data source facebookInsights) where the actual interaction time is considered for reporting, independent of when content has been published.
- Targeted posts are not imported.
- Deleted posts will not be removed from our database once they have been imported.
- When a Facebook Page disallows visitor posts, user posts will always be 0. Additionally, some user posts might not be included if the users who made them, do not allow their data to be shared via the API.
- Posts that contain links to YouTube or other web video players are considered video posts.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
fans | INTEGER | Number of Page Likes for this Facebook Page at the end of the current interval (e.g. a day, week, month). A Page must have at least 30 or more fans for this data to be returned. For Global Pages this shows the global Page Like count. For Pages that switched to the New Pages Experience, it will return the Follower count instead. |
fans |
INTEGER | Number of Page Likes for this Facebook Page at the beginning of the current interval (e.g. a day, week, month). A Page must have at least 30 or more Page Likes for this data to be returned. For Pages that switched to the New Pages Experience, it will return the Follower count instead. |
fans |
INTEGER | Change of the total number of Page Likes for this Facebook Page. For Pages that switched to the New Pages Experience, it will return the Follower count instead. |
followers | INTEGER | Number of Page Followers for this Facebook Page at the end of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Number of Page Followers for this Facebook Page at the beginning of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Change of the total number of Page Followers for this Facebook Page. |
checkins | INTEGER | Number of times a Page checked in at a place. |
checkins |
INTEGER | No documentation available yet |
checkins |
INTEGER | No documentation available yet |
people |
INTEGER | Number of people talking about a Page. |
people |
INTEGER | No documentation available yet |
people |
INTEGER | No documentation available yet |
people |
DECIMAL | No documentation available yet |
people |
PERCENT | No documentation available yet |
own |
INTEGER | Number of posts created on the page. This takes into account the creation time of the own post and not when the interaction occurred. Be aware that Reels are not included. |
own |
INTEGER | Number of comments and replies on comment the Page's posts got. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of likes on the Page's posts. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of Love reactions on the Page's posts. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of Wow reactions on the Page's posts. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of Haha reactions on the Page's posts. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of Sad reactions on the Page's posts. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of Angry reactions on the Page's posts. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of Shares on the Page's posts. This takes into account the creation time of the own post and not when the interaction occurred. |
own |
INTEGER | Number of posts created in Link type. |
own |
INTEGER | Number of posts created in Music type |
own |
INTEGER | Number of posts created in Photo type |
own |
INTEGER | Number of posts created in Status type |
own |
INTEGER | Number of posts created in Flash type |
own |
INTEGER | Number of posts created in Video type |
own |
INTEGER | Number of posts created in Misc type |
user |
INTEGER | Number of user posts created. |
user |
INTEGER | Number of comments on user posts. This takes into account the creation time of the user post and not when the interaction occurred. |
user |
INTEGER | Number of likes on user posts. This takes into account the creation time of the user post and not when the interaction occurred. |
user |
INTEGER | Number of shares on user posts. This takes into account the creation time of the user post and not when the interaction occurred. |
questions | INTEGER | Number of questions on a Page. Questions are defined as any user post that includes a "?". |
response |
INTEGER | Number of user questions that were replied to within 0 and 2 hours. |
response |
INTEGER | Number of user questions that were replied to within 2 and 8 hours. |
response |
INTEGER | Number of user questions that were replied to within 8 and 24 hours. |
response |
INTEGER | Number of user questions that were replied to after 24 hours |
response |
INTEGER | Number of user posts created which were detected as a question but were not commented on. |
facebookAdsPostAds
Summary
Holding information about Facebook ads running in the context of a Facebook Page.
Hints
- Shows ads from ad accounts under which the selected Facebook Pages have been promoted and where the ad's promoted post belongs to one of the selected Facebook Pages.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
account |
STRING | The ID of the ad account with which the ad was published. |
account |
STRING | The name of the ad account with which the ad was published. |
currency | STRING | The currency by which all costs under the Facebook ad account are specified. |
campaign |
INTEGER | The ID of the ad campaign to which the ad belongs. |
campaign |
STRING | The name of the ad campaign to which the ad belongs. |
campaign |
STRING | The defined objective of the ad campaign to which the ad belongs. |
campaign |
ENUM | The status of the ad campaign to which the ad belongs. |
updated |
DATETIME | Updated time |
ad |
DATETIME | The scheduled start time of the ad set to which the ad belongs. |
ad |
DATETIME | The scheduled end time of the ad set to which the ad belongs. |
time | DATETIME | The time this posting was created. In this case, this field refers to the creation time of the ad set to which the ad belongs. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
ad |
INTEGER | The ID of the ad set to which the ad belongs. |
ad |
STRING | The name of the ad set to which the ad belongs. |
ad |
STRING | The billing event of the ad set to which the ad belongs. A billing event refers to the event that triggers charging the ad account (e.g. post engagements, video views, etc.). |
ad |
STRING | The optimization goal of the ad set to which the ad belongs. |
ad |
ENUM | The status of the ad set to which the ad belongs. |
ad |
DATETIME | The time the adset was created. |
id | INTEGER | The ID of the ad. |
name | STRING | The name of the ad. |
status | ENUM | The effective status of the ad. |
ad |
ENUM | The status of the ad. |
bid |
STRING | The bidding type of the ad (e.g. CPA, Absolute OCPM, etc.). |
is |
BOOLEAN | Yields "1" if the post of this ad is a promoted post, which could also appear on the page's timeline, and an empty string otherwise (also known as a "Dark Post", which is visible only in a promoted manner). |
post |
STRING | The ID of the post that's being presented with the ad. |
instagram |
STRING | The ID of the instagram post. |
instagram |
STRING | The ID of the instagram account of the related instagram post. |
message | STRING | The contents of the post's body. |
post |
ENUM | The type of the post that's presented with the ad. |
thumbnail |
LINK | The ad's thumbnail URL. |
link | LINK | The link to the ad's post |
spend | DECIMAL | The estimated total amount of money spent on an ad during its schedule. |
social |
DECIMAL | The total amount spent on ads showed with social information (e.g. John Doe likes this). |
is |
BOOLEAN | Yields "1" if the post of this ad was published on Facebook, and an empty string otherwise. |
is |
BOOLEAN | Yields "1" if the post of this ad was published on Instagram, and an empty string otherwise. |
targeted |
STRING | Describes which are the targeted platforms of this ad. |
targeting |
STRING | A summary of the ad's targeting settings, that may include location, age and language targeting. |
targeting |
STRING | The ad's target user locations |
targeting |
STRING | The ad's target user countries of residence |
targeting |
STRING | The ad's target user ages |
targeting |
STRING | The ad's targeted user languages |
targeting |
STRING | The ad's excluded matches (e.g. excluded interests) |
targeting |
STRING | The ad's targeted users (e.g. interests) |
targeting |
STRING | The ad's target connections (e.g. people who liked the page already) |
targeting |
STRING | The ad's custom audience targeting |
targeting |
STRING | The Ad's placements (e.g. news feed on desktop computers) |
frequency | DECIMAL | The average number of times each person saw the ad. |
impressions | INTEGER | The number of times the ad was on screen. |
clicks | INTEGER | The number of clicks on the ads. |
reach | INTEGER | The number of people who saw the ad at least once. Reach is different from impressions, which may include multiple views of the ad by the same people. |
unique |
INTEGER | The distinct number of people who clicked on the ad. |
unique |
INTEGER | The number of people who performed an inline link click. |
cpm | DECIMAL | The average cost for 1000 impressions of the ad. |
cpp | DECIMAL | The average cost to reach 1000 people with the ad. |
cpc | DECIMAL | The average cost for each click on the ad. |
unique |
DECIMAL | The average cost for each unique click. |
omni |
DECIMAL | The total return on ad spend from omni purchases. |
estimated |
DECIMAL | The rate at which an estimated number of additional people, when asked, would remember seeing your ads within 2 days. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. This metric is estimated and in development. |
estimated |
INTEGER | An estimate of the number of additional people who may remember seeing your ads, if asked, within 2 days. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. This metric is estimated and in development. |
ctr | DECIMAL | The percentage of times people saw the ad and performed a click. |
unique |
DECIMAL | The percentage of people who saw the ad and performed a unique click. |
unique |
DECIMAL | The percentage of people who saw the ad and performed a link click. |
unique |
DECIMAL | TThe percentage of people who saw the ad and performed an outbound click. |
outbound |
DECIMAL | The percentage of times people saw the ad and performed an outbound click. |
website |
DECIMAL | The percentage of times people saw the ad and performed a link click. |
inline |
DECIMAL | The percentage of time people saw the ads and performed an inline link click. |
unique |
DECIMAL | The percentage of times people saw the ad and performed a link click. Inline click-through rate uses a fixed 1-day-click attribution window. |
page (Deprecates October 30, 2024) |
INTEGER | The number of people who engaged with the Facebook Page through the ad. |
post (Deprecates October 30, 2024) |
INTEGER | The number of people who engaged with the ad. |
lead |
INTEGER | The number of times people who took an action 'LEAD' on Facebook that was attributed to your ads. This metric is estimated. |
likes (Deprecates October 30, 2024) |
INTEGER | The number of likes performed on the page through the ad. |
comments (Deprecates October 30, 2024) |
INTEGER | The number of comments left on the post through the ad. |
saves (Deprecates October 30, 2024) |
INTEGER | The number of saves left on the post through the ad. |
video (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed the video through the ad (when relevant). |
link |
INTEGER | The number of clicks on a link through the ad (when relevant). |
link |
INTEGER | The number of people who clicked on a link through the ad (when relevant). |
landing (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed a landing page through the ad (when relevant). |
photo (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed the photo through the ad (when relevant). |
post |
INTEGER | The number of Facebook reactions on the post through the ad. |
post (Deprecates October 30, 2024) |
INTEGER | The unique number of Facebook reactions on the post through the ad. |
post (Deprecates October 30, 2024) |
INTEGER | The number of people who shared the post through the ad. |
mobile (Deprecates October 30, 2024) |
INTEGER | The number of people who installed the mobile app through the ad. |
purchase | INTEGER | The number of purchase events attributed to your ads, based on information received from one or more of your connected Facebook Business Tools. |
unique (Deprecates October 30, 2024) |
INTEGER | The estimated number of people who completed at least one purchase. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who added payment info that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who added to chart that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who added to whitelist an action that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who completed registration that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who took an action that was attributed to your ads which is a custom pixel events defined by the advertiser This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who initiated checkout that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who took an action 'LEAD' that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who took an action 'PURCHASE' that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who took an action 'SEARCH' that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed the content that was attributed to your ads. This metric is estimated. |
unique (Deprecates October 30, 2024) |
INTEGER | The number of people who took an action 'LEAD' on Facebook that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per engagement with the Facebook Page through the ad. |
cost |
DECIMAL | The average cost per engagement with the ad. |
cost |
DECIMAL | The average cost per like on the page through the ad. |
cost |
DECIMAL | The average cost per comment left on the post through the ad. |
cost |
DECIMAL | The average cost per video view through the ad (when relevant). |
cost |
DECIMAL | The average cost per link click through the ad (when relevant). |
cost |
DECIMAL | The average cost per landing page view through the ad (when relevant). |
cost |
DECIMAL | The average cost per photo view through the ad (when relevant). |
cost |
DECIMAL | The average cost per Facebook reaction on the post through the ad. |
cost |
DECIMAL | The average cost per share of the post through the ad. |
cost |
DECIMAL | The average cost per mobile app installation through the ad. |
cost |
DECIMAL | The average cost per number of people who added payment info that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who added to chart that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who added to whitelist an action that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who completed registration that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who took an action that was attributed to your ads which is a custom pixel events defined by the advertiser This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who initiated checkout that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who took an action 'LEAD' that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who took an action 'PURCHASE' that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who took an action 'SEARCH' that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per number of people who viewed the content that was attributed to your ads. This metric is estimated. |
cost |
DECIMAL | The average cost per lead that was attributed to your ads. This metric is estimated. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique engagement with the Facebook Page through the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique engagement with the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per like on the post through the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per comment left on the post through the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique video view through the ad (when relevant). |
cost |
DECIMAL | The average cost per unique link click through the ad (when relevant). |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique landing page view through the ad (when relevant). |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique photo view through the ad (when relevant). |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per Facebook reaction on the post through the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique share of the post through the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique mobile app installation through the ad. |
cost |
DECIMAL | The average cost for each estimated ad recall lift. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. This metric is estimated and in development. |
cost (Deprecates October 30, 2024) |
DECIMAL | The average cost per unique lead that was attributed to your ads. This metric is estimated. |
quality (Deprecates September 12, 2023) |
STRING | A ranking of your ad's perceived quality. Quality is measured using feedback on your ads and the post-click experience. Your ad is ranked against ads that competed for the same audience. |
engagement (Deprecates September 12, 2023) |
STRING | A ranking of your ad's expected engagement rate. Engagement includes all clicks, likes, comments and shares. Your ad is ranked against ads that competed for the same audience. |
conversion (Deprecates September 12, 2023) |
STRING | A ranking of your ad's expected conversion rate. Your ad is ranked against ads with your optimization goal that competed for the same audience. |
actions | OBJECT | The total number of actions people took that are attributed to your ads. Actions may include engagement, clicks or conversions. |
action |
OBJECT | The total value of all conversions attributed to your ads. |
unique |
OBJECT | The number of people who took an action that was attributed to your ads. This metric is estimated. |
costs |
OBJECT | The average cost of a relevant action. |
costs |
OBJECT | The average cost of each unique action. This metric is estimated. |
page |
INTEGER | The number of times people who engaged with the Facebook Page through the campaign. |
post |
INTEGER | The number of times people who engaged with the ad. |
likes |
INTEGER | The number of times likes performed on the page through the campaign. |
comments |
INTEGER | The number of times comments left on the post through the campaign. |
video |
INTEGER | The number of times people who viewed the video through the campaign (when relevant). |
link |
INTEGER | The number of times people who clicked on a link through the campaign (when relevant). |
landing |
INTEGER | The number of times people who viewed a landing page through the campaign (when relevant). |
photo |
INTEGER | The number of times people who viewed the photo through the campaign (when relevant). |
post |
INTEGER | The number of times Facebook reactions on the post through the campaign. |
outbound |
DECIMAL | The number of times people saw the ad and performed an outbound click. |
mobile |
DECIMAL | The number of times people who installed the mobile app through the ad. |
fb |
DECIMAL | The number of times people clicks on save billing information button. |
fb |
DECIMAL | The number of times people clicks on an add to cart button. |
fb |
DECIMAL | The number of times people clicks on an add to wishlist button. |
fb |
DECIMAL | The number of times people submits a completed subscription or signup form. |
fb |
DECIMAL | The number of times people customizes a product. |
fb |
DECIMAL | The number of times people clicks on a checkout button. |
fb |
DECIMAL | The number of times people clicks on pricing. |
fb |
DECIMAL | The number of times people finished the purchase or checkout flow and lands on thank you or confirmation page.The amount of money spent on this ad campaign. |
fb |
DECIMAL | The number of times people searched for a product. |
fb |
DECIMAL | The number of times people lands on a product details page. |
lead |
DECIMAL | The amount of money spent on this ad campaign. |
omni |
DECIMAL | The number of times people has finished the purchase or checkout. |
facebookComments
Summary
Holding public data for comments and their replies created on posts that were posted in the selected time range. Please note that this takes into account the creation time of the commented-on posts and not the creation time of the comment.
Hints
- Some comments might be missing depending on the privacy settings of the users who commented.
- Because of Facebook removing the unique identifier for comments for public data access from Sep 7th 2021 onwards, we are using the published time of a comment as an identifier instead. As a direct result, in cases where there are multiple comments published at the exact same second on a specific post, the oldest comment wins over newer ones.
- Initial imports will cover comments for posts published within the last 3 days.
- Comments are updated for posts published within the last 3 days in a rolling fashion.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this comment was made. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
message | STRING | The main content of this comment (not including attachments). |
link | LINK | A link to this comment or the related post on Facebook. From September 7th, 2021, this will link to the post this comment belongs to because of Facebook removing the unique identifier for comments for public data access. |
external |
STRING | The ID of this comment provided by Facebook. From September 7th, 2021, this will return NULL in all cases because of Facebook removing the unique identifier for comments for public data access. |
external |
STRING | The ID of the post this comment belongs to provided by Facebook. |
user |
STRING | The ID of the author of this comment provided by Facebook. Only available if the author is a Facebook Page. Returns NULL in all other cases. |
user |
STRING | The name of the author of this comment. Only available if the author is a Facebook Page. Returns NULL in all other cases. |
is |
BOOLEAN | Returns true if this is a comment by the Page who created the post this comment belongs to. |
attachment |
LINK | The type of the comment's attachment. Holds NULL if no attachment URL is available. |
attachment |
LINK | The URL of the comment's attachment. Holds NULL if no attachment URL is available. |
attachment |
LINK | The URL to the attachment preview picture. Holds NULL if no attachment preview picture is available. |
post |
DATETIME | The published time of the post this comment belongs to. |
post |
STRING | The contents of the post this comment belongs to. |
post |
LINK | The link to the post this comment belongs to. |
reactions | INTEGER | Number of reactions (Like, Love, Wow, Haha, Sorry and Angry) the comment got. |
replies | INTEGER | Number of replies to this comment. |
facebookInsights
Summary
Holding private-level data for Facebook Pages from Facebook Insights and their development over time. All numbers are aggregates across the whole Facebook Page. Please note that Facebook Insights provide data for only three different intervals: daily, weekly and 28 days and thus for unique metrics like Reach one cannot go beyond 28 day analysis.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by Facebook.
- The monthly interval shows 28 day values as provided by Facebook representing the last 28 days of each month.
- Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
- Facebook updates most metrics once every 24 hours. Columns referencing to metrics refreshing several times a day hold a hint in their column description. Make use of column importTime to know exactly when a data row has been last modified.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
page (Deprecates March 18, 2024) |
INTEGER |
Number of stories created about your Page within the current interval (e.g. a day, week, month). Additional interval specific columns for this metric exist: page_content_activity_day page_content_activity_week page_content_activity_days_28 |
page |
INTEGER |
The number of stories about Page checkins published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_checkin_day page_content_activity_by_action_type_checkin_week page_content_activity_by_action_type_checkin_days_28 |
page |
INTEGER |
The number of stories about offer claims published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_coupon_day page_content_activity_by_action_type_coupon_week page_content_activity_by_action_type_coupon_days_28 |
page |
INTEGER |
The number of stories about RSVPing to events published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_event_day page_content_activity_by_action_type_event_week page_content_activity_by_action_type_event_days_28 |
page |
INTEGER |
The number of stories about Page likes published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_fan_day page_content_activity_by_action_type_fan_week page_content_activity_by_action_type_fan_days_28 |
page |
INTEGER |
The number of stories about Page mentions published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_mention_day page_content_activity_by_action_type_mention_week page_content_activity_by_action_type_mention_days_28 |
page |
INTEGER |
The number of stories about posts by other Pages published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_page_post_day page_content_activity_by_action_type_page_post_week page_content_activity_by_action_type_page_post_days_28 |
page |
INTEGER |
The number of stories about answers to questions published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_question_day page_content_activity_by_action_type_question_week page_content_activity_by_action_type_question_days_28 |
page |
INTEGER |
The number of stories about posts by users on the Page's timeline. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_user_post_day page_content_activity_by_action_type_user_post_week page_content_activity_by_action_type_user_post_days_28 |
page |
INTEGER |
The number of stories about other story types published about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_other_day page_content_activity_by_action_type_other_week page_content_activity_by_action_type_other_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about the Page's Page checkin stories. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_checkin_day page_content_activity_by_action_type_unique_checkin_week page_content_activity_by_action_type_unique_checkin_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about the Page's offer claim stories. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_coupon_day page_content_activity_by_action_type_unique_coupon_week page_content_activity_by_action_type_unique_coupon_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about the Page's RSVPing to event stories. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_event_day page_content_activity_by_action_type_unique_event_week page_content_activity_by_action_type_unique_event_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about the Page's Page like stories. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_fan_day page_content_activity_by_action_type_unique_fan_week page_content_activity_by_action_type_unique_fan_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about the Page's Page mention stories. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_mention_day page_content_activity_by_action_type_unique_mention_week page_content_activity_by_action_type_unique_mention_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about posts by other Pages about the Page. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_page_post_day page_content_activity_by_action_type_unique_page_post_week page_content_activity_by_action_type_unique_page_post_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about the Page's answers to question stories. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_question_day page_content_activity_by_action_type_unique_question_week page_content_activity_by_action_type_unique_question_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about posts by users on the Page's timeline. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_user_post_day page_content_activity_by_action_type_unique_user_post_week page_content_activity_by_action_type_unique_user_post_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
The number of people talking about the Page's other story types. Additional interval specific columns for this metric exist: page_content_activity_by_action_type_unique_other_day page_content_activity_by_action_type_unique_other_week page_content_activity_by_action_type_unique_other_days_28 |
page |
INTEGER |
The number of times any content from the Page or about the Page entered a person's screen. This includes posts, stories, check-ins, ads, social information from people who interact with the Page and more. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_day page_impressions_week page_impressions_days_28 |
page |
INTEGER |
The number of times any content from the Page or about the Page entered a person's screen through paid distribution such as an ad. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_paid_day page_impressions_paid_week page_impressions_paid_days_28 |
page |
INTEGER |
The number of times any content from the Page or about the Page entered a person's screen through unpaid distribution. This includes posts, stories, check-ins, social information from people who interact with the Page and more. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_organic_day page_impressions_organic_week page_impressions_organic_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of Page checkin stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_checkin_day page_impressions_by_story_type_checkin_week page_impressions_by_story_type_checkin_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of offer claim stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_coupon_day page_impressions_by_story_type_coupon_week page_impressions_by_story_type_coupon_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of RSVPing to event stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_event_day page_impressions_by_story_type_event_week page_impressions_by_story_type_event_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of Page like stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_fan_day page_impressions_by_story_type_fan_week page_impressions_by_story_type_fan_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of Page mention stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_mention_day page_impressions_by_story_type_mention_week page_impressions_by_story_type_mention_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of posts by other Pages published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_page_post_day page_impressions_by_story_type_page_post_week page_impressions_by_story_type_page_post_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of answers to question stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_question_day page_impressions_by_story_type_question_week page_impressions_by_story_type_question_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of posts by users on the Page's timeline. Additional interval specific columns for this metric exist: page_impressions_by_story_type_user_post_day page_impressions_by_story_type_user_post_week page_impressions_by_story_type_user_post_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Total impressions of other story types published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_other_day page_impressions_by_story_type_other_week page_impressions_by_story_type_other_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
The number of people who saw Page checkin stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_checkin_day page_impressions_by_story_type_unique_checkin_week page_impressions_by_story_type_unique_checkin_days_28 |
page |
INTEGER |
The number of people who saw offer claim stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_coupon_day page_impressions_by_story_type_unique_coupon_week page_impressions_by_story_type_unique_coupon_days_28 |
page |
INTEGER |
The number of people who saw RSVPing to event stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_event_day page_impressions_by_story_type_unique_event_week page_impressions_by_story_type_unique_event_days_28 |
page |
INTEGER |
The number of people who saw Page like stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_fan_day page_impressions_by_story_type_unique_fan_week page_impressions_by_story_type_unique_fan_days_28 |
page |
INTEGER |
The number of people who saw Page mention stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_mention_day page_impressions_by_story_type_unique_mention_week page_impressions_by_story_type_unique_mention_days_28 |
page |
INTEGER |
The number of people who saw posts by other Pages published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_page_post_day page_impressions_by_story_type_unique_page_post_week page_impressions_by_story_type_unique_page_post_days_28 |
page |
INTEGER |
The number of people who saw answers to question stories published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_question_day page_impressions_by_story_type_unique_question_week page_impressions_by_story_type_unique_question_days_28 |
page |
INTEGER |
The number of people who saw posts by users on the Page's timeline. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_user_post_day page_impressions_by_story_type_unique_user_post_week page_impressions_by_story_type_unique_user_post_days_28 |
page |
INTEGER |
The number of people who saw other story types published about the Page. Additional interval specific columns for this metric exist: page_impressions_by_story_type_unique_other_day page_impressions_by_story_type_unique_other_week page_impressions_by_story_type_unique_other_days_28 |
page |
INTEGER |
Also known as Reach. The number of people who had any content from the Page or about the Page enter their screen. This includes posts, stories, check-ins, ads, social information from people who interact with the Page and more. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_unique_day page_impressions_unique_week page_impressions_unique_days_28 |
page |
INTEGER |
The number of people who had any content from the Page or about the Page enter their screen through paid distribution such as an ad. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_paid_unique_day page_impressions_paid_unique_week page_impressions_paid_unique_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
The number of people who had any content from the Page or about the Page enter their screen through unpaid distribution. This includes posts, stories, check-ins, social information from people who interact with the Page and more. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_organic_unique_day page_impressions_organic_unique_week page_impressions_organic_unique_days_28 |
page |
INTEGER |
The number of people who had any of the Page's posts enter their screen. Posts include statuses, photos, links, videos and more. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_unique_day page_posts_impressions_unique_week page_posts_impressions_unique_days_28 |
page |
INTEGER |
The number of people who had any of the Page's posts enter their screen through paid distribution such as an ad. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_paid_unique_day page_posts_impressions_paid_unique_week page_posts_impressions_paid_unique_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
The number of times the Page's posts entered a person's screen through unpaid distribution. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_organic_day page_posts_impressions_organic_week page_posts_impressions_organic_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
The number of people who had any of the Page's posts enter their screen through unpaid distribution. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_organic_unique_day page_posts_impressions_organic_unique_week page_posts_impressions_organic_unique_days_28 |
page |
INTEGER |
The number of times people have engaged with the Page's posts through reactions, comments, shares and more. For example, this includes when a person clicks to enlarge an image, or clicks to "read more" text. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_post_engagements_day page_post_engagements_week page_post_engagements_days_28 |
page |
INTEGER |
The number of times any content from your Page or about your Page entered a person's screen with social information attached. Social information displays when a person's friend interacted with your Page, post or story. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_viral_day page_impressions_viral_week page_impressions_viral_days_28 |
page |
INTEGER |
The number of people who had any content from your Page or about your Page enter their screen through with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with your Page, post or story. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_viral_unique_day page_impressions_viral_unique_week page_impressions_viral_unique_days_28 |
page |
INTEGER |
The number of times any content from your Page entered a person's screen. This does not include content created about your Page with social information attached. Social information displays when a person's friend interacted with your Page, post or story. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_nonviral_day page_impressions_nonviral_week page_impressions_nonviral_days_28 |
page |
INTEGER |
The number of people who had any content from your Page enter their screen. This does not include content created about your Page with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with your Page, post or story. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_impressions_nonviral_unique_day page_impressions_nonviral_unique_week page_impressions_nonviral_unique_days_28 |
page |
INTEGER |
The number of times the Page's posts entered a person's screen. This does not include content created about the Page with social information attached. Social information displays when a person's friend interacted with you Page or post. This does not include when someone's friend likes or follows the Page, engages with a post, shares a photo of the Page and checks into the Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_nonviral_day page_posts_impressions_nonviral_week page_posts_impressions_nonviral_days_28 |
page |
INTEGER |
The number of people who had any posts by the Page enter their screen. This does not include content created about the Page with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This does not include when someone's friend likes or follows the Page, engages with a post, shares a photo of the Page and checks into the Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_nonviral_unique_day page_posts_impressions_nonviral_unique_week page_posts_impressions_nonviral_unique_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of clicks on the Facebook Page's website link. Additional interval specific columns for this metric exist: page_website_clicks_logged_in_count_day page_website_clicks_logged_in_count_week page_website_clicks_logged_in_count_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of unique people who logged in to Facebook and clicked the goto website CTA (Click to Action) button Additional interval specific columns for this metric exist: page_website_clicks_logged_in_unique_day page_website_clicks_logged_in_unique_week page_website_clicks_logged_in_unique_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who engaged with the Page. Engagement includes any click or story created. Additional interval specific columns for this metric exist: page_engaged_users_day page_engaged_users_week page_engaged_users_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of clicks on any of the Page's content. Stories generated without clicks on page content (e.g., liking the page in Timeline) are not included. Additional interval specific columns for this metric exist: page_consumptions_day page_consumptions_week page_consumptions_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who clicked on any of the Page's content. Stories that are created without clicking on Page content (ex, liking the Page from timeline) are not included. Additional interval specific columns for this metric exist: page_consumptions_unique_day page_consumptions_unique_week page_consumptions_unique_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
The number of times people clicked on any of your content by clicks on links. This e.g. includes clicks on links in the Page's posts. Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_link_clicks_day page_consumptions_by_consumption_type_link_clicks_week page_consumptions_by_consumption_type_link_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of other clicks on the Page's content which doesn't include link clicks, photo views or video plays. Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_other_clicks_day page_consumptions_by_consumption_type_other_clicks_week page_consumptions_by_consumption_type_other_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of clicks on photos the Page got. Clicks on photos always leads to an expanded view of the photo. Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_photo_view_day page_consumptions_by_consumption_type_photo_view_week page_consumptions_by_consumption_type_photo_view_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of clicks on Page's video which played for at least 3 seconds or for nearly their total length if they're shorter than 3 seconds, after people clicked play. During a single instance of a video playing, any time spent replaying the video will be excluded. Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_video_play_day page_consumptions_by_consumption_type_video_play_week page_consumptions_by_consumption_type_video_play_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who clicked on the Page's links. This e.g. includes clicks on links in the Page's posts. Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_unique_link_clicks_day page_consumptions_by_consumption_type_unique_link_clicks_week page_consumptions_by_consumption_type_unique_link_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who clicked on the Page's content which doesn't include link clicks, photo views or video plays. Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_unique_other_clicks_day page_consumptions_by_consumption_type_unique_other_clicks_week page_consumptions_by_consumption_type_unique_other_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who clicked on the Page's photos. Clicks on photos always leads to an expanded view of the photo. Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_unique_photo_view_day page_consumptions_by_consumption_type_unique_photo_view_week page_consumptions_by_consumption_type_unique_photo_view_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who clicked on the Page's videos. Auto-plays on videos aren't included here as they didn't require any clicks Additional interval specific columns for this metric exist: page_consumptions_by_consumption_type_unique_video_play_day page_consumptions_by_consumption_type_unique_video_play_week page_consumptions_by_consumption_type_unique_video_play_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of check-ins at the Page's Place. Only available if checkin functionality is enabled for the Facebook Page. Additional interval specific columns for this metric exist: page_places_checkin_total_day page_places_checkin_total_week page_places_checkin_total_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who checked in at the Page's Place. Only available if checkin functionality is enabled for the Facebook Page. Additional interval specific columns for this metric exist: page_places_checkin_total_unique_day page_places_checkin_total_unique_week page_places_checkin_total_unique_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of check-ins at the Page's Place using mobile devices. Only available if checkin functionality is enabled for the Facebook Page. Additional interval specific columns for this metric exist: page_places_checkin_mobile_day page_places_checkin_mobile_week page_places_checkin_mobile_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who checked in at the Page's Place using mobile devices. Only available if checkin functionality is enabled for the Facebook Page. Additional interval specific columns for this metric exist: page_places_checkin_mobile_unique_day page_places_checkin_mobile_unique_week page_places_checkin_mobile_unique_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of times people have given negative feedback to the Page. This includes clicks on 'Hide post', clicks on 'Hide all', unliking the Page or reporting posts as spam. Additional interval specific columns for this metric exist: page_negative_feedback_day page_negative_feedback_week page_negative_feedback_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who have given negative feedback to the Page. This includes clicks on 'Hide post', clicks on 'Hide all', unliking the Page or reporting posts as spam. Additional interval specific columns for this metric exist: page_negative_feedback_unique_day page_negative_feedback_unique_week page_negative_feedback_unique_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of times people have hidden one of the Page's posts or sponsored posts by clicking on 'Hide post' or 'Hide ad'. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_hide_clicks_day page_negative_feedback_by_type_hide_clicks_week page_negative_feedback_by_type_hide_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of times people have clicked on 'Hide all' on one of the Page's posts or sponsored posts. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_hide_all_clicks_day page_negative_feedback_by_type_hide_all_clicks_week page_negative_feedback_by_type_hide_all_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of times people have unliked the Page. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_unlike_page_clicks_day page_negative_feedback_by_type_unlike_page_clicks_week page_negative_feedback_by_type_unlike_page_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of times people have reported one of the Page's posts as spam. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_report_spam_clicks_day page_negative_feedback_by_type_report_spam_clicks_week page_negative_feedback_by_type_report_spam_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who have hidden one of the Page's posts or sponsored posts on 'Hide post' or 'Hide ad'. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_unique_hide_clicks_day page_negative_feedback_by_type_unique_hide_clicks_week page_negative_feedback_by_type_unique_hide_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who have clicked on 'Hide all' on one of the Page's posts or sponsored posts. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_unique_hide_all_clicks_day page_negative_feedback_by_type_unique_hide_all_clicks_week page_negative_feedback_by_type_unique_hide_all_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who have unliked the Page. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_unique_unlike_page_clicks_day page_negative_feedback_by_type_unique_unlike_page_clicks_week page_negative_feedback_by_type_unique_unlike_page_clicks_days_28 |
page (Deprecates September 16, 2024) |
INTEGER |
Number of people who have reported one of the Page's posts as spam. Additional interval specific columns for this metric exist: page_negative_feedback_by_type_unique_report_spam_clicks_day page_negative_feedback_by_type_unique_report_spam_clicks_week page_negative_feedback_by_type_unique_report_spam_clicks_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of times people have liked one of the Page's stories. Please note this column is not only about the Like reaction, it actually includes the sum of all reactions (Like, Love, Haha, Wow, Sorry, Anger.) Additional interval specific columns for this metric exist: page_positive_feedback_by_type_like_day page_positive_feedback_by_type_like_week page_positive_feedback_by_type_like_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of times people have commented on one of the Page's stories. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_comment_day page_positive_feedback_by_type_comment_week page_positive_feedback_by_type_comment_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of times people have shared one of the Page's stories. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_link_day page_positive_feedback_by_type_link_week page_positive_feedback_by_type_link_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of times people have responded to one of the Page's events. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_rsvp_day page_positive_feedback_by_type_rsvp_week page_positive_feedback_by_type_rsvp_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of times people have claimed one of the Page's offers. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_claim_day page_positive_feedback_by_type_claim_week page_positive_feedback_by_type_claim_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of times people have answered one of the Page's questions. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_answer_day page_positive_feedback_by_type_answer_week page_positive_feedback_by_type_answer_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of times people have given other types of positive feedback, such as checkins. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_other_day page_positive_feedback_by_type_other_week page_positive_feedback_by_type_other_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who have liked one of the Page's stories. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_unique_like_day page_positive_feedback_by_type_unique_like_week page_positive_feedback_by_type_unique_like_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who have commented on one of the Page's stories. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_unique_comment_day page_positive_feedback_by_type_unique_comment_week page_positive_feedback_by_type_unique_comment_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who have shared one of the Page's stories. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_unique_link_day page_positive_feedback_by_type_unique_link_week page_positive_feedback_by_type_unique_link_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who have responded to one of the Page's events. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_unique_rsvp_day page_positive_feedback_by_type_unique_rsvp_week page_positive_feedback_by_type_unique_rsvp_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who have claimed one of the Page's offers. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_unique_claim_day page_positive_feedback_by_type_unique_claim_week page_positive_feedback_by_type_unique_claim_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who have answered one of the Page's questions. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_unique_answer_day page_positive_feedback_by_type_unique_answer_week page_positive_feedback_by_type_unique_answer_days_28 |
page (Deprecates March 18, 2024) |
INTEGER |
Number of people who have given other types of positive feedback, such as checkins. Additional interval specific columns for this metric exist: page_positive_feedback_by_type_unique_other_day page_positive_feedback_by_type_unique_other_week page_positive_feedback_by_type_unique_other_days_28 |
page (Deprecates September 16, 2024) |
INTEGER | Number of people who liked the Page and who were online. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Number of post 'like' and 'care' reactions of the Page including reactions via shares. |
page |
INTEGER | Number of post 'love' reactions of the Page including reactions via shares. |
page |
INTEGER | Number of post 'wow' reactions of the Page including reactions via shares. |
page |
INTEGER | Number of post 'haha' reactions of the Page including reactions via shares. |
page |
INTEGER | Number of post 'sorry' reactions of the Page including reactions via shares. |
page |
INTEGER | Number of post 'anger' reactions of the Page including reactions via shares. |
page |
INTEGER | Total number of clicks on the Page's contact info and call-to-action button. |
page |
INTEGER | Number of Page Likes for this Facebook Page at the end of the current interval (e.g. a day, week, month). A Page must have at least 30 or more fans for this data to be returned. |
page |
INTEGER | Number of Page Likes for this Facebook Page at the beginning of the current interval (e.g. a day, week, month). A Page must have at least 30 or more fans for this data to be returned. |
page |
INTEGER | Change of the total number of Page Likes for this Facebook Page. |
page |
INTEGER | Number of times people have liked the Page. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Number of new people who have liked the Page. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Number of new people who have liked the Page. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Number of new people who have liked the Page from an ad or sponsored post. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Number of new people who have liked the Page excluding likes from a not sponsored post. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Number of times people have unliked the Page. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Number of people who have unliked the Page. This column only supports daily intervals and won't work if you select any other interval. |
page |
INTEGER | Total number of people who have followed the Page. Based on our own research, this number provided via Facebook's Graph API should be considered an estimate and is usually slightly different than the follower count for this Page shown on Facebook itself. |
page |
INTEGER | Total number of people who have followed the Page. Based on our own research, this number provided via Facebook's Graph API should be considered an estimate and is usually slightly different than the follower count for this Page shown on Facebook itself. |
page |
INTEGER | Change of total number of people who have followed the Page. Based on our own research, this number provided via Facebook's Graph API should be considered an estimate and is usually slightly different than the follower count for this Page shown on Facebook itself. |
page |
INTEGER | The number of new people who have followed your Page (Total Count). |
page |
INTEGER | The number of new people who have unfollowed your Page (Total Count). |
page |
INTEGER |
The number of new people who have followed your Page (Unique Users). Additional interval specific columns for this metric exist: page_daily_follows_unique_day page_daily_follows_unique_week page_daily_follows_unique_days_28 |
page |
INTEGER |
The number of new people who have unfollowed your Page (Unique Users). Additional interval specific columns for this metric exist: page_daily_unfollows_unique_day page_daily_unfollows_unique_week page_daily_unfollows_unique_days_28 |
page |
INTEGER | The number of times a Page's profile has been viewed by logged in and logged out people. |
page (Deprecates March 18, 2024) |
INTEGER | The number of people logged in to Facebook who have viewed the Page profile. |
page (Deprecates March 18, 2024) |
INTEGER | The number of times a Page's profile has been viewed by people logged in to Facebook. |
page (Deprecates March 18, 2024) |
INTEGER | The number of times a Page's profile has been viewed by people not logged in to Facebook. |
page |
INTEGER |
The number of times the Page's posts entered a person's screen. Posts include statuses, photos, links, videos and more. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_day page_posts_impressions_week page_posts_impressions_days_28 |
page |
INTEGER |
The number of times the Page's posts entered a person's screen through paid distribution such as an ad. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_paid_day page_posts_impressions_paid_week page_posts_impressions_paid_days_28 |
page |
INTEGER |
The number of times the Page's posts entered a person's screen with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows the Page, engages with a post, shares a photo of the Page and checks into the Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_viral_day page_posts_impressions_viral_week page_posts_impressions_viral_days_28 |
page |
INTEGER |
The number of people who had any of the Page's posts enter their screen with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows the Page, engages with a post, shares a photo of the Page and checks into the Page. Refreshes several times during the day. Additional interval specific columns for this metric exist: page_posts_impressions_viral_unique_day page_posts_impressions_viral_unique_week page_posts_impressions_viral_unique_days_28 |
page |
INTEGER |
Number of people who were served the Page's organic posts in their News Feed, whether it entered their screen or not. This column is only provided by Facebook for comparison reasons and contains data from 2018, January 25th onwards. Read this article for details. Additional interval specific columns for this metric exist: page_posts_served_impressions_organic_unique_day page_posts_served_impressions_organic_unique_week page_posts_served_impressions_organic_unique_days_28 |
page |
INTEGER |
Number of times the Page's videos have been viewed for more than 3 seconds. Additional interval specific columns for this metric exist: page_video_views_day page_video_views_week page_video_views_days_28 |
page |
INTEGER |
The number of times the Page's videos were watched for an aggregate of at least 10 seconds, or for nearly its total length, whichever happened first. Additional interval specific columns for this metric exist: page_video_views_10s_day page_video_views_10s_week page_video_views_10s_days_28 |
page |
INTEGER |
Number of times the Page's videos have been viewed for more than 30 seconds. Additional interval specific columns for this metric exist: page_video_complete_views_30s_day page_video_complete_views_30s_week page_video_complete_views_30s_days_28 |
page |
INTEGER |
Total number of times page's videos have been played for unique people for more than 3 seconds. Additional interval specific columns for this metric exist: page_video_views_unique_day page_video_views_unique_week page_video_views_unique_days_28 |
page |
INTEGER |
The number of times the Page's videos were watched for an aggregate of at least 10 seconds, or for nearly its total length, whichever happened first, by unique users. Additional interval specific columns for this metric exist: page_video_views_10s_unique_day page_video_views_10s_unique_week page_video_views_10s_unique_days_28 |
page |
INTEGER |
Total number of times page's videos have been played for unique people to the end, or viewed for more than 30 seconds. Additional interval specific columns for this metric exist: page_video_complete_views_30s_unique_day page_video_complete_views_30s_unique_week page_video_complete_views_30s_unique_days_28 |
page |
INTEGER |
Total number of times page's promoted videos have been viewed for more than 3 seconds. Additional interval specific columns for this metric exist: page_video_views_paid_day page_video_views_paid_week page_video_views_paid_days_28 |
page |
INTEGER |
The number of times the Page's videos with paid activity were watched for at least a total of 10 seconds, or for nearly their total length, whichever happened first. Additional interval specific columns for this metric exist: page_video_views_10s_paid_day page_video_views_10s_paid_week page_video_views_10s_paid_days_28 |
page |
INTEGER |
Total number of times page's promoted videos have been viewed to the end, or for more than 30 seconds. Additional interval specific columns for this metric exist: page_video_complete_views_30s_paid_day page_video_complete_views_30s_paid_week page_video_complete_views_30s_paid_days_28 |
page |
INTEGER |
Total number of times page's videos have been viewed for more than 3 seconds by organic reach. Additional interval specific columns for this metric exist: page_video_views_organic_day page_video_views_organic_week page_video_views_organic_days_28 |
page |
INTEGER |
The number of times the Page's videos were watched without any paid distribution for at least a total of 10 seconds, or for nearly their total length, whichever happened first. Additional interval specific columns for this metric exist: page_video_views_10s_organic_day page_video_views_10s_organic_week page_video_views_10s_organic_days_28 |
page |
INTEGER |
Total number of times page's videos have been viewed to the end, or viewed for more than 30 seconds by organic reach. Additional interval specific columns for this metric exist: page_video_complete_views_30s_organic_day page_video_complete_views_30s_organic_week page_video_complete_views_30s_organic_days_28 |
page |
INTEGER |
Total number of times page's autoplayed videos have been viewed for more than 3 seconds. Additional interval specific columns for this metric exist: page_video_views_autoplayed_day page_video_views_autoplayed_week page_video_views_autoplayed_days_28 |
page |
INTEGER |
The number of times the Page's videos were started automatically and watched for at least a total of 10 seconds, or for nearly their total length, whichever happened first. Additional interval specific columns for this metric exist: page_video_views_10s_autoplayed_day page_video_views_10s_autoplayed_week page_video_views_10s_autoplayed_days_28 |
page |
INTEGER |
Total number of times page's autoplayed videos have been viewed to the end, or viewed for more than 30 seconds. Additional interval specific columns for this metric exist: page_video_complete_views_30s_autoplayed_day page_video_complete_views_30s_autoplayed_week page_video_complete_views_30s_autoplayed_days_28 |
page |
INTEGER |
Total number of times page's videos have been viewed after the user clicks on play for more than 3 seconds. Additional interval specific columns for this metric exist: page_video_views_click_to_play_day page_video_views_click_to_play_week page_video_views_click_to_play_days_28 |
page |
INTEGER |
The number of times the Page's videos were started by clicking the play button and watched for at least a total of 10 seconds, or for nearly their total length, whichever happened first. Additional interval specific columns for this metric exist: page_video_views_10s_click_to_play_day page_video_views_10s_click_to_play_week page_video_views_10s_click_to_play_days_28 |
page |
INTEGER |
Total number of times page's videos have been viewed to the end, or viewed after the user clicks on play for more than 30 seconds. Additional interval specific columns for this metric exist: page_video_complete_views_30s_click_to_play_day page_video_complete_views_30s_click_to_play_week page_video_complete_views_30s_click_to_play_days_28 |
page |
INTEGER |
Total number of times that people replay a page's videos for more than 3 seconds. Additional interval specific columns for this metric exist: page_video_repeat_views_day page_video_repeat_views_week page_video_repeat_views_days_28 |
page |
INTEGER |
The number of times the Page's videos were replayed for at least 10 seconds, or for nearly its total length, whichever happened first. Additional interval specific columns for this metric exist: page_video_views_10s_repeat_day page_video_views_10s_repeat_week page_video_views_10s_repeat_days_28 |
page |
INTEGER |
Total number of times that people replay a page's videos to the end, or for more than 30 seconds. Additional interval specific columns for this metric exist: page_video_complete_views_30s_repeat_views_day page_video_complete_views_30s_repeat_views_week page_video_complete_views_30s_repeat_views_days_28 |
page |
INTEGER | The total amount of time (in milliseconds) people spent watching videos on the Page. |
page (Deprecates March 18, 2024) |
OBJECT | The number of People Talking About the Page by user age and gender. This number is an estimate. |
page (Deprecates September 16, 2024) |
OBJECT | The number of people who saw any content by your Page or about your Page, grouped by age and gender. This number is an estimate. |
page (Deprecates March 18, 2024) |
OBJECT | Gender and age of people who checked in at your Place. |
page (Deprecates March 18, 2024) |
OBJECT | Number of people who logged in to Facebook and clicked the Call Now button, broken down by age and gender group. |
page (Deprecates March 18, 2024) |
OBJECT | Number of people who logged in to Facebook and clicked the Get Directions button, broken down by age and gender group. |
page (Deprecates March 18, 2024) |
OBJECT | Number of people who logged in to Facebook and clicked the goto website CTA button, broken down by age and gender group. |
page (Deprecates March 18, 2024) |
OBJECT | The number of likes of your Facebook Page by gender and age. This metric is estimated. |
page (Deprecates March 18, 2024) |
OBJECT | Number of Page Likes for this Facebook Page at the beginning of the current interval (e.g. a day, week, month). A Page must have at least 30 or more fans for this data to be returned. This metric is estimated. |
page (Deprecates March 18, 2024) |
OBJECT | Change of the total number of Page Likes for this Facebook Page by gender and age. This metric is estimated. |
page (Deprecates March 18, 2024) |
OBJECT | Share of the total number of Page Likes for this Facebook Page by gender and age. This metric is estimated. |
page (Deprecates March 18, 2024) |
OBJECT | This is a breakdown of the number of Page likes from the most common places where people can like your Page. (See possible types) |
page (Deprecates March 18, 2024) |
OBJECT | The total amount of time (in milliseconds) people spent watching videos on the Page. (See possible types) |
page (Deprecates March 18, 2024) |
OBJECT | TThe number of people who unliked your Page, broken down by the most common ways people can unlike your Page. |
page (Deprecates March 18, 2024) |
OBJECT | Top referrering external domains sending traffic to your Page. |
page (Deprecates March 18, 2024) |
OBJECT | The number of people logged in to Facebook who have viewed your Page profile, broken down by gender group.. |
facebookInsightsByCity
Summary
Holding the number of Page Likes, Reach and People Talking About This of Facebook Pages per city including their development over time.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by Facebook.
- The monthly interval shows 28 day values as provided by Facebook representing the last 28 days of each month.
- Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
city |
STRING | Name of the city. |
city |
DECIMAL | Latitude of the city. |
city |
DECIMAL | Longitude of the city. |
city |
STRING | Code of the country this city belongs to, following ISO 3166 standard. |
city |
STRING | The full name of the country this city belongs to, e.g. Germany. |
fans | INTEGER | Number of Page Likes for this Facebook Page at the end of the interval (e.g. a day, week, month). |
fans |
INTEGER | Number of Page Likes for this Facebook Page at the beginning of the interval (e.g. a day, week, month). |
fans |
INTEGER | Change of the total number of Page Likes for this Facebook Page between the beginning and the end of the interval. |
fans |
DECIMAL | The share of Page Likes for this entry in relation to all Page Likes for this Facebook Page at the end of the interval represented as a percentage (0-100 scale). |
reach (Deprecates September 16, 2024) |
INTEGER | The number of people who have seen any content associated with your Page in the current interval. |
ptat (Deprecates March 18, 2024) |
INTEGER | The number of People Talking About the Page in the current interval. |
facebookInsightsByCountry
Summary
Holding the number of Page Likes, Reach and People Talking About This of Facebook Pages per country including their development over time.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by Facebook.
- The monthly interval shows 28 day values as provided by Facebook representing the last 28 days of each month.
- Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
country |
STRING | The code of the country following ISO 3166 standard. |
country |
STRING | The full name of the country, e.g. Germany. |
fans | INTEGER | Number of Page Likes for this Facebook Page at the end of the interval (e.g. a day, week, month). |
fans |
INTEGER | Number of Page Likes for this Facebook Page at the beginning of the interval (e.g. a day, week, month). |
fans |
INTEGER | Change of the total number of Page Likes for this Facebook Page between the beginning and the end of the interval. |
fans |
DECIMAL | The share of Page Likes for this entry in relation to all Page Likes for this Facebook Page at the end of the interval represented as a percentage (0-100 scale). |
reach (Deprecates September 16, 2024) |
INTEGER | The number of people who have seen any content associated with your Page in the current interval. |
ptat (Deprecates March 18, 2024) |
INTEGER | The number of People Talking About the Page in the current interval. |
facebookInsightsByGenderAndAge
Summary
Holding the number of Page Likes, Reach and People Talking About This of Facebook Pages per gender and age bucket including their development over time.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by Facebook.
- The monthly interval shows 28 day values as provided by Facebook representing the last 28 days of each month.
- Demographic metrics, such as age, gender, and location, are only returned if there is data for 100 or more people.
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
gender | ENUM | Either "Male", "Female" or "Unknown". |
age |
ENUM | The age range in years. Typically the following ranges are shown: "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" and "65+". |
fans (Deprecates March 18, 2024) |
INTEGER | Number of Page Likes for this Facebook Page at the end of the interval (e.g. a day, week, month). |
fans (Deprecates March 18, 2024) |
INTEGER | Number of Page Likes for this Facebook Page at the beginning of the interval (e.g. a day, week, month). |
fans (Deprecates March 18, 2024) |
INTEGER | Change of the total number of Page Likes for this Facebook Page between the beginning and the end of the interval. |
fans (Deprecates March 18, 2024) |
DECIMAL | The share of Page Likes for this entry in relation to all Page Likes for this Facebook Page at the end of the interval represented as a percentage (0-100 scale). |
reach (Deprecates September 16, 2024) |
INTEGER | The number of people who have seen any content associated with your Page in the current interval. |
ptat (Deprecates March 18, 2024) |
INTEGER | The number of People Talking About the Page in the current interval. |
facebookInsightsConversations
Summary
Holding private conversations of Facebook Pages. A conversation includes private messages between the Facebook Page and a specific Facebook user. Please note that there can be multiple conversations per user as Facebook splits into separate conversations if there is a new incoming request by a user after a long time. Messages within a conversation are kept separately within the facebookInsightsConversationMessages data source.
Hints
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this conversation started. |
updated |
DATETIME | The time this conversation on Facebook was updated the last time. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
conversation |
STRING | The ID of the conversation provided by Facebook concatenated with a running number per conversation with a user, e.g. <Facebook's conversation id>_1 for the first conversation with this user. |
folder | STRING | The folder the conversation is located. |
link | LINK | The link to this conversation on Facebook. |
user |
STRING | The name of the author. |
user |
STRING | The ID of the author provided by Facebook. |
message |
INTEGER | The number of messages within the conversation, including both messages from the user and the Facebook Page. |
page |
INTEGER | The number of messages by the Facebook Page within the conversation. |
user |
INTEGER | The number of messages by the user within the conversation. |
response |
DATETIME | Holding the full date and time information when the first reply by the Facebook Page was sent. If the Page started the conversation by privately replying to a user's comment on one of the Page's posts this would show "null" as we don't get the created time of the comment. |
second |
DATETIME | Holding the full date and time information when the second reply by the Facebook Page was sent. If the Page started the conversation by privately replying to a user's comment on one of the Page's posts this would show "null" as we don't get the created time of the comment. |
time |
INTEGER | The time from the creation of the initial user message until the first reply of the Facebook Page in seconds. If the Page started the conversation by privately replying to a user's comment on one of the Page's posts this would show "null" as we don't get the created time of the comment. |
second |
INTEGER | The time from the creation of the initial user message until the second reply of the Facebook Page in seconds. If the Page started the conversation by privately replying to a user's comment on one of the Page's posts this would show "null" as we don't get the created time of the comment. |
initial |
STRING | The contents of the initial message by the user. If the Page privately replied to a comment on one of it's posts it will show the text of the comment. |
first |
STRING | The contents of the first reply by the Facebook Page. |
second |
STRING | The contents of the second reply by the Facebook Page. |
was |
BOOLEAN | If conversation was started by the Page, privately replying to a user's comment on one of the Page's posts. Holds "1" if conversation was initiated by private reply to comment, "" if not. |
unread |
INTEGER | Number of unread message in the conversations. |
participants | OBJECT | People and Pages who are on this conversation. Provided as a list of objects, e.g. [{"id" => STRING, "name" => STRING}, ...]. |
facebookInsightsConversationMessages
Summary
Holding private messages of Facebook Pages. Messages are filtered by the time the related conversation started.
Hints
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this message was created. |
conversation |
DATETIME | The time the conversation this message belongs to started. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
id | STRING | The ID of this message. |
conversation |
STRING | The ID of the conversation this message belongs to. This can be used to join with the facebookInsightsConversations data source. |
message | STRING | The content of this message. |
sender | OBJECT | The user or Facebook Page who created this message. Provided as an object, e.g. {"id" => STRING, "name" => STRING}. |
recipient | OBJECT | The user or Facebook Page who received this message. Provided as an object, e.g. {"id" => STRING, "name" => STRING}. |
facebookInsightsOwnPosts
Summary
Holding information about published posts of Facebook Pages.
Hints
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
- Facebook updates most metrics once every 24 hours. Columns referencing to metrics refreshing several times a day hold a hint in their column description. Make use of column importTime to know exactly when a post has been last modified.
- Facebook does not provide any insights data for Reel posts shared on the news feed.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was published. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
is |
BOOLEAN | This shows if the post is published. |
is |
BOOLEAN | This shows if the post is hidden. |
type | ENUM | The type of the post. |
link | LINK | The link to the post. |
message | STRING | The contents of the post message. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
mentions | OBJECT | The tagged users or Facebook Pages within the post's message. Provided as a list of objects, e.g. [{"id": "128340270541979", "name": "quintly", "type": "Page", "offset": 10, "length": 7}, ...]. |
hashtags | OBJECT | The hashtags used within the post's message. Provided as a list of strings, e.g. ["#hashtag1", "#hashtag2"]. |
story | STRING | Text of the accompanying story shown on Facebook. E.g., "BMW posted a video to playlist BMW TODAY." |
is |
BOOLEAN | Describes if the post is an co-author post. |
is |
BOOLEAN | Indicates if post is owned by the page. An example for a non-owned post is a co-authored post. |
external |
STRING | The unique id of the post. |
internal |
STRING | The quintly internal ID of this post. |
object |
STRING | The unique id of the object in the post. The ID of any uploaded photo or video attached to the post. |
parent |
STRING | The unique id of a parent post of the post, if it exists. For example, if this is a shared post, this field will be the unique id of the original post that was shared. |
app |
STRING | The id of the third party app which was used to publish the post. Returns NULL if the post wasn't published via a third party app. |
app |
STRING | The name of the third party app which was used to publish the post. Returns NULL if the post wasn't published via a third party app. |
likes | INTEGER | Number of "Like" and "Care" reactions the post got. This does not include reactions on shares. |
love | INTEGER | Number of "Love" reactions the post got. This does not include reactions on shares. |
wow | INTEGER | Number of "Wow" reactions the post got. This does not include reactions on shares. |
haha | INTEGER | Number of "Haha" reactions the post got. This does not include reactions on shares. |
sad | INTEGER | Number of "Sorry" reactions the post got. This does not include reactions on shares. |
angry | INTEGER | Number of "Angry" reactions the post got. This does not include reactions on shares. |
thankful | INTEGER | Number of "Thankful" reactions the post got. This does not include reactions on shares. |
comments | INTEGER | Number of comments the post got. This does not include comments on shares. |
shares | INTEGER | Number of shares the post got. This does not include shares of shares. |
fans | INTEGER | Number of fans the page had on the day the post was published. |
followers | INTEGER | Number of followers the page had on the day the post was published. |
admin |
STRING | The name of the Facebook user or application who created the post for the page. If the page has only one admin, no data will be returned. |
admin |
INTEGER | The user id of the Facebook user or application who created the post for the page. If the page has only one admin, no data will be returned. |
attachment |
STRING | The name of the post's attachment. |
attachment |
STRING | The description of the link in this post (appears beneath the attachment's caption). |
attachment |
STRING | The caption of the link in this post. If this is a shared post the value will be null. |
attachment |
LINK | The URL of the post's attachment. |
attachment |
LINK | The URL to the attachment preview picture. |
privacy | STRING | Holds information about the targeting of the post. If the post is not targeted it will show "Public". |
is |
BOOLEAN | If the posted video was live or not. |
is |
BOOLEAN | If the posted audio was live or not. |
is |
BOOLEAN | If the post is a shared post or not. |
is |
BOOLEAN | If the post contains a 360 degree photo/video or not. If the post is a shared 360 degree photo/video, Facebook can not detect whether the original post contains 360 degree content. |
post |
INTEGER | Number of "Like" and "Care" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Love" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Wow" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Haha" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Sorry" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Anger" reactions the post got. This also includes reactions on shares. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have liked the Page and clicked anywhere in the post. |
post |
INTEGER | Number of times this post entered a person's screen. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen. This is also known as reach. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen through unpaid distribution. Refreshes several times during the day. |
post |
INTEGER | Number of people who saw the Page post in news feed or ticker, or on the Page's timeline. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen through paid distribution such as an ad. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen through paid distribution such as an ad. This is also known as paid reach. Refreshes several times during the day. |
post |
INTEGER | Number of impressions for this post by people who have liked your Page. Refreshes several times during the day. |
post |
INTEGER | Number of people who like your Page and who saw this post. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of impressions for this post by people who like your Page in an Ad or Sponsored Story. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of people who like your Page and saw this post in an Ad or Sponsored Story. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen with social information attached. Social information displays when a person's friend interacted with your Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen. This does not include content created about your Page with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen. This does not include content created about your Page with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of times people clicked on anywhere in this post without generating a story. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked anywhere in your post without generating a story. Refreshes several times during the day. |
post |
INTEGER | Number of clicks on links in the post. Refreshes several times during the day. |
post |
INTEGER | Number of clicks on photo attachments in the post which led to an expanded view of the photo. Refreshes several times during the day. |
post |
INTEGER | Number of clicks on video attachments in the post which started the video. Refreshes several times during the day. |
post |
INTEGER | Number of other clicks on the post which doesn't include link clicks, photo views or video plays. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on links in the post. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on photo attachments in the post which led to an expanded view of the photo. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on video attachments in the post which started the video. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on the post which doesn't include link clicks, photo views or video plays. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of unique people who engaged in certain ways with the Page post, for example by commenting on, liking, sharing, or clicking upon particular elements of the post. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post. This includes clicks on 'Hide post' or reporting the post as spam. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post. This includes clicks on 'Hide post' or reporting the post as spam. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by clicking on 'Hide post'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by clicking on 'Hide All'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by unliking the page. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by reporting the post as spam. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by clicking on 'Hide post'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by clicking on 'Hide All'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by unliking the page. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by reporting the post as spam. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of post stories generated about this post. Post stories are created when a user engages with a post. For example a post story "User commented..." is created when a user comments a post. Facebook does not provide an exact definition of what engagement types create post stories, which is why we recommend using more specific engagement metrics instead, e.g. post_activity_by_action_type_like. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of people who created post stories about this post. Post stories are created when a user engages with a post. For example a post story "User commented..." is created when a user comments a post. Facebook does not provide an exact definition of what engagement types create post stories, which is why we recommend using more specific engagement metrics instead, e.g. post_activity_by_action_type_unique_like. Refreshes several times during the day. |
post |
INTEGER | Number of reactions the post got (Like, Love, Wow, Haha, Sorry and Angry). This also includes reactions on shares. Refreshes several times during the day. |
post |
INTEGER | Number of comments the post got. This also includes comments on shares. Refreshes several times during the day. |
post |
INTEGER | Number of shares the post got. This also includes shares on shares. Refreshes several times during the day. |
post |
INTEGER | Number of people who reacted to this post (Like, Love, Wow, Haha, Sorry and Angry). This also includes reactions on shares. Refreshes several times during the day. |
post |
INTEGER | Number of people who commented this post. This also includes comments on shares. Refreshes several times during the day. |
post |
INTEGER | Number of people who shared this post. This also includes shares on shares. Refreshes several times during the day. |
post |
INTEGER | The average time, in milliseconds, people viewed this video. Only available for videos created after August 25th 2016. Returns 0 for reshared videos. |
post |
INTEGER | The total time, in milliseconds, this video played, including videos played for less than 3 seconds and replays. Returns 0 for reshared videos. |
post |
INTEGER | The total time, in milliseconds, this video played by organic reach. Returns 0 for reshared videos. |
post |
INTEGER | Length of a video post (in milliseconds). |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds. This includes live views. |
post |
INTEGER | Number of people who viewed this video for more than 3 seconds. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds without any paid promotion. |
post |
INTEGER | Number of people who viewed this video for more than 3 seconds without any paid promotion. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds after paid promotion. |
post |
INTEGER | Number of people who viewed this video for more than 3 seconds after paid promotion. |
post |
INTEGER | Number of times people clicked to play this video and viewed it more than 3 seconds. |
post |
INTEGER | Number of times this video started automatically playing and people viewed it for more than 3 seconds. |
post |
INTEGER | Number of times this video sound was turned on and was viewed for 3 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of times this video was viewed for 10 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of people who viewed this video for 10 seconds or to the end, whichever came first. |
post |
INTEGER | Number of times this video was viewed for 10 seconds or viewed to the end, whichever came first, after a paid promotion. |
post |
INTEGER | Number of times this video was viewed for 10 seconds or viewed to the end, whichever came first, without a paid promotion. |
post |
INTEGER | Number of times people clicked to play this video and viewed it for 10 seconds or to the end, whichever came first. |
post |
INTEGER | Number of times this video started automatically playing and people viewed it for 10 seconds or to the end, whichever came first. |
post |
INTEGER | Number of times this video sound was turned on and was viewed for 10 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of times this video was viewed for 15 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of times this video was viewed for at least 60 seconds or viewed to the end, whichever came first. This metric is counted only for videos that are 60 seconds or longer. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds in the original post. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds in a shared post. |
post |
INTEGER | Number of times this video was viewed for 30 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of people who viewed this video for 30 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of times this promoted video played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, after people clicked play. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video automatically played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video played from the beginning to 95%, or more, of its length, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of people who viewed this video from the beginning to 95%, or more, of its length, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this promoted video played from the beginning to 95%, or more, of its length. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of people who viewed this promoted video from the beginning to 95%, or more, of its length. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. |
post |
DECIMAL | An estimate of the amount you earned from ad breaks in your videos, in U.S. cents, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments. |
post |
INTEGER | The total number of times an ad was shown during ad breaks in your videos. |
post |
DECIMAL | The average amount paid by advertisers for 1,000 impressions of their ads in your video, in U.S. cents. This number also includes the amount paid to Facebook. |
post |
INTEGER | Total time spent an audio was listened. For non-audio post the value will be null. |
post |
INTEGER | Number of times an audio was listened for more than 3 seconds with sound on. For non-audio post the value will be null. |
facebookInsightsExpiredPosts
Summary
Holding information about expired video posts of Facebook Pages.
Hints
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
- Facebook updates most metrics once every 24 hours. Columns referencing to metrics refreshing several times a day hold a hint in their column description. Make use of column importTime to know exactly when a post has been last modified.
- Facebook does not provide any insights data for Reel posts shared on the news feed.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was published. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
expire |
DATETIME | The time this posting has expired. |
object |
STRING | The ID of any uploaded photo or video attached to the post. |
type | ENUM | The type of the post. |
link | LINK | The link to the post. |
message | STRING | The contents of the post message. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
mentions | OBJECT | The tagged users or Facebook Pages within the post's message. Provided as a list of objects, e.g. [{"id": "128340270541979", "name": "quintly", "type": "Page", "offset": 10, "length": 7}, ...]. |
hashtags | OBJECT | The hashtags used within the post's message. Provided as a list of strings, e.g. ["#hashtag1", "#hashtag2"]. |
story | STRING | Text of the accompanying story shown on Facebook. E.g., "BMW posted a video to playlist BMW TODAY." |
is |
BOOLEAN | Describes if the post is an co-author post. |
is |
BOOLEAN | Indicates if post is owned by the page. An example for a non-owned post is a co-authored post. |
external |
STRING | The unique id of the post. |
internal |
STRING | The quintly internal ID of this post. |
app |
STRING | The id of the third party app which was used to publish the post. Returns NULL if the post wasn't published via a third party app. |
app |
STRING | The name of the third party app which was used to publish the post. Returns NULL if the post wasn't published via a third party app. |
likes | INTEGER | Number of "Like" and "Care" reactions the post got. This does not include reactions on shares. |
love | INTEGER | Number of "Love" reactions the post got. This does not include reactions on shares. |
wow | INTEGER | Number of "Wow" reactions the post got. This does not include reactions on shares. |
haha | INTEGER | Number of "Haha" reactions the post got. This does not include reactions on shares. |
sad | INTEGER | Number of "Sorry" reactions the post got. This does not include reactions on shares. |
angry | INTEGER | Number of "Angry" reactions the post got. This does not include reactions on shares. |
thankful | INTEGER | Number of "Thankful" reactions the post got. This does not include reactions on shares. |
comments | INTEGER | Number of comments the post got. This does not include comments on shares. |
shares | INTEGER | Number of shares the post got. This does not include shares of shares. |
fans | INTEGER | Number of fans the page had on the day the post was published. |
followers | INTEGER | Number of followers the page had on the day the post was published. |
admin |
STRING | The name of the Facebook user or application who created the post for the page. If the page has only one admin, no data will be returned. |
admin |
INTEGER | The user id of the Facebook user or application who created the post for the page. If the page has only one admin, no data will be returned. |
attachment |
STRING | The name of the post's attachment. |
attachment |
STRING | The description of the link in this post (appears beneath the attachment's caption). |
attachment |
STRING | The caption of the link in this post. If this is a shared post the value will be null. |
attachment |
LINK | The URL of the post's attachment. |
attachment |
LINK | The URL to the attachment preview picture. |
privacy | STRING | Holds information about the targeting of the post. If the post is not targeted it will show "Public". |
is |
BOOLEAN | If the posted video was live or not. |
is |
BOOLEAN | If the posted audio was live or not. |
is |
BOOLEAN | If the post is a shared post or not. |
is |
BOOLEAN | If the post contains a 360 degree photo/video or not. If the post is a shared 360 degree photo/video, Facebook can not detect whether the original post contains 360 degree content. |
post |
INTEGER | Number of "Like" and "Care" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Love" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Wow" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Haha" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Sorry" reactions the post got. This also includes reactions on shares. |
post |
INTEGER | Number of "Anger" reactions the post got. This also includes reactions on shares. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have liked the Page and clicked anywhere in the post. |
post |
INTEGER | Number of times this post entered a person's screen. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen. This is also known as reach. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen through unpaid distribution. Refreshes several times during the day. |
post |
INTEGER | Number of people who saw the Page post in news feed or ticker, or on the Page's timeline. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen through paid distribution such as an ad. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen through paid distribution such as an ad. This is also known as paid reach. Refreshes several times during the day. |
post |
INTEGER | Number of impressions for this post by people who have liked your Page. Refreshes several times during the day. |
post |
INTEGER | Number of people who like your Page and who saw this post. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of impressions for this post by people who like your Page in an Ad or Sponsored Story. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of people who like your Page and saw this post in an Ad or Sponsored Story. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen with social information attached. Social information displays when a person's friend interacted with your Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of times this post entered a person's screen. This does not include content created about your Page with social information attached. Social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of people who had this post enter their screen. This does not include content created about your Page with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with you Page or post. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. Refreshes several times during the day. |
post |
INTEGER | Number of times people clicked on anywhere in this post without generating a story. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked anywhere in your post without generating a story. Refreshes several times during the day. |
post |
INTEGER | Number of clicks on links in the post. Refreshes several times during the day. |
post |
INTEGER | Number of clicks on photo attachments in the post which led to an expanded view of the photo. Refreshes several times during the day. |
post |
INTEGER | Number of clicks on video attachments in the post which started the video. Refreshes several times during the day. |
post |
INTEGER | Number of other clicks on the post which doesn't include link clicks, photo views or video plays. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on links in the post. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on photo attachments in the post which led to an expanded view of the photo. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on video attachments in the post which started the video. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who clicked on the post which doesn't include link clicks, photo views or video plays. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of unique people who engaged in certain ways with the Page post, for example by commenting on, liking, sharing, or clicking upon particular elements of the post. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post. This includes clicks on 'Hide post' or reporting the post as spam. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post. This includes clicks on 'Hide post' or reporting the post as spam. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by clicking on 'Hide post'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by clicking on 'Hide All'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by unliking the page. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of times people have given negative feedback to the post by reporting the post as spam. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by clicking on 'Hide post'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by clicking on 'Hide All'. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by unliking the page. Refreshes several times during the day. |
post (Deprecates September 16, 2024) |
INTEGER | Number of people who have given negative feedback to the post by reporting the post as spam. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of post stories generated about this post. Post stories are created when a user engages with a post. For example a post story "User commented..." is created when a user comments a post. Facebook does not provide an exact definition of what engagement types create post stories, which is why we recommend using more specific engagement metrics instead, e.g. post_activity_by_action_type_like. Refreshes several times during the day. |
post (Deprecates March 20, 2024) |
INTEGER | Number of people who created post stories about this post. Post stories are created when a user engages with a post. For example a post story "User commented..." is created when a user comments a post. Facebook does not provide an exact definition of what engagement types create post stories, which is why we recommend using more specific engagement metrics instead, e.g. post_activity_by_action_type_unique_like. Refreshes several times during the day. |
post |
INTEGER | Number of reactions the post got (Like, Love, Wow, Haha, Sorry and Angry). This also includes reactions on shares. Refreshes several times during the day. |
post |
INTEGER | Number of comments the post got. This also includes comments on shares. Refreshes several times during the day. |
post |
INTEGER | Number of shares the post got. This also includes shares on shares. Refreshes several times during the day. |
post |
INTEGER | Number of people who reacted to this post (Like, Love, Wow, Haha, Sorry and Angry). This also includes reactions on shares. Refreshes several times during the day. |
post |
INTEGER | Number of people who commented this post. This also includes comments on shares. Refreshes several times during the day. |
post |
INTEGER | Number of people who shared this post. This also includes shares on shares. Refreshes several times during the day. |
post |
INTEGER | The average time, in milliseconds, people viewed this video. Only available for videos created after August 25th 2016. Returns 0 for reshared videos. |
post |
INTEGER | The total time, in milliseconds, this video played, including videos played for less than 3 seconds and replays. Returns 0 for reshared videos. |
post |
INTEGER | The total time, in milliseconds, this video played by organic reach. Returns 0 for reshared videos. |
post |
INTEGER | Length of a video post (in milliseconds). |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds. This includes live views. |
post |
INTEGER | Number of people who viewed this video for more than 3 seconds. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds without any paid promotion. |
post |
INTEGER | Number of people who viewed this video for more than 3 seconds without any paid promotion. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds after paid promotion. |
post |
INTEGER | Number of people who viewed this video for more than 3 seconds after paid promotion. |
post |
INTEGER | Number of times people clicked to play this video and viewed it more than 3 seconds. |
post |
INTEGER | Number of times this video started automatically playing and people viewed it for more than 3 seconds. |
post |
INTEGER | Number of times this video sound was turned on and was viewed for 3 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of times this video was viewed for 10 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of people who viewed this video for 10 seconds or to the end, whichever came first. |
post |
INTEGER | Number of times this video was viewed for 10 seconds or viewed to the end, whichever came first, after a paid promotion. |
post |
INTEGER | Number of times this video was viewed for 10 seconds or viewed to the end, whichever came first, without a paid promotion. |
post |
INTEGER | Number of times people clicked to play this video and viewed it for 10 seconds or to the end, whichever came first. |
post |
INTEGER | Number of times this video started automatically playing and people viewed it for 10 seconds or to the end, whichever came first. |
post |
INTEGER | Number of times this video sound was turned on and was viewed for 10 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds in the original post. |
post |
INTEGER | Number of times this video was viewed for more than 3 seconds in a shared post. |
post |
INTEGER | Number of times this video was viewed for 30 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of people who viewed this video for 30 seconds or viewed to the end, whichever came first. |
post |
INTEGER | Number of times this promoted video played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds, after people clicked play. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video automatically played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this video played from the beginning to 95%, or more, of its length, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of people who viewed this video from the beginning to 95%, or more, of its length, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of times this promoted video played from the beginning to 95%, or more, of its length. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. Returns 0 for reshared videos. |
post |
INTEGER | Number of people who viewed this promoted video from the beginning to 95%, or more, of its length. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. |
facebookInsightsPostAuthors
Summary
Holding information about authors of posts.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
id | STRING | The external id of the Facebook Business User, User or Application who created posts for the selected Pages. Only includes authors of Pages with more than one admin. |
name | STRING | The name of the Facebook Business User, User or Application who created posts for the selected Pages. Only includes authors of Pages with more than one admin. |
posts | OBJECT | The posts created by this author in the selected time period. Provided as a list of objects, e.g. [{"profileId": 92, "postId": "128340270541979_3180363705339605"}, ...]. |
facebookInsightsOwnVideos
Summary
Holding information about videos of Facebook Pages. This is similar to data source facebookInsightsOwnPosts, but showing video posts only while offering more specific video metrics.
Hints
- This data source returns video posts, multiple posts potentially using the same video. Be aware that while there is one entry per post, video metrics belong to the video, not the post. Thus multiple posts using the same video will show the exact same numbers.
- Facebook Reels are not included. Use data source facebookInsightsReels to access Facebook Reels.
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this video was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
expire |
DATETIME | The time this posting has expired. |
external |
STRING | The unique id of the video. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | The link to the video. |
title | STRING | The video title or caption. |
description | STRING | The description of the video. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
is |
BOOLEAN | If a post about the video is published. Holds "1" if a post is published, "" if not. |
live |
STRING | The live status of the video. Could e.g. be "VOD" if the video is a live video or "SCHEDULED_UNPUBLISHED" if the live video is sheduled but not published yet. If the video is no live video it holds "". |
content |
STRING | The content category of the video. |
length | DECIMAL | The duration of this video in seconds. |
height | INTEGER | The height of this video in pixel. |
width | INTEGER | The width of this video in pixel. |
privacy | STRING | Holds information about the targeting of the post. If the post is not targeted it will show "public". |
fans | INTEGER | Number of fans the page had on the day the post was published. |
comments | INTEGER | Number of comments on the video. This doesn't include comments on shares. |
is |
BOOLEAN | If the posted video is expired |
is |
BOOLEAN | If the posted video is crossposted |
source | LINK | The link to the raw video file. The source field will not be returned for videos unless the user making the request is an admin of the owning Page. Be aware that the link to the source of this video changes over time by design and thus might not work if the video was not updated recently. Please use the importTime column to know when the snapshot of this video post was last updated. |
picture | LINK | The URL to the attachment preview picture. Holds "null" if no attachment preview picture is available. |
total |
INTEGER | Number of times the video was viewed for 3 seconds or viewed to the end, whichever came first. |
total |
INTEGER | Number of unique people who viewed the video for 3 seconds or viewed to the end, whichever came first. |
total |
INTEGER | Number of times the video started automatically playing and people viewed it for 3 seconds or viewed it to the end, whichever came first. |
total |
INTEGER | Number of times people clicked to play the video and viewed it for 3 seconds or viewed it to the end, whichever came first. |
total |
INTEGER | Number of times the video was viewed for 3 seconds or viewed to the end, whichever came first, without any paid promotion. |
total |
INTEGER | Number unique viewers who viewed for 3 seconds or viewed to the end, whichever came first, without any paid promotion. |
total |
INTEGER | Number of times the video was viewed for 3 seconds or viewed to the end, whichever came first, after paid promotion. |
total |
INTEGER | Number of unique viewers who viewed for 3 seconds or viewed to the end, whichever came first, after paid promotion. |
total |
INTEGER | Number of times the video sound was turned on and was viewed for 3 seconds or viewed to the end, whichever came first. |
total |
INTEGER | Number of times the video was viewed in a shared post. |
total |
INTEGER | Number of times the video was viewed in a post that was page owned. |
total |
INTEGER | Number of times the video was viewed in a crossposted post. |
total |
INTEGER | Total time (in milliseconds) video has been viewed in a shared post. |
total |
INTEGER | Total time (in milliseconds) video has been viewed in a post that was page owned. |
total |
INTEGER | Total time (in milliseconds) video has been viewed in a crossposted post. |
total |
INTEGER | Number of times the video was watched at 95% of its length, including watches that skipped to this point. |
total |
INTEGER | Number of unique people who watched the video at 95% of its length or more, including people that skipped to this point. |
total |
INTEGER | Number of times the video started automatically playing and people watched it at 95% of its length, including watches that skipped to this point. |
total |
INTEGER | Number of times people clicked to play the video and watched it at 95% of its length, including watches that skipped to this point. |
total |
INTEGER | Number of times the video was watched at 95% of its length without any paid promotion, including watches that skipped to this point. |
total |
INTEGER | Number of unique people who watched the video at 95% of its length without any paid promotion, including people that skipped to this point. |
total |
INTEGER | Number of times the video was watched at 95% of its length after paid promotion, including watches that skipped to this point. |
total |
INTEGER | Number of unique people who watched the video at 95% of its length after paid promotion, including people that skipped to this point. |
total |
INTEGER | Total times video has been viewed greater than 60-second grouped by they were monetizable. |
total |
INTEGER | Total times video has been viewed greater than 60-second grouped by they were not monetizable. |
total |
INTEGER | Total number of times your video was viewed for 60 seconds only if the video is 60 seconds or longer. |
total (Deprecates July 28, 2023) |
INTEGER | Total number of times your video was viewed for 15 minutes only if the video is 15 minutes or longer. |
total (Deprecates July 28, 2023) |
INTEGER | Number of unique people who viewed your video for 15 minutes only if the video is 15 minutes or longer. |
total |
INTEGER | Number of times the video was viewed for 30 seconds or 97% of the video if video is less than 30 seconds. |
total |
INTEGER | Number of unique people who viewed the video for 30 seconds or 97% of the video if video is less than 30 seconds. |
total |
INTEGER | Number of times the video started automatically playing and people viewed it for 30 seconds or 97% of the video if video is less than 30 seconds. |
total |
INTEGER | Number of times people clicked to play the video and viewed it for 30 seconds or 97% of the video if video is less than 30 seconds. |
total |
INTEGER | Number of times the video was viewed for 30 seconds or 97% of the video if video is less than 30 seconds without a paid promotion. |
total |
INTEGER | Number of times the video was viewed for 30 seconds or 97% of the video if video is less than 30 seconds after a paid promotion. |
total |
INTEGER | Number of times the video was viewed for 15 seconds or viewed to the end, whichever came first. |
total |
INTEGER | Number of times the video was viewed for 10 seconds or viewed to the end, whichever came first. |
total |
INTEGER | Number of unique people who viewed the video for 10 seconds or viewed to the end, whichever came first. |
total |
INTEGER | Number of times the video started automatically playing and people viewed it for 10 seconds, or viewed it to the end, whichever came first. |
total |
INTEGER | Number of times people clicked to play the video and viewed it for 10 seconds or viewed it to the end, whichever came first. |
total |
INTEGER | Number of times the video was viewed for 10 seconds or viewed to the end, whichever came first, without a paid promotion. |
total |
INTEGER | Number of times the video was viewed for 10 seconds or viewed to the end, whichever came first, after a paid promotion. |
total |
INTEGER | Number of times the video sound was turned on and was viewed for 10 seconds or viewed to the end, whichever came first. |
total |
INTEGER | The average length of time (in milliseconds) people spent viewing the video. |
total |
INTEGER | The total time (in ms) the video has been viewed. |
total |
INTEGER | The total time (in ms) the video has been viewed in news feed or ticker or on the Page's timeline. |
total |
INTEGER | The total time (in ms) the video has been viewed after paid promotion. |
total |
INTEGER | Number of impressions of the video. |
total |
INTEGER | Number of people the video was served to. |
total |
INTEGER | Number of people the advertised Page Video was served to. |
total |
INTEGER | Number of impressions of the Page Video in an Ad or Sponsored Story. |
total |
INTEGER | Number of people who saw the Page Video in news feed or ticker, or on the Page's timeline. |
total |
INTEGER | Number of impressions of the Video in news feed or ticker or on the Page's timeline. |
total |
INTEGER | Number of people who saw the Page Video in a story from a friend. |
total |
INTEGER | Number of impressions of the Page Video in a story generated by a friend. |
total |
INTEGER | Number of people who saw the Page video because they've liked the Page. |
total |
INTEGER | Number of impressions of the Page Video to people who have liked the Page. |
total |
INTEGER | Number of people who like the Page and who saw the Page Video in an ad or sponsored story. |
total |
INTEGER | Number of paid impressions of the Page Video to people who have liked the Page. |
total |
DECIMAL | The ratio of unique video views to total unique impressions. |
total |
INTEGER | Number of stories created about the Page Video by liking the post. |
total |
INTEGER | Number of stories created about the Page Video by commenting on the post. |
total |
INTEGER | Number of stories created about the Page Video by sharing the post. |
total |
INTEGER | Number of "Like" and "Care" reactions the video got. This also includes reactions on shares. |
total |
INTEGER | Number of "Love" reactions the video got. This also includes reactions on shares. |
total |
INTEGER | Number of "Wow" reactions the video got. This also includes reactions on shares. |
total |
INTEGER | Number of "Haha" reactions the video got. This also includes reactions on shares. |
total |
INTEGER | Number of "Sorry" reactions the video got. This also includes reactions on shares. |
total |
INTEGER | Number of "Anger" reactions the video got. This also includes reactions on shares. |
total |
OBJECT | Lifetime Video View Time (in ms) by Age Bucket and Gender. Provided as an array of objects, each one having id, name and totalVideoViewTimeInMilliseconds properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "totalVideoViewTimeInMilliseconds": 1200}, ...]. |
total |
OBJECT | Lifetime Video View Time (in ms) of the top 45 cities. Provided as an array of objects, each one having id, name and totalVideoViewTimeInMilliseconds properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "totalVideoViewTimeInMilliseconds": 400}, ...]. |
total |
OBJECT | Lifetime Video View Time (in minutes) of the top 45 country. Provided as an array of objects, each one having id, name and totalVideoViewTimeInMinutes properties. E.g. [{"id": "DE", "name": "Germany", "totalVideoViewTimeInMinutes": 400}, ...]. |
total |
OBJECT | Lifetime Percentage of views at each interval (Video). Videos are divided into 40 equal intervals but each interval has a minimum length of 1 second. For example if a video is 30 seconds long the graph contains 30 intervals. Provided as an array of objects, each one having id, name and percentageOfAllViews properties. E.g. [{"id": 0, "name": "0. interval", "percentageOfAllViews": 25.21}, ...]. |
total |
OBJECT | Lifetime Percentage of auto-played views at each interval (Video). Videos are divided into 40 equal intervals but each interval has a minimum length of 1 second. For example if a video is 30 seconds long the graph contains 30 intervals. Provided as an array of objects, each one having id, name and percentageOfAllViews properties. E.g. [{"id": 0, "name": "0. interval", "percentageOfAllViews": 25.21}, ...]. |
total |
OBJECT | Lifetime Percentage of views clicked-to-play at each interval (Video). Videos are divided into 40 equal intervals but each interval has a minimum length of 1 second. For example if a video is 30 seconds long the graph contains 30 intervals. Provided as an array of objects, each one having id, name and percentageOfAllViews properties. E.g. [{"id": 0, "name": "0. interval", "percentageOfAllViews": 25.21}, ...]. |
total |
OBJECT | Views of your video by male viewers at each interval as a percentage of all male views. This metric doesn't count views of videos while they were live. Retention graphs may show more viewers later in the video than at the beginning. People might start the video in the middle, skip ahead, save and rewatch it from that point, or other similar behaviors. (video asset) (Total Count). E.g. [{"id": 0, "name": "0. interval", "percentageOfAllViews": 25.21}, ...]. |
total |
OBJECT | Views of your video by female viewers at each interval as a percentage of all female views. This metric doesn't count views of videos while they were live. Retention graphs may show more viewers later in the video than at the beginning. People might start the video in the middle, skip ahead, save and rewatch it from that point, or other similar behaviors. (video asset) (Total Count). E.g. [{"id": 0, "name": "0. interval", "percentageOfAllViews": 25.21}, ...]. |
total |
DECIMAL | An estimate of the amount you earned from ad breaks in your video, in U.S. cents, based on the number of impressions and CPM of ads shown. Actual payments may differ if there are content ownership claims or other adjustments. |
total |
INTEGER | Number of times an ad was shown during your video's ad breaks. |
total |
DECIMAL | The average amount paid by advertisers for 1,000 impressions of their ads in your video, in U.S. cents. This number also includes the amount paid to Facebook. |
facebookInsightsReels
Summary
Holding information about Reels of Facebook Pages.
Hints
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this Reel was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The unique id of the Reel. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | The link to the Reel. |
description | STRING | The description of the Reel. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
length | DECIMAL | The duration of this Reel in seconds. |
height | INTEGER | The height of this Reel in pixel. |
width | INTEGER | The width of this Reel in pixel. |
comments | INTEGER | Number of comments on the Reel. |
source | LINK | The link to the raw video file. The source field will not be returned for videos unless the user making the request is an admin of the owning Page. Be aware that the link to the source of this Reel changes over time by design and thus might not work if the Reel was not updated recently. Please use the importTime column to know when the snapshot of this Reel post was last updated. |
picture | LINK | The URL to the attachment preview picture. Holds "null" if no attachment preview picture is available. |
blue |
INTEGER | The number of times this Reel starts to play after an impression is already counted. This metric counts Reels sessions with 1 millisecond or more of playback. This metric excludes replays. |
post |
INTEGER | The number of people who saw this Reel at least once, whether or not the person played this Reel. This metric is different from impressions, which includes multiple views of this Reel by the same person. This metric is estimated. |
post |
INTEGER | The total number of milliseconds this Reel played, including time spent replaying this Reel. |
post |
INTEGER | The average number of milliseconds this Reel was played during a single instance of playing it, including time spent replaying this Reel. Because this metric includes replays, the value can be greater than the total length of the Reel. |
post |
INTEGER | Number of "Like" and "Care" reactions the Reel got. |
post |
INTEGER | Number of "Love" reactions the Reel got. |
post |
INTEGER | Number of "Wow" reactions the Reel got. |
post |
INTEGER | Number of "Haha" reactions the Reel got. |
post |
INTEGER | Number of "Sorry" reactions the Reel got. |
post |
INTEGER | Number of "Anger" reactions the Reel got. |
post |
INTEGER | Number of comments on this Reel. |
post |
INTEGER | Number of times this Reel was shared. |
post |
OBJECT | The percentage of times this Reel was played at various timestamp segments (intervals) out of the total number of plays. Most Reels will start out at 100% retention and curve downward as plays begin to drop off. If someone skipped the beginning of the Reel, your curve will start at the timestamp where the Reel started playing. Videos are divided into 40 equal intervals but each interval has a minimum length of 1 second. For example, if a video is 30 seconds long, the data contains 30 intervals. Provided as an array of objects, each one having id, name and percentageOfAllViews properties. E.g. [{"id": 0, "name": "0. interval", "percentageOfAllViews": 25.21}, ...]. |
post |
INTEGER | Number of people who followed your Page or profile within 24 hours of watching this Reel. This metric is estimated. |
facebookInsightsPageFansOnline
Summary
Holding the number of Fans (People liking a Facebook Page) online over time, broken down by hour.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). As this data set is broken down by hour, the date time includes the full hour with minutes and seconds set to 00. |
timestamp | INTEGER | The unix timestamp of the date time including the hour within the "time" column. This column is useful to uniquely identify the exact point in time, as the hour can exist twice for the same day in case of summer/winter time shifts. |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
fans (Deprecates September 16, 2024) |
INTEGER | The number of Fans of a Facebook Page being online on Facebook in the current interval. Facebook considers a user to be online if it saw any posts on Facebook in that time. |
facebookInsightsPageLikesAndUnlikesBySource (Deprecates March 18, 2024)
Summary
Holding the number of won and lost Page Likes of Facebook Pages including their development over time. In contrast to our change metrics for Page Likes in public data sources, this one can be used to show how many Page Likes were gained and lost over time.
This data source deprecates on March 18, 2024. Learn more about recent changes and upcoming deprecations of data sources here.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by Facebook.
- The monthly interval shows 28 day values as provided by Facebook representing the last 28 days of each month.
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
source | LINK | The source according to Facebook's documentation. |
likes | INTEGER | The number of new Page Likes in the current interval. |
likes |
INTEGER | The number of unique new Page Likes in the current interval. |
unlikes |
INTEGER | The number of unique lost Page Likes in the current interval. |
facebookInsightsPageViewsReferrals
Summary
Holding the number of Views of Facebook Pages per Referral sending traffic to a Facebook Page including their development over time. Referrals can be both external domains and internal pages on Facebook (e.g. Profile, Search, Requests, Suggestions, Stream)
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by Facebook.
- The monthly interval shows 28 day values as provided by Facebook representing the last 28 days of each month.
- Facebook provides access to Insights data for the past two years. Thus initial imports will cover up to two years of data.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
referral | STRING | The referral the traffic is coming from, either an external domain name or internal pages on Facebook (e.g. Profile, Search, Requests, Suggestions, Stream). |
views | INTEGER | The total number of Page Views. |
facebookOwnPosts
Summary
Holding public information about posts of Facebook Pages.
Hints
- Facebook provides access to approximately 600 of the best ranked posts per year per Facebook Page. Thus initial imports will cover up to 600 ranked posts per year. For the same reason metrics of posts cannot be updated if they have moved out of the 600 ranked posts per year window.
- Targeted posts are not imported.
- Deleted posts will not be removed from our database once they have been imported.
- Co-author post are only visible under the owner page.
- Reels are not included.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was published. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
message | STRING | The contents of the post message. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
mentions | OBJECT | The tagged users or Facebook Pages within the post's message. Provided as a list of objects, e.g. [{"id": "128340270541979", "name": "quintly", "type": "Page", "offset": 10, "length": 7}, ...]. |
hashtags | OBJECT | The hashtags used within the post's message. Provided as a list of strings, e.g. ["#hashtag1", "#hashtag2"]. |
type | STRING | The object type of the post. |
link | LINK | The link to the post. |
story | STRING | Text of the accompanying story shown on Facebook. E.g., "BMW posted a video to playlist BMW TODAY." |
external |
STRING | The unique id of the post. |
internal |
STRING | The quintly internal ID of this post. |
likes | INTEGER | Number of "Like" or "Care" reactions the post got. This doesn't include reactions on shares. |
love | INTEGER | Number of "Love" reactions the post got. This doesn't include reactions on shares. |
wow | INTEGER | Number of "Wow" reactions the post got. This doesn't include reactions on shares. |
haha | INTEGER | Number of "Haha" reactions the post got. This doesn't include reactions on shares. |
sad | INTEGER | Number of "sad" reactions the post got. This doesn't include reactions on shares. |
angry | INTEGER | Number of "angry" reactions the post got. This doesn't include reactions on shares. |
thankful | INTEGER | Number of "Thankful" reactions the post got. This doesn't include reactions on shares. |
comments | INTEGER | Number of comments the post got. This doesn't include comments on shares. |
shares | INTEGER | Number of shares the post got. This doesn't include shares of shares. |
interaction |
PERCENT | Holds the interaction rate of the post. You can find more information on how we calculate the interaction rate in our knowledge base article. |
fans | INTEGER | Number of fans the page had on the day the post was published. |
followers | INTEGER | Number of followers the page had on the day the post was published. |
is |
BOOLEAN | If the posted video was live or not. Holds "1" if the post was a live post, "" if not. |
is |
BOOLEAN | If the posted audio was live or not. Holds "1" if the post was a live post, "" if not. |
is |
BOOLEAN | If the post is a shared post or not. Holds "1" if the post is a shared post, "" if not. |
is |
BOOLEAN | If the post contains a 360 degree photo/video or not. Holds "1" if the post contains a 360 degree photo or video, "" if not. If the post is a shared 360 degree photo/video, Facebook can not detect that the original post contains 360 degree content thus the column would also hold "". |
is |
BOOLEAN | Describes if the post is an co-author post. |
is |
BOOLEAN | Indicates if post is owned by the page. An example for a non-owned post is a co-authored post. |
attachment |
STRING | The name of the post's attachment. Holds "null" if no attachment name is set. |
attachment |
STRING | A description of a link in the post (appears beneath the attachmentCaption). Holds "null" if no attachment description is set. |
attachment |
STRING | The link in the caption of a post. The caption must be an actual URL and when clicking on it, it should accurately reflect the URL of the associated advertiser, business or owner of the posted content (e.g. news article). If the post is shared and contains another shared post the value will be null. |
attachment |
LINK | The URL of the post's attachment. Holds "null" if no attachment URL is available. |
attachment |
LINK | The URL to the attachment preview picture. Holds "null" if no attachment preview picture is available. |
facebookQuestions
Summary
Holding public information about questions by Facebook users posted to the Timeline of Facebook Pages. Please note this data source is a subset of facebookUserPosts, just showing User Posts identified as a question. A question is defined as any message containing a question mark.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was published. |
external |
STRING | The unique id of the post. |
user |
STRING | No documentation available yet |
fans | INTEGER | Number of fans the page had on the day the post was published. |
likes | INTEGER | No documentation available yet |
love | INTEGER | No documentation available yet |
wow | INTEGER | No documentation available yet |
haha | INTEGER | No documentation available yet |
sad | INTEGER | No documentation available yet |
angry | INTEGER | No documentation available yet |
comments | INTEGER | No documentation available yet |
shares | INTEGER | No documentation available yet |
response |
DATETIME | No documentation available yet |
time |
INTEGER | No documentation available yet |
interaction |
PERCENT | No documentation available yet |
link | LINK | No documentation available yet |
message | STRING | No documentation available yet |
is |
BOOLEAN | No documentation available yet |
facebookUserPosts
Summary
Holding public information about posts by Facebook users to Facebook Pages, matching the posts shown in the Community tab of the Page.
Hints
- Facebook provides access to approximately 600 of the best ranked posts per year per Facebook Page. Thus initial imports will cover up to 600 ranked posts per year. For the same reason metrics of posts cannot be updated if they have moved out of the 600 ranked posts per year window.
- Targeted posts are not imported.
- Deleted posts will not be removed from our database once they have been imported.
- When a Facebook Page disallows posts, user posts will always be 0. Additionally, some user posts might not be included if the users who made them, do not allow their data to be shared via the API.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was published. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
user |
STRING | The name of the user who created the user post. |
message | STRING | The contents of the post message. |
type | ENUM | The object type of the post. |
link | LINK | The link to the post. |
external |
STRING | The unique id of the post. |
likes | INTEGER | Number of "Like" and "Care" reactions the post got. This doesn't include reactions on shares. |
love | INTEGER | Number of "Love" reactions the post got. This doesn't include reactions on shares. |
wow | INTEGER | Number of "Wow" reactions the post got. This doesn't include reactions on shares. |
haha | INTEGER | Number of "Haha" reactions the post got. This doesn't include reactions on shares. |
sad | INTEGER | Number of "Sorry" reactions the post got. This doesn't include reactions on shares. |
angry | INTEGER | Number of "Anger" reactions the post got. This doesn't include reactions on shares. |
thankful | INTEGER | Number of "Thankful" reactions the post got. This doesn't include reactions on shares. |
comments | INTEGER | Number of comments the post got. This doesn't include comments on shares. |
shares | INTEGER | Number of shares the post got. This doesn't include shares of shares. |
is |
BOOLEAN | If the post contains a question or not. Holds "1" if the post contains a question, "" if not. |
response |
DATETIME | The date of the pages's first comment on the user post in "Y/m/d H:i:s" format. |
time |
INTEGER | The time in seconds between the created time of the user post and the time of the pages's first comment on the user post. |
attachment |
STRING | The name of the post's attachment. Holds "null" if no attachment name is set. |
attachment |
STRING | The description of the post's attachment. Holds "null" if no attachment description is set. |
attachment |
STRING | The caption of the post's attachment. Holds "null" if no attachment caption is set. |
attachment |
LINK | The URL of the post's attachment. Holds "null" if no attachment URL is available. |
attachment |
LINK | The URL to the attachment preview picture. Holds "null" if no attachment preview picture is available. |
Summary
Holding public data for Instagram Profiles and their development over time. All numbers are aggregates across the whole Instagram Profile.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Except for followers and following metrics this data source calculates account-wide metrics by aggregating the results of all the posts (data source instagramOwnPosts) created in each interval. This also means that days, weeks or months without any posts created show 0 for all engagement metrics. This is to be differentiated from Instagram Insights data (data source instagramInsights) where the actual interaction time is considered for reporting, independent of when content has been created or published.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
followers | INTEGER | Number of followers at the end of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Number of followers at the beginning of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Change of the number of followers from the beginning to the end of the current interval. |
following (Deprecates March 16, 2022) |
INTEGER | Number of Instagram accounts this profile is following at the end of the current interval (e.g. a day, week, month). |
following (Deprecates March 16, 2022) |
INTEGER | Number of Instagram accounts this profile is following at the beginning of the current interval (e.g. a day, week, month). |
following (Deprecates March 16, 2022) |
INTEGER | Change of the number of Instagram accounts this profile is following from the beginning to the end of the current interval. |
posts | INTEGER | Number of posts created since the creation of this account at the end of the current interval (e.g. a day, week, month). |
posts |
INTEGER | Number of posts created since the creation of this account at the beginning of the current interval (e.g. a day, week, month). |
posts |
INTEGER | Change of the number of posts created since the creation of this account from the beginning to the end of the current interval. This can be considered the number of new posts ignoring deletions. |
images | INTEGER | Number of new image posts created. |
images |
INTEGER | Number of likes on image posts. |
images |
INTEGER | Number of comments on image posts. |
videos | INTEGER | Number of new video posts created. |
videos |
INTEGER | Number of likes on video posts. |
videos |
INTEGER | Number of comments on video posts. |
carousels | INTEGER | Number of new carousel posts created. |
carousels |
INTEGER | Number of likes on carousel posts. |
carousels |
INTEGER | Number of comments on carousel posts. |
reels | INTEGER | Number of new Reels created. |
reels |
INTEGER | Number of likes on Reels. |
reels |
INTEGER | Number of comments on Reels. |
instagramInsights
Summary
Holding private-level data for Instagram Business Accounts from Instagram Insights and their development over time. All numbers are aggregates across the whole Instagram Business Account.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by Instagram's API. Please note that the Instagram Creator Studio shows data in user time zone which is why numbers shown in quintly and Creator Studio can differ.
- The monthly interval shows 28 day values as provided by Instagram representing the last 28 days of each month.
- The online followers metric is usually available with a delay of 2 to 3 days and initially we can only import online followers for the last 30 days.
- Initially we can only import gained follower counts for the last 30 days.
- Instagram does not provide historic access to audience metrics (cities, countries, gender and age, locales) which is why we can only show those metrics for days when you had an intact Insights connection set up. You will never receive data before we have introduced the audience columns at Jan 20th 2020.
- Instagram does not provide historic access to 'engaged_audience_demographics', 'reached_audience_demographics' metrics and there breakdowns (cities, countries, gender and age) which is why we can only show those metrics for days when you had an intact Insights connection set up. You will never receive data before we have introduced these demographics columns at Sep 15th 2024. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days.
- Insights data is not available for accounts that have fewer than 100 followers.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
impressions | INTEGER |
Number of times the Instagram account's posts, stories, reels and live videos have been viewed. Includes ad activity generated through the API, Facebook ads interfaces, and the Promote feature. Does not include profile views. Additional interval specific columns for this metric exist: impressionsDay impressionsWeek impressionsDays28 |
reach | INTEGER |
Number of unique accounts that have seen the Instagram account's posts, stories, reels and live videos. Includes ad activity generated through the API, Facebook ads interfaces, and the Promote feature. Additional interval specific columns for this metric exist: reachDay reachWeek reachDays28 |
follower |
INTEGER | Number of new followers each day. This metric is only available when using daily interval. |
email |
INTEGER | Number of taps on the email link in the Instagram account's profile in the selected time range. This metric is only available when using daily interval. |
phone |
INTEGER | Number of taps on the call link in the Instagram account's profile in the selected time range. This metric is only available when using daily interval. |
text |
INTEGER | Number of taps on the text message link in the Instagram account's profile in the selected time range. This metric is only available when using daily interval. |
get |
INTEGER | Number of taps on the directions link in the Instagram account's profile in the selected time range. This metric is only available when using daily interval. |
website |
INTEGER | Number of taps on the website link in the Instagram account's profile in the selected time range. This metric is only available when using daily interval. |
profile |
INTEGER | Number of users who have viewed the account's profile in the selected time range. Unlike impressions or reach this holds only the views of the profile page and does not include any other contexts (e.g. posts on the feed). This metric is only available when using daily interval. |
audience |
OBJECT | The top 45 cities of the account's followers. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "followers": 4}, ...]. |
audience |
OBJECT | The top 45 countries of the account's followers. Provided as an array of objects, each one having id, name and followers properties. The id is a ISO 3166-1 alpha-2 country code. E.g. [{"id": "DE", "name": "Germany", "followers": 105}, ...]. |
audience |
OBJECT | The gender and age distribution of the account's followers. The sum across all gender and age buckets must not match the total followers count as some users may not set the ages or genders in their profiles. Provided as an array of objects, each one having id, name and followers properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "followers": 39}, ...]. |
engaged |
OBJECT | The top 45 cities of the account's engaged audience. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "engaged": 4}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
engaged |
OBJECT | The top 45 cities of the account's engaged audience. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "engaged": 4}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
engaged |
OBJECT | The top 45 countries of the account's engaged audience. Provided as an array of objects, each one having id, name and followers properties. The id is a ISO 3166-1 alpha-2 country code. E.g. [{"id": "DE", "name": "Germany", "engaged": 105}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
engaged |
OBJECT | The top 45 countries of the account's engaged audience. Provided as an array of objects, each one having id, name and followers properties. The id is a ISO 3166-1 alpha-2 country code. E.g. [{"id": "DE", "name": "Germany", "engaged": 105}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
engaged |
OBJECT | The gender and age distribution of the account's engaged audience. The sum across all gender and age buckets must not match the total followers count as some users may not set the ages or genders in their profiles. Provided as an array of objects, each one having id, name and followers properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "engaged": 39}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
engaged |
OBJECT | The gender and age distribution of the account's engaged audience. The sum across all gender and age buckets must not match the total followers count as some users may not set the ages or genders in their profiles. Provided as an array of objects, each one having id, name and followers properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "engaged": 39}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
reached |
OBJECT | The top 45 cities of the account's reached audience. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "reached": 4}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
reached |
OBJECT | The top 45 cities of the account's reached audience. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "reached": 4}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
reached |
OBJECT | The top 45 countries of the account's reached audience. Provided as an array of objects, each one having id, name and followers properties. The id is a ISO 3166-1 alpha-2 country code. E.g. [{"id": "DE", "name": "Germany", "reached": 105}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
reached |
OBJECT | The top 45 countries of the account's reached audience. Provided as an array of objects, each one having id, name and followers properties. The id is a ISO 3166-1 alpha-2 country code. E.g. [{"id": "DE", "name": "Germany", "reached": 105}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
reached |
OBJECT | The gender and age distribution of the account's reached audience. The sum across all gender and age buckets must not match the total followers count as some users may not set the ages or genders in their profiles. Provided as an array of objects, each one having id, name and followers properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "reached": 39}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
reached |
OBJECT | The gender and age distribution of the account's reached audience. The sum across all gender and age buckets must not match the total followers count as some users may not set the ages or genders in their profiles. Provided as an array of objects, each one having id, name and followers properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "reached": 39}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. Please note that Instagram may only update the data every few days. |
engaged (Deprecates August 19, 2024) |
OBJECT | The top 45 cities of the account's engaged audience. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "engaged": 4}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. |
engaged (Deprecates August 19, 2024) |
OBJECT | The top 45 countries of the account's engaged audience. Provided as an array of objects, each one having id, name and followers properties. The id is a ISO 3166-1 alpha-2 country code. E.g. [{"id": "DE", "name": "Germany", "engaged": 105}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. |
engaged (Deprecates August 19, 2024) |
OBJECT | The gender and age distribution of the account's engaged audience. The sum across all gender and age buckets must not match the total followers count as some users may not set the ages or genders in their profiles. Provided as an array of objects, each one having id, name and followers properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "engaged": 39}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. |
reached (Deprecates August 19, 2024) |
OBJECT | The top 45 cities of the account's reached audience. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "Munich, Bayern", "name": "Munich, Bayern", "reached": 4}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. |
reached (Deprecates August 19, 2024) |
OBJECT | The top 45 countries of the account's reached audience. Provided as an array of objects, each one having id, name and followers properties. The id is a ISO 3166-1 alpha-2 country code. E.g. [{"id": "DE", "name": "Germany", "reached": 105}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. |
reached (Deprecates August 19, 2024) |
OBJECT | The gender and age distribution of the account's reached audience. The sum across all gender and age buckets must not match the total followers count as some users may not set the ages or genders in their profiles. Provided as an array of objects, each one having id, name and followers properties. The id is a gender and age combination in format "<gender>-<ageRange>". <gender> one of "female", "male" or "unknown". <ageRange> one of "13-17", "18-24", "25-34", "35-44", "45-54", "55-64" or "65+". E.g. [{"id": "female-13-17", "name": "Female 13-17", "reached": 39}, ...]. You can get your demographics data only if metric has more than 100 people in each breakdown. |
audience (Deprecates January 02, 2024) |
OBJECT | The locales of the account's followers. Provided as an array of objects, each one having id, name and followers properties. E.g. [{"id": "en_US", "name": "en_US", "followers": 85}, ...]. |
online |
OBJECT | The number of followers who were online during the specified hour of the day. Provided as an array of objects, each one having id, name and followers properties. The id holds the hour of the day. "0" represents the hour from 0 to 1 am, "1" from 1 to 2 am and so forth. The hour is in user timezone and thus can start in the middle of the day as the day relates to the full day aggregated in PST timezone as provided by Facebook. E.g. [{"id": "0", "name": "0-1", "followers": 85}, {"id": "1", "name": "1-2", "followers": 21}, ...]. |
instagramInsightsOwnPosts
Summary
Holding information about regular posts of Instagram Business or Creator Accounts with all their private statistics attached, including Reels.
Hints
- Insights metrics including impressions, reach, engagement, saved and video views only report organic interactions; interactions on ads are not included.
- Metrics for Instagram Reels only cover the performance on Instagram directly. When a Reel was shared to Facebook, the performance on Facebook is not included.
- Instagram Collabs are only included for the original author.
- Includes all Feed videos, including former IGTV. This is based on Instagram's anouncement combining IGTV and feed videos into one format - Instagram Video.
- Instagram does not provide data for metrics with values less than 5. In such cases 0 will be returned.
- Insights data is not available for accounts that have fewer than 100 followers.
- Profile activity metrics are not available for Reel and Carousel posts.
- Video views of Reel (plays) does not contain any replays. This can differ to plays count displayed in the Instagram App.
- For posts after mid December 2023 engagement column will contain also shares count same as totalInteractions column.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The post's ID on Instagram's platform. |
internal |
STRING | The quintly internal ID of this post. |
short |
STRING | The post's short-code as defined on Instagram's platform. |
message | STRING | The caption of the Instagram post. |
link | LINK | The link to the post. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
mentions | OBJECT | The mentioned users within the post's message. Provided as a list of strings, e.g. ["username1", "username2"]. |
hashtags | OBJECT | The hashtags used within the post's message. Provided as a list of strings, e.g. ["#hashtag1", "#hashtag2"]. |
media |
LINK | The link to the post's media. Not available for videos that have been flagged for copyright violations. |
attachment |
LINK | The link to the post's attached media thumbnail. |
type | ENUM | The type of the post. This can be either Image, Video, Carousel or Reel. |
carousel |
INTEGER | Number of images in a carousel post. This value will be null if the post is not a carousel |
carousel |
INTEGER | Number of videos in a carousel post. This value will be null if the post is not a carousel |
is |
BOOLEAN | If this post is a Reel, true indicates the Reel can appear in both the Feed and Reels tabs. False indicates the Reel can only appear in the Reels tab. Note that neither value indicates if the Reel actually appears in the Reels tab, as the Reel may not meet eligibilty requirements or have been selected by our algorithm. See Reel specifications for eligibility critera. |
is |
BOOLEAN | Indicates if comments are enabled or disabled. |
is (Deprecates February 01, 2023) |
BOOLEAN | Indicates if post is owned by the page. An example for a non-owned post is a co-authored post as part of Instagram Collabs. Instagram stopped returning Instagram Collabs for the co-author from Sep 1st, 2022. For that reason this field returns true in all cases from this date onwards and posts will not be returned for the co-author profile. |
likes | INTEGER | Number of likes the post and its comments and replies got in an organic context, excluding likes from images or videos inside a carousel. |
comments | INTEGER | Number of comments and their replies the post got in an organic context, excluding comments from images or videos inside a carousel. |
impressions | INTEGER | The number of times this post has been seen organically. Impressions on ads are not included. This metric is not available for Reels. |
reach | INTEGER | The number of unique accounts that have seen this post organically. Reach on ads is not included. |
engagement (Deprecates December 15, 2023) |
INTEGER | Total number of likes, comments and saves this post got organically. For posts after mid December 2023 engagement will contain shares count same as totalInteractions column. Engagement on ads is not included. |
profile |
INTEGER | The number of times your profile was visited after engaging with the post. This metric is only available for post of type Image or Video. |
follows | INTEGER | This is how many accounts started following the account after engaging with the post. This metric is only available for post of type Image or Carousel. |
total |
INTEGER | Total number of likes, comments, saves and shares this Reel got organically. Interactions on ads is not included. |
saved | INTEGER | The number of unique accounts that have saved this post on Instagram organically. Saves on ads are not included. |
video |
INTEGER | For Feed videos this is the number of times this video has been seen for at least three seconds organically (Video views on ads are not included). For Carousel albums, it will return the sum of video views on all videos inside the Carousel. For Reels this is the number of times the Reel started to play with 1 ms or more. In all cases it does not count additional views when the video automatically restarts (replays). This can differ to plays count displayed in the Instagram App. |
shares | INTEGER | The number of times this post has been shared organically. This metric is not available for Carousel Album posts. Shares on ads are not included. |
profile |
INTEGER | The number of actions people take when they visit your profile after engaging with your post. |
profile |
INTEGER | The number of taps to the website link on your Instagram profile when they visit your profile after engaging with your post. |
profile |
INTEGER | The number of times your business address on your bio was tapped when they visit your profile after engaging with your post. |
profile |
INTEGER | The number of taps to call your business when they visit your profile after engaging with your post. |
profile |
INTEGER | The number of taps to email your business when they visit your profile after engaging with your post. |
profile |
INTEGER | The number of taps to text your business when they visit your profile after engaging with your post. |
reels |
INTEGER | The average amount of time spent playing the reel in milliseconds. This is calculated by the watch time divided by the number of plays. Metric in in development by Meta. The metric will return null if the post is not a reel. |
reels |
INTEGER | The total amount of time the reel was played in milliseconds, including any time spent replaying the reel. Metric is in development by Meta. The metric will return null if the post is not a reel. |
reels |
INTEGER | The number of times your reel starts to play again after an initial play of your reel. This is defined as replays of 1ms or more in the same reel session. This metric is only available by Meta for Reels created after 09/21/2023. |
reels |
INTEGER | The number of times your reel starts to play or replay after an impression is already counted. This is defined as plays of 1ms or more. Replays are counted after the initial play in the same reel session. |
instagramInsightsTvPosts (Deprecates May 11, 2022)
Summary
Holding information about IGTV videos of Instagram Business or Creator Accounts with all their private statistics attached. This does not include regular posts or Reels.
This data source deprecates on May 11, 2022. Learn more about recent changes and upcoming deprecations of data sources here.
Hints
- This data source is deprecated. IGTV videos are now returned as Feed postings of type video by data source instagramInsightsOwnPosts. This is based on Instagram's anouncement combining IGTV and feed videos into one format - Instagram Video.
- Regular posts and Reels are not included here.
- Only includes IGTV videos where the video has been shared to Instagram at the time of publish (Post a Preview or Share Preview to Feed enabled).
- Insights metrics including impressions, reach, engagement, saved and video views only report organic interactions; interactions on ads are not included.
- Instagram does not provide data for metrics with values less than 5. In such cases 0 will be returned.
- Insights data is not available for accounts that have fewer than 100 followers.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The post's ID on Instagram's platform. |
internal |
STRING | The quintly internal ID of this post. |
short |
STRING | The post's short-code as defined on Instagram's platform. |
message | STRING | The caption of the post. |
video |
STRING | The title of the IGTV video. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
mentions | OBJECT | The mentioned users within the post's message. Provided as a list of strings, e.g. ["username1", "username2"]. |
hashtags | OBJECT | The hashtags used within the post's message. Provided as a list of strings, e.g. ["#hashtag1", "#hashtag2"]. |
likes | INTEGER | Number of likes the post got including replies, excluding likes from images or videos inside a carousel and excluding likes on promoted posts created from the media object. |
comments | INTEGER | Number of comments the post got including replies, excluding comments from images or videos inside a carousel. |
link | LINK | The direct link to the post. |
media |
LINK | The link to the post's media. Not available for videos that have been flagged for copyright violations. |
attachment |
LINK | The link to the post's attached media thumbnail. |
impressions | INTEGER | The number of times this post has been seen organically. Impressions on ads are not included. |
reach | INTEGER | The number of unique accounts that have seen this post organically. Reach on ads is not included. |
engagement | INTEGER | Total number of likes, comments and saves this post got organically. Engagement on ads is not included. |
saved | INTEGER | The number of unique accounts that have saved this post on Instagram organically. Saves on ads are not included. |
video |
INTEGER | The number of times this video has been seen for at least three seconds organically. Video views on ads are not included. It does not count additional views when the video automatically restarts. |
instagramInsightsStories
Summary
Holding private-level information about Instagram stories, including impressions, reach, taps and other metrics.
Hints
- Insights metrics including impressions, reach, exits, replies, taps forward and backward only report organic interactions; interactions on ads are not included.
- Instagram does not provide data for metrics with values less than 5. In such cases 0 will be returned.
- Live video stories are not included.
- Stories created when a user reshares another story are not included.
- Insights data is not available for accounts that have fewer than 100 followers.
- Due to privacy rules, replies will show 0 for stories created by users in Europe (from Dec 1st, 2020) and Japan (from Apr 14th, 2021), and the reply count does not include replies made by users in these regions. Learn more about this limitation in the Instagram Graph API documentation.
- New navigation metrics (except for tapsBack and tapsForward) and profile activity metrics are only available since Feb 1st, 2023.
- Link clicks and sticker taps are currently not available via the API.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The story's ID on Instagram's platform. |
internal |
STRING | The quintly internal ID of this post. |
short |
STRING | The story's short-code as defined on Instagram's platform. |
caption | STRING | The captions of the Instagram story. If there's more than one text item, the text items are concatenated and whitespace-separated. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
link | LINK | The direct link to the story (works only on mobile devices with the Instagram app). The link will be active for as long as the story is active on Instagram (24 hours from the time of creation). |
media |
LINK | The link to the story's media. Not available for videos that have been flagged for copyright violations. |
thumbnail |
LINK | The link to the story's attached media thumbnail. |
thumbnail |
STRING | The text shown on the thumbnail of this story. The text was automatically detected using text extraction algorithms. |
type | ENUM | The type of this story, photo or video. |
impressions | INTEGER | The number of times this story has been seen. |
reach | INTEGER | The number of unique Instagram accounts that have seen this story. |
exits | INTEGER | Number of times someone left this story. This includes users closing Instagram while viewing the story, users clicking on the X on the top-right corner of the story and users swiping down the media, going back to the main feed. |
replies | INTEGER | The number of replies to this story including quick reactions and sending messages in the context of this story. In compliance with the European Union's ePrivacy Directive, replies will show 0 for stories created by a user in the European Economic Area (EEA), and the reply count does not include replies made by users in the EEA. Learn more about this limitation in the Instagram Graph API changelog. |
profile |
INTEGER | The number of times your profile was visited after engaging with the post. This metric is only available for post of type Image or Video. This metric is only available since Feb 5th, 2023. |
follows | INTEGER | This is how many accounts started following the account after engaging with the post. This metric is only available for post of type Image or Video. This metric is only available since Feb 5th, 2023. |
taps |
INTEGER | The total number of taps to see this story's next photo or video. |
taps |
INTEGER | The total number of taps to see this story's previous photo or video. |
navigations | INTEGER | This is total number of actions taken from your story. These are made up of metrics like exited, forward, back and next story. |
automatic |
INTEGER | The total number of automatic forward to see this story's next photo or video. |
swipes |
INTEGER | The total number of swipes back to the previous accounts's story. This action will skip all current account's stories. |
swipes |
INTEGER | The number of swipes to the next accounts's story. This action will skip all current account's stories. |
profile |
INTEGER | The number of actions people take when they visit your profile after engaging with your story. Be aware this metric does not contain any follows or profile visits. |
profile |
INTEGER | The number of taps to the website link on your Instagram profile when they visit your profile after engaging with your story. |
profile |
INTEGER | The number of times your business address on your bio was tapped when they visit your profile after engaging with your story. |
profile |
INTEGER | The number of taps to call your business when they visit your profile after engaging with your story. |
profile |
INTEGER | The number of taps to email your business when they visit your profile after engaging with your story. |
profile |
INTEGER | The number of taps to text your business when they visit your profile after engaging with your story. |
instagramInsightsComments
Summary
Holding private-level data for comments and their replies created on posts that were posted in the selected time range. Please note that this takes into account the creation time of the commented-on posts and not the creation time of the comment.
Hints
- Includes comments and their replies of postings made in an organic context.
- Comments/replies made in a paid context are excluded.
- Comments/replies of users blocked by the account owner are excluded.
- Comments are updated for posts published within the last 7 days.
- Because of a bug in Instagram's Graph API a small percentage of comments/replies are missing as of now.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this comment was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The comment's ID on Instagram's platform. |
external |
STRING | The ID of the post this comment belongs to on Instagram's platform. |
username | STRING | The username of the author of this comment. |
is |
BOOLEAN | Returns true if this is a comment by the Instagram account who created the post this comment belongs to. |
message | STRING | The text of this comment. |
link | LINK | The direct link to the post this comment belongs to. There is no way of linking to an individual comment as of now. |
mentions | OBJECT | The mentioned users within the comment's message. Provided as a list of strings, e.g. ["username1", "username2"]. |
hashtags | OBJECT | The hashtags used within the comment's message. Provided as a list of strings, e.g. ["#hashtag1", "#hashtag2"]. |
is |
BOOLEAN | Returns true if this is a reply to another comment. |
parent |
STRING | If this is a reply to another comment, it returns the ID of the comment on Instagram's platform. |
is |
BOOLEAN | Returns true if this comment is not visible to the public. |
likes | INTEGER | The number of likes this comment got. |
instagramOwnPosts
Summary
Holding public information about posts of Instagram Business or Creator Accounts, including Reels.
Hints
- Includes all Feed videos, including former IGTV. This is based on Instagram's anouncement combining IGTV and feed videos into one format - Instagram Video.
- Posts of age-gated accounts are not included.
- Instagram does not provide data for metrics with values less than 5. In such cases 0 will be returned.
- Insights metrics including impressions, reach, engagement, saved and video views will always return null for co-author posts if the page is not the owner.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The unique id of the post. |
internal |
STRING | The quintly internal ID of this post. |
message | STRING | The caption of the post. |
link | LINK | The link to the post. |
is (Deprecates February 01, 2023) |
BOOLEAN | Indicates if post is owned by the page. An example for a non-owned post is a co-authored post as part of Instagram Collabs. Instagram stopped returning Instagram Collabs for the co-author from Sep 1st, 2022. For that reason this field returns true in all cases from this date onwards and posts will not be returned for the co-author profile. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
media |
LINK | The link to the post's media. Not available for videos that have been flagged for copyright violations. |
attachment |
LINK | The link to the post's attached media thumbnail. |
type | ENUM | The type of the post. This can be either Image, Video, Carousel or Reel. |
followers | INTEGER | Number of followers the Instagram account had at the day this post was created. |
likes | INTEGER | Number of likes the post and its comments and replies got in an organic context, excluding likes from images or videos inside a carousel. The number of likes will show n/a if the account is hiding like counts. For your owned accounts with hidden like counts please use private-level data to still retrieve like counts. |
comments | INTEGER | Number of comments and their replies the post got in an organic context, excluding comments from images or videos inside a carousel. |
interaction |
PERCENT | Holds the interaction rate of this post defined as likes+comments divided by the follower count at the day this posting was created. |
instagramTvPosts (Deprecates May 11, 2022)
Summary
Holding public information about IGTV videos of Instagram Business or Creator Accounts. This does not include regular posts or Reels.
This data source deprecates on May 11, 2022. Learn more about recent changes and upcoming deprecations of data sources here.
Hints
- This data source is deprecated. IGTV videos are now returned as Feed postings of type video by data source instagramOwnPosts. This is based on Instagram's anouncement combining IGTV and feed videos into one format - Instagram Video.
- Regular posts and Reels are not included here.
- Only includes IGTV videos where the video has been shared to Instagram at the time of publish (Post a Preview or Share Preview to Feed enabled).
- Posts of age-gated accounts are not included.
- Instagram does not provide data for metrics with values less than 5. In such cases 0 will be returned.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
link | LINK | The link to the post. |
external |
STRING | The unique id of the post. |
internal |
STRING | The quintly internal ID of this post. |
message | STRING | The caption of the post. |
video |
STRING | The title of the IGTV video. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
media |
LINK | The link to the post's media. Not available for videos that have been flagged for copyright violations. |
attachment |
LINK | The link to the post's attached media thumbnail. |
followers | INTEGER | Number of followers the Instagram account had at the day this post was created. |
likes | INTEGER | Number of likes the post got including replies, excluding likes from images or videos inside a carousel and excluding likes on promoted posts created from the media object. |
comments | INTEGER | Number of comments the post got including replies, excluding comments from images or videos inside a carousel. |
interaction |
PERCENT | Holds the interaction rate of this post defined as likes+comments divided by the follower count at the day this posting was created. |
metaAdsCampaigns
Summary
Holding lifetime stats of Meta ad campaigns.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
ad |
INTEGER | Identifier for the ad account this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "adAccounts" table which is ready to be used with all QQL queries. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this campaign using the APIs of the social networks and there was a modification compared to its former state. |
id | STRING | The ID of this ad campaign. |
name | STRING | The name of this ad campaign. |
create |
DATETIME | The date when this ad campaign was created. |
start |
DATETIME | The date when this ad campaign starts/started. |
end |
DATETIME | The date when this ad campaign ends/ended. |
objective | ENUM | The objective of this ad campaign. One of: App Installs, Brand Awareness, Conversions, Event Responses, Lead Generation, Link Clicks, Local Awareness, Messages, Offer Claims, Page Likes, Post Engagement, Product Catalog Sales, Reach, Store Visits, Video Views, Outcome App Promotion, Outcome Awareness, Outcome Engagement, Outcome Leads, Outcome Sales, Outcome Traffic |
status | ENUM | The status of this ad campaign. One of: Active, Paused, Deleted, Archived, In Process, With Issues |
impressions | INTEGER | The impressions this ad campaign got. |
reach | INTEGER | The reach this ad campaign got. |
reach |
INTEGER | The reach this ad campaign got. |
reach |
INTEGER | The reach this ad campaign got. |
spend | DECIMAL | The amount of money spent on this ad campaign. |
spend |
DECIMAL | The amount of money spent on this ad campaign. |
spend |
DECIMAL | The amount of money spent on this ad campaign. |
page (Deprecates October 30, 2024) |
INTEGER | The number of people who engaged with the Facebook Page through the campaign. |
page |
INTEGER | Number of times people who engaged with the Facebook Page through the campaign. |
post (Deprecates October 30, 2024) |
INTEGER | The number of people who engaged with the ad. |
post |
INTEGER | Number of times people who engaged with the ad. |
likes (Deprecates October 30, 2024) |
INTEGER | The number of likes performed on the page through the campaign. |
likes |
INTEGER | Number of times likes performed on the page through the campaign. |
comments (Deprecates October 30, 2024) |
INTEGER | The number of comments left on the post through the campaign. |
comments |
INTEGER | Number of times comments left on the post through the campaign. |
video (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed the video through the campaign (when relevant). |
video |
INTEGER | Number of times people who viewed the video through the campaign (when relevant). |
link |
INTEGER | The number of people who clicked on a link through the campaign (when relevant). |
link |
INTEGER | Number of times people who clicked on a link through the campaign (when relevant). |
landing (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed a landing page through the campaign (when relevant). |
landing |
INTEGER | Number of times people who viewed a landing page through the campaign (when relevant). |
photo (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed the photo through the campaign (when relevant). |
photo |
INTEGER | Number of times people who viewed the photo through the campaign (when relevant). |
post (Deprecates October 30, 2024) |
INTEGER | The number of Facebook reactions on the post through the campaign. |
post |
INTEGER | Number of times Facebook reactions on the post through the campaign. |
post (Deprecates October 30, 2024) |
INTEGER | The number of people who shared the post through the campaign. |
cost |
DECIMAL | The average cost for each estimated ad recall lift. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. |
cost |
DECIMAL | The average cost of each inline link click. |
cost |
DECIMAL | The average cost of each inline post engagement. |
cost |
DECIMAL | The average cost for each outbound click. |
outbound |
DECIMAL | The number of times people saw the ad and performed an outbound click. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost |
DECIMAL | The amount of money spent on this ad campaign per thruplay. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
mobile |
DECIMAL | Number of times people who installed the mobile app through the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on save billing information button. |
cost (Deprecates October 30, 2024) |
DECIMAL | Number of times people clicks on an add to cart button. |
fb |
DECIMAL | Number of times people clicks on an add to cart button. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on an add to wishlist button. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people submits a completed subscription or signup form. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people customizes a product. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on a checkout button. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on pricing. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people finished the purchase or checkout flow and lands on thank you or confirmation page.The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people searches for a product. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people lands on a product details page. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
lead |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
omni |
DECIMAL | Number of times people has finished the purchase or checkout. |
cost |
DECIMAL | The amount of money spent on this ad campaign. |
metaAdsCampaignsTimeSeries
Summary
Holding lifetime stats of Meta ad campaigns.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
ad |
INTEGER | Identifier for the ad account this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "adAccounts" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this campaign using the APIs of the social networks and there was a modification compared to its former state. |
id | STRING | The ID of this ad campaign. |
impressions | INTEGER | The impressions this ad campaign got. |
impressions |
INTEGER | The impressions this ad campaign got on Facebook. |
impressions |
INTEGER | The impressions this ad campaign got on Instagram. |
reach | INTEGER | The reach this ad campaign got. |
reach |
INTEGER | The reach this ad campaign got. |
reach |
INTEGER | The reach this ad campaign got. |
spend | DECIMAL | The amount of money spent on this ad campaign. |
spend |
DECIMAL | The amount of money spent on this ad campaign. |
spend |
DECIMAL | The amount of money spent on this ad campaign. |
page (Deprecates October 30, 2024) |
INTEGER | The number of people who engaged with the Facebook Page through the campaign. |
page |
INTEGER | Number of times people who engaged with the Facebook Page through the campaign. |
post (Deprecates October 30, 2024) |
INTEGER | The number of people who engaged with the ad. |
post |
INTEGER | Number of times people who engaged with the ad. |
likes (Deprecates October 30, 2024) |
INTEGER | The number of likes performed on the page through the campaign. |
likes |
INTEGER | Number of times likes performed on the page through the campaign. |
comments (Deprecates October 30, 2024) |
INTEGER | The number of comments left on the post through the campaign. |
comments |
INTEGER | Number of times comments left on the post through the campaign. |
video (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed the video through the campaign (when relevant). |
video |
INTEGER | Number of times people who viewed the video through the campaign (when relevant). |
link |
INTEGER | The number of people who clicked on a link through the campaign (when relevant). |
link |
INTEGER | Number of times people who clicked on a link through the campaign (when relevant). |
landing (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed a landing page through the campaign (when relevant). |
landing |
INTEGER | Number of times people who viewed a landing page through the campaign (when relevant). |
photo (Deprecates October 30, 2024) |
INTEGER | The number of people who viewed the photo through the campaign (when relevant). |
photo |
INTEGER | Number of times people who viewed the photo through the campaign (when relevant). |
post (Deprecates October 30, 2024) |
INTEGER | The number of Facebook reactions on the post through the campaign. |
post |
INTEGER | Number of times Facebook reactions on the post through the campaign. |
post (Deprecates October 30, 2024) |
INTEGER | The number of people who shared the post through the campaign. |
cost |
DECIMAL | The average cost for each estimated ad recall lift. This metric is only available for assets in the Brand awareness, Post engagement and Video views Objectives. |
cost |
DECIMAL | The average cost of each inline link click. |
cost |
DECIMAL | The average cost of each inline post engagement. |
outbound |
DECIMAL | The number of times people saw the ad and performed an outbound click. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
cost |
DECIMAL | The amount of money spent on this ad campaign per thruplay. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
mobile |
DECIMAL | Number of times people who installed the mobile app through the ad. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on save billing information button. |
cost (Deprecates October 30, 2024) |
DECIMAL | Number of times people clicks on an add to cart button. |
fb |
DECIMAL | Number of times people clicks on an add to cart button. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on an add to wishlist button. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people submits a completed subscription or signup form. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people customizes a product. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on a checkout button. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people clicks on pricing. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people finished the purchase or checkout flow and lands on thank you or confirmation page.The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people searches for a product. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
fb |
DECIMAL | Number of times people lands on a product details page. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
lead |
DECIMAL | The amount of money spent on this ad campaign. |
cost (Deprecates October 30, 2024) |
DECIMAL | The amount of money spent on this ad campaign. |
omni |
DECIMAL | Number of times people has finished the purchase or checkout. |
Summary
Holding public follower counts for LinkedIn Company Pages and their development over time.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
followers | INTEGER | Number of Followers for the LinkedIn Company Page at the end of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Number of Followers for the LinkedIn Company Page at the beginning of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Change of the total number of Followers for the LinkedIn Company Page. |
linkedInAnalytics
Summary
Holding private-level data for LinkedIn Company Pages from LinkedIn Analytics and their development over time. All numbers are aggregates across the whole LinkedIn Company Page.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Daily, weekly and monthly intervals are aggregated in UTC timezone.
- Non-lifetime statistics only support daily and monthly intervals.
- Non-lifetime statistics for followers and page statistics are available with a delay of two days (till the day before yesterday) and for the past 12 months. Thus initial imports will cover up to one year of data.
- Post statistics only reflect the organic performance of the past 12 months, using a rolling 12-month window.
- Mobile traffic includes LinkedIn native apps and mobile web browsers.
- Lifetime metrics can only be shown for days when you had an intact Insights connection set up. You will never receive data before we have introduced this data source at Nov 6th 2020.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
own |
INTEGER | Number of posts created in the current interval. This matches the posts shown in data source linkedInAnalyticsOwnPosts. |
organic |
INTEGER | Number of gained organic followers in the selected time interval. |
paid |
INTEGER | Number of gained paid followers in the selected time interval. |
all |
INTEGER | Number of page views in the selected time interval. |
all |
INTEGER | Total number (lifetime performance) of page views. |
all |
INTEGER | Number of unique visitors in the selected time interval. |
all |
INTEGER | Number of page views through desktop traffic in the selected time interval. |
all |
INTEGER | Total number (lifetime performance) of page views through desktop traffic. |
all |
INTEGER | Number of unique visitors through desktop traffic in the selected time interval. |
all |
INTEGER | Number of page views through mobile traffic in the selected time interval. |
all |
INTEGER | Total number (lifetime performance) of page views through mobile traffic. |
all |
INTEGER | Number of unique visitors through mobile traffic in the selected time interval. |
about |
INTEGER | Number of page views in the ''About'' section in the selected time interval. |
desktop |
INTEGER | Number of page views in the ''About'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views in the ''About'' section through mobile traffic in the selected time interval. |
about |
INTEGER | Total number (lifetime performance) of page views on ''About'' section. |
desktop |
INTEGER | Total number (lifetime performance) of page views on ''About'' section through desktop traffic. |
mobile |
INTEGER | Number of page views in the ''About'' section through mobile traffic. |
about |
INTEGER | Number of unique visitors in the ''About'' section in the selected time interval. |
mobile |
INTEGER | Number of unique visitors in the ''About'' section through mobile traffic in the selected time interval. |
desktop |
INTEGER | Number of unique visitors in the ''About'' section through desktop traffic in the selected time interval. |
careers |
INTEGER | Number of page views on the Career Pages in the selected time interval. |
desktop |
INTEGER | Number of page views on the Career Pages through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views on the Career Pages in the selected time interval. |
careers |
INTEGER | Total number (lifetime performance) of page views on career page. |
desktop |
INTEGER | Total number (lifetime performance) of page views on Career Pages through desktop traffic. |
mobile |
INTEGER | Number of page views =on the Career Pages through mobile traffic. |
careers |
INTEGER | Number of unique visitors on the Career Pages in the selected time interval. |
desktop |
INTEGER | Number of unique visitors on the Career Pages through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of unique visitors on the Career Pages through mobile traffic in the selected time interval. |
insights |
INTEGER | Number of page views in the ''Insights'' section in the selected time interval. |
desktop |
INTEGER | Number of page views in the ''Insights'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views in the ''Insights'' section through mobile traffic in the selected time interval. |
insights |
INTEGER | Total number (lifetime performance) of page views on ''Insights'' sectione. |
desktop |
INTEGER | Total number (lifetime performance) of page views on ''Insights'' section through desktop traffic. |
mobile |
INTEGER | Total number (lifetime performance)of page views in the ''Insights'' section through mobile traffic. |
insights |
INTEGER | Number of unique visitors in the ''Insights'' section in the selected time interval. |
desktop |
INTEGER | Number of unique visitors in the ''Insights'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of unique visitors in the ''Insights'' section through mobile traffic in the selected time interval. |
jobs |
INTEGER | Number of page views in the ''Jobs'' section in the selected time interval. |
desktop |
INTEGER | Number of page views in the ''Jobs'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views in the ''Jobs'' section through mobile traffic in the selected time interval. |
jobs |
INTEGER | Total number (lifetime performance) of page views on ''Jobs'' section . |
desktop |
INTEGER | Total number (lifetime performance) of page views on ''Jobs'' section through desktop traffic. |
mobile |
INTEGER | Number of page views in the ''Jobs'' section through mobile traffic. |
jobs |
INTEGER | Number of unique visitors in the ''Jobs'' section in the selected time interval. |
desktop |
INTEGER | Number of unique visitors in the ''Jobs'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of unique visitors in the ''Jobs'' section through mobile traffic in the selected time interval. |
life |
INTEGER | Number of page views on the ''Life'' page in the selected time interval. |
desktop |
INTEGER | Number of page views on the ''Life'' page through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views on the ''Life'' page through mobile traffic in the selected time interval. |
life |
INTEGER | Total number (lifetime performance) of page views on ''Life'' page. |
desktop |
INTEGER | Total number (lifetime performance) of page views on ''Life'' page through desktop traffic. |
mobile |
INTEGER | Total number (lifetime performance) of page views on the ''Life'' page through mobile traffic. |
life |
INTEGER | Number of unique visitors on the ''Life'' page in the selected time interval. |
desktop |
INTEGER | Number of unique visitors on the ''Life'' page through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of unique visitors in the ''People'' section in the selected time interval. |
overview |
INTEGER | Number of page views on the ''Home'' page in the selected time interval. |
desktop |
INTEGER | Number of page views on the ''Home'' page through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views on the ''Home'' page through mobile traffic in the selected time interval. |
overview |
INTEGER | Total number (lifetime performance) of page views on ''Home'' page. |
desktop |
INTEGER | Total number (lifetime performance) of page views on ''Home'' page through desktop traffic. |
mobile |
INTEGER | Total number (lifetime performance) of page views on the ''Home'' page through mobile traffic. |
overview |
INTEGER | Number of unique visitors on the ''Home'' page in the selected time interval. |
desktop |
INTEGER | Number of unique visitors on the ''Home'' page through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of unique visitors on the ''Home'' page through mobile traffic in the selected time interval. |
people |
INTEGER | Number of page views in the ''People'' section in the selected time interval. |
desktop |
INTEGER | Number of page views in the ''People'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views in the ''People'' section through mobile traffic in the selected time interval. |
people |
INTEGER | Total number (lifetime performance) of page vieis on ''People'' section. |
desktop |
INTEGER | Total number (lifetime performance) of page vieis on ''People'' section through desktop traffic. |
mobile |
INTEGER | Total number (lifetime performance) of page views in the ''People'' section through mobile traffic. |
people |
INTEGER | Number of unique visitors in the ''People'' section in the selected time interval. |
desktop |
INTEGER | Number of unique visitors in the ''People'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of unique visitors in the ''People'' section in the selected time interval. |
products |
INTEGER | Number of unique visitors in the ''Products'' section in the selected time interval. |
desktop |
INTEGER | Number of unique visitors in the ''Products'' section through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of unique visitors in the ''Product'' section through mobile traffic in the selected time interval. |
products |
INTEGER | Number of page views on the Product Page in the selected time interval. |
desktop |
INTEGER | Number of page views on the Product Page through desktop traffic in the selected time interval. |
mobile |
INTEGER | Number of page views on the Product Page through mobile traffic in the selected time interval. |
products |
INTEGER | Total number (lifetime performance) of page views on Product page. |
desktop |
INTEGER | Total number (lifetime performance) of page views on Product Page through desktop traffic. |
mobile |
INTEGER | Total number (lifetime performance) of page views on the Product Page through mobile traffic. |
careers |
INTEGER | Number of clicks on the banner promo on the Career Pages in the selected time interval. |
careers |
INTEGER | Total number (lifetime performance) of clicks on the banner promo on the Career Pages. |
careers |
INTEGER | Number of clicks on the Career Pages in the selected time interval. |
mobile |
INTEGER | Number of clicks on the Career Pages through mobile traffic in the selected time interval. |
careers |
INTEGER | Total number (lifetime performance) of clicks on the jobs section on the Career Pages. |
mobile |
INTEGER | Total number (lifetime performance) of clicks on the jobs section on the Career Pages through mobile traffic. |
careers |
INTEGER | Number of clicks on the promo links on the Career Pages in the selected time interval. |
mobile |
INTEGER | Number of clicks on the promo links on the Career Pages through mobile traffic in the selected time interval. |
careers |
INTEGER | Total number (lifetime performance) of clicks on the promo links on the Career Pages. |
mobile |
INTEGER | Total number (lifetime performance) of clicks on the promo links on the Career Pages through mobile traffic. |
careers |
INTEGER | Number of clicks on the employees section on the Career Pages in the selected time interval. |
mobile |
INTEGER | Number of clicks on the employees section on the Career Pages through mobile traffic in the selected time interval. |
careers |
INTEGER | Total number (lifetime performance) of clicks on the employees section on the Career Pages. |
mobile |
INTEGER | Total number (lifetime performance) of clicks on the employees section on the Career Pages through mobile traffic. |
contact |
INTEGER | Number of clicks on custom button ''Contact Us'' in the selected time interval. |
mobile |
INTEGER | Number of clicks on custom button ''Contact Us'' through mobile traffic in the selected time interval. |
learn |
INTEGER | Number of clicks on custom button ''Learn more'' in the selected time interval. |
mobile |
INTEGER | Number of clicks on custom button ''Learn more'' through mobile traffic in the selected time interval. |
register |
INTEGER | Number of clicks on custom button ''Register'' in the selected time interval. |
mobile |
INTEGER | Number of clicks on custom button ''Register'' through mobile traffic in the selected time interval. |
sign |
INTEGER | Number of clicks on custom button ''Sign Up'' in the selected time interval. |
mobile |
INTEGER | Number of clicks on custom button ''Sign Up'' through mobile traffic in the selected time interval. |
website |
INTEGER | Number of clicks on custom button ''Website'' in the selected time interval. |
mobile |
INTEGER | Number of clicks on custom button ''Website'' through mobile traffic in the selected time interval. |
post |
INTEGER | Number of organic clicks on updates in the selected time interval. |
post |
INTEGER | Total number (lifetime performance) of organic clicks on updates. |
post |
INTEGER | Number of organic comments on updates in the selected time interval. |
post |
INTEGER | Total number (lifetime performance) of comments on updates. |
post |
INTEGER | Total number (lifetime performance) of mentions of the organizational entity in a comment across LinkedIn. |
post |
DECIMAL | Number of organic clicks, likes, comments, and shares over impressions on updates in the selected time interval. |
post |
DECIMAL | Total number (lifetime performance) of organic clicks, likes, comments, and shares over impressions on updates. |
post |
INTEGER | Number of organic impressions on updates in the selected time interval. |
post |
INTEGER | Total number (lifetime performance) of organic impressions on updates. |
post |
INTEGER | Number of organic likes on updates in the selected time interval. This field can become negative when members who liked a sponsored share later unlike it. The like is not counted since it is not organic, but the unlike is counted as organic. |
post |
INTEGER | Total number (lifetime performance) of organic likes on updates. |
post |
INTEGER | Number of organic shares on updates in the selected time interval. |
post |
INTEGER | Total number (lifetime performance) of organic shares on updates. |
post |
DECIMAL | Total number (lifetime performance) of mentions of the organizational entity in a share across LinkedIn. |
post |
INTEGER | Number of organic unique impressions on updates in the selected time interval. |
post |
INTEGER | Total number (lifetime performance) of organic unique impressions on updates. |
organic |
OBJECT | Total number of followers by association type. This is the total followers count, including followers from organic and paid contexts. |
paid (Deprecates August 05, 2023) |
OBJECT | Total number of paid followers by association type. Please use the organic counterpart (e.g., organicFollowersByCountry) instead, holding the total followers from organic and paid contexts. |
organic |
OBJECT | Total number of followers by country. Limited to the top 100 countries by country. This is the total followers count, including followers from organic and paid contexts. |
organic (Deprecates December 15, 2023) |
OBJECT | Total number of followers by country. Limited to the top 100 countries by country. This is the total followers count, including followers from organic and paid contexts. |
paid (Deprecates August 05, 2023) |
OBJECT | Total number of paid followers by country. Limited to the top 100 countries. Please use the organic counterpart (e.g., organicFollowersByCountry) instead, holding the total followers from organic and paid contexts. |
organic |
OBJECT | Total number of followers by job function. This is the total followers count, including followers from organic and paid contexts. |
paid (Deprecates August 05, 2023) |
OBJECT | Total number of paid followers by job function. Please use the organic counterpart (e.g., organicFollowersByCountry) instead, holding the total followers from organic and paid contexts. |
organic |
OBJECT | Total number of followers by industry. This is the total followers count, including followers from organic and paid contexts. |
paid (Deprecates August 05, 2023) |
OBJECT | Total number of followers by industry. Please use the organic counterpart (e.g., organicFollowersByCountry) instead, holding the total followers from organic and paid contexts. |
organic |
OBJECT | Total number of followers by geo region. Limited to the top 100 regions. This is the total followers count, including followers from organic contexts. |
paid |
OBJECT | Total number of paid followers by geo region. Limited to the top 100 regions. This is the total followers count, including followers from paid contexts. |
organic (Deprecates December 15, 2023) |
OBJECT | Total number of followers by region. Limited to the top 100 regions. This is the total followers count, including followers from organic and paid contexts. |
paid (Deprecates August 05, 2023) |
OBJECT | Total number of the paid followers by region. Limited to the top 100 regions. Please use the organic counterpart (e.g., organicFollowersByCountry) instead, holding the total followers from organic and paid contexts. |
organic |
OBJECT | Total number of followers by seniority. This is the total followers count, including followers from organic and paid contexts. |
paid (Deprecates August 05, 2023) |
OBJECT | Total number of paid followers by seniority. Please use the organic counterpart (e.g., organicFollowersByCountry) instead, holding the total followers from organic and paid contexts. |
organic |
OBJECT | Total number of followers by company size. This is the total followers count, including followers from organic and paid contexts. |
paid (Deprecates August 05, 2023) |
OBJECT | Total number of paid followers by company size. Please use the organic counterpart (e.g., organicFollowersByCountry) instead, holding the total followers from organic and paid contexts. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on the Product Page through mobile traffic by country. Limited to the top 100 countries by country. |
all (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views through desktop traffic by country. Limited to the top 100 countries by country. |
insights (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' sectione by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''About'' section through mobile traffic by country. Limited to the top 100 countries by country. |
all (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views through mobile traffic by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on Product Page through desktop traffic by country. Limited to the top 100 countries by country. |
products (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on Product page by country. Limited to the top 100 countries by country. |
jobs (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section by country. Limited to the top 100 countries by country. |
people (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section by country. Limited to the top 100 countries by country. |
overview (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on the ''Home'' page through mobile traffic by country. Limited to the top 100 countries by country. |
life (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page through desktop traffic by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on the Career Pages through mobile traffic by country. Limited to the top 100 countries by country. |
all (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''Jobs'' section through mobile traffic by country. Limited to the top 100 countries by country. |
careers (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on career page by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on the ''Life'' page through mobile traffic by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section through desktop traffic by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section through desktop traffic by country. Limited to the top 100 countries by country. |
about (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''About'' section by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''About'' section through desktop traffic by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''People'' section through mobile traffic by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' section through desktop traffic by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on Career Pages through desktop traffic by country. Limited to the top 100 countries by country. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page through desktop traffic by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''Insights'' section through mobile traffic by country. Limited to the top 100 countries by country. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on the Product Page through mobile traffic by region. Limited to the top 100 regions. |
all (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views through desktop traffic by region. Limited to the top 100 regions. |
insights (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' sectione by region. Limited to the top 100 regions. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''About'' section through mobile traffic by region. Limited to the top 100 regions. |
all (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views through mobile traffic by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on Product Page through desktop traffic by region. Limited to the top 100 regions. |
products (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on Product page by region. Limited to the top 100 regions. |
jobs (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section by region. Limited to the top 100 regions. |
people (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section by region. Limited to the top 100 regions. |
overview (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page by region. Limited to the top 100 regions. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on the ''Home'' page through mobile traffic by region. Limited to the top 100 regions. |
life (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page through desktop traffic by region. Limited to the top 100 regions. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) page views on the Career Pages through mobile traffic by region. Limited to the top 100 regions. |
all (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views by region. Limited to the top 100 regions. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''Jobs'' section through mobile traffic by region. Limited to the top 100 regions. |
careers (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on career page by region. Limited to the top 100 regions. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on the ''Life'' page through mobile traffic by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section through desktop traffic by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section through desktop traffic by region. Limited to the top 100 regions. |
about (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''About'' section by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''About'' section through desktop traffic by region. Limited to the top 100 regions. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''People'' section through mobile traffic by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' section through desktop traffic by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on Career Pages through desktop traffic by region. Limited to the top 100 regions. |
desktop (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page through desktop traffic by region. Limited to the top 100 regions. |
mobile (Deprecates December 15, 2023) |
OBJECT | Total number (lifetime performance) of page views in the ''Insights'' section through mobile traffic by region. Limited to the top 100 regions. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the Product Page through mobile traffic by job function. |
all |
OBJECT | Total number (lifetime performance) of page views through desktop traffic by job function. |
insights |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' sectione by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''About'' section through mobile traffic by job function. |
all |
OBJECT | Total number (lifetime performance) of page views through mobile traffic by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page views on Product Page through desktop traffic by job function. |
products |
OBJECT | Total number (lifetime performance) of page views on Product page by job function. |
jobs |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section by job function. |
people |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section by job function. |
overview |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Home'' page through mobile traffic by job function. |
life |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page through desktop traffic by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views on he Career Pages through mobile traffic by job function. |
all |
OBJECT | Total number (lifetime performance) of page views by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Jobs'' section through mobile traffic by job function. |
careers |
OBJECT | Total number (lifetime performance) of page views on career page by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Life'' page through mobile traffic by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section through desktop traffic by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section through desktop traffic by job function. |
about |
OBJECT | Total number (lifetime performance) of page views on ''About'' section by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''About'' section through desktop traffic by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''People'' section through mobile traffic by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' section through desktop traffic by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page views on Career Pages through desktop traffic by job function. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page through desktop traffic by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Insights'' section through mobile traffic by job function. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the Product Page through mobile traffic by industry. |
all |
OBJECT | Total number (lifetime performance) number (lifetime performance) of page views through desktop traffic by industry. |
insights |
OBJECT | Total number (lifetime performance) number (lifetime performance) of page views on ''Insights'' sectione by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''About'' section through mobile traffic by industry. |
all |
OBJECT | Total number (lifetime performance) of page views through mobile traffic by industry. |
desktop |
OBJECT | Total number (lifetime performance) of page views on Product Page through desktop traffic by industry. |
products |
OBJECT | Total number (lifetime performance) of page views on Product page by industry. |
jobs |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section by industry. |
people |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section by industry. |
overview |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Home'' page through mobile traffic by industry. |
life |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page by industry. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page through desktop traffic by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views =n the Career Pages through mobile traffic by industry. |
all |
OBJECT | Total number (lifetime performance) of page views by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Jobs'' section through mobile traffic by industry. |
careers |
OBJECT | Total number (lifetime performance) of page views on career page by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Life'' page through mobile traffic by industry. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section through desktop traffic by industry. |
desktop |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section through desktop traffic by industry. |
about |
OBJECT | Total number (lifetime performance) of page views on ''About'' section by industry. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''About'' section through desktop traffic by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''People'' section through mobile traffic by industry. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' section through desktop traffic by industry. |
desktop |
OBJECT | Total number (lifetime perfo rmance) of page views on Career Pages through desktop traffic by industry. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page through desktop traffic by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Insights'' section through mobile traffic by industry. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the Product Page through mobile traffic by seniority. |
all |
OBJECT | Total number (lifetime performance) of page views through desktop traffic by seniority. |
insights |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' sectione by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''About'' section through mobile traffic by seniority. |
all |
OBJECT | Total number (lifetime performance) of page views through mobile traffic by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page views on Product Page through desktop traffic by seniority. |
products |
OBJECT | Total number (lifetime performance) of page views on Product page by seniority. |
jobs |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section by seniority. |
people |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section by seniority. |
overview |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Home'' page through mobile traffic by seniority. |
life |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page through desktop traffic by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views =o the Career Pages through mobile traffic by seniority. |
all |
OBJECT | Total number (lifetime performance) of page views by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Jobs'' section through mobile traffic by seniority. |
careers |
OBJECT | Total number (lifetime performance) of page views on career page by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Life'' page through mobile traffic by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section through desktop traffic by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section through desktop traffic by seniority. |
about |
OBJECT | Total number (lifetime performance) of page views on ''About'' section by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''About'' section through desktop traffic by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''People'' section through mobile traffic by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' section through desktop traffic by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page views on Career Pages through desktop traffic by seniority. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page through desktop traffic by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Insights'' section through mobile traffic by seniority. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the Product Page through mobile traffic by company size. |
all |
OBJECT | Total number (lifetime performance) of page views through desktop traffic by company size. |
insights |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' sectione by company size. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''About'' section through mobile traffic by company size. |
all |
OBJECT | Total number (lifetime performance) of page views through mobile traffic by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page views on Product Page through desktop traffic by company size. |
products |
OBJECT | Total number (lifetime performance) of page views on Product page by company size. |
jobs |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section by company size. |
people |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section by company size. |
overview |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page by company size. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Home'' page through mobile traffic by company size. |
life |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Home'' page through desktop traffic by company size. |
mobile |
OBJECT | Total number (lifetime performance) of page views =on he Career Pages through mobile traffic by company size. |
all |
OBJECT | Total number (lifetime performance) of page views by company size. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Jobs'' section through mobile traffic by company size. |
careers |
OBJECT | Total number (lifetime performance) of page views on career page by company size. |
mobile |
OBJECT | Total number (lifetime performance) of page views on the ''Life'' page through mobile traffic by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Jobs'' section through desktop traffic by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page vieis on ''People'' section through desktop traffic by company size. |
about |
OBJECT | Total number (lifetime performance) of page views on ''About'' section by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''About'' section through desktop traffic by company size. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''People'' section through mobile traffic by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Insights'' section through desktop traffic by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page views on Career Pages through desktop traffic by company size. |
desktop |
OBJECT | Total number (lifetime performance) of page views on ''Life'' page through desktop traffic by company size. |
mobile |
OBJECT | Total number (lifetime performance) of page views in the ''Insights'' section through mobile traffic by company size. |
linkedInAnalyticsOwnPosts
Summary
Holding private information about posts of LinkedIn Company Pages.
Hints
- Shares, clicks, impressions and engagement rate only reflect the performance of the past 12 months, using a rolling 12-month window. E.g., engagement on a post that happened longer than 12 months ago is not included.
- Video views, viewers, time watched and time watched for video views metrics for video posts will not be available after six months.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
published |
DATETIME | The time this posting was published. |
created |
DATETIME | The time this posting was created. |
time (Deprecates February 15, 2024) |
DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The unique id of the post. |
internal |
STRING | The quintly internal ID of this post. |
type | ENUM | The type of the post. This can be Link, Image, Gallery, Status, Rich, Video, Course, Job, Question, Answer, Carousel, Topic, Document, Reference or LiveVideo. |
message | STRING | The post's message. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
link | LINK | The link to the post. |
attachment (Deprecates October 05, 2020) |
OBJECT | The details of the posts's attachment. Provided as an object, e.g. {"description": "text", "thumbnail": "https://quintly.com/thumbnail/social.jpg", "title": "title", "url": "http://bit.ly/2L8Qw5u"}. This column is deprecated, please use one of attachmentTitle, attachmentDescription, attachmentLink or attachmentThumbnail. |
attachments | OBJECT | The details of all posts's attachments. Provided as an object, e.g. [{"description": "text", "thumbnail": "https://quintly.com/thumbnail/social.jpg", "title": "title", "url": "http://bit.ly/2L8Qw5u"}]. |
attachment |
STRING | The title of the post's attachment. |
attachment |
STRING | The description of the posts's attachment. |
attachment |
LINK | The link to the post's attachment. |
attachment |
LINK | The thumbnail URL of the post's attachment. |
targeting | OBJECT | The details of the posts's targeting settings. The object holds the following properties representing targeting types: "location", "language", "jobFunction", "companySize", "school", "organization", "seniority", "industries", "fieldOfStudy" and "degree". Provided as an object with a list of objects for each targeting property, e.g. {[ { "id": STRING, "type": STRING, "name": STRING }, ... ].} |
mentions | OBJECT | The companies, schools or users/members mentioned in the post's message. Provided as a list of objects, e.g. [{"id": "urn:li:organization:1", "username": "quintly", "name": "quintly", "type": "company"},{"id": "urn:li:person:1", "username": "user1", "name": "User", "type": "member"},{"id": "urn:li:organization:2", "username": "uni", "name": "University", "type": "school"}] |
urls | OBJECT | The URLs/links used in this post. Provided as a list of objects, e.g. [{"url": "https://lnkd.in/dwbaVWn", "expandedUrl": "https://conference.allfacebook.de/", "unwoundUrl": "https://conference.allfacebook.de/"}, ...]. The unwound url holds the last url after following all redirects. |
likes | INTEGER | Total number of organic reactions (e.g., like, celebrate, love, insightful, curious) the post got. |
like |
INTEGER | Number of organic like reactions (thumbs up) the post got. |
celebrate |
INTEGER | Number of organic celebrate reactions (clapping) the post got. |
love |
INTEGER | Number of organic love reactions (heart) the post got. |
insightful |
INTEGER | Number of organic insightful reactions (bulb) the post got. |
curious |
INTEGER | Number of organic curious reactions (curious smiley) the post got. |
support |
INTEGER | Number of organic support reactions (hand with heart) the post got. |
funny |
INTEGER | Number of organic funny reactions (laughing smiley) the post got. |
first |
INTEGER | Number of first level comments the post got. |
comments | INTEGER | Number of total comments the post got including first level comments and replies. |
shares | INTEGER | Number of organic shares the post got. |
clicks | INTEGER | Number of organic clicks the post got. |
impressions | INTEGER | Number of organic impressions the post got. |
unique |
INTEGER | Number of organic unique impressions (Reach) the post got. |
engagement |
DECIMAL | Number of organic clicks, likes, comments, and shares divided by impressions. |
video |
INTEGER | Video views with play-pause cycles for at least 3 seconds. Auto-looping videos are counted as one when loaded. Each subsequent auto-looped play does not increase this metric. |
video |
INTEGER | Unique viewers who made engaged plays on the video. Auto-looping videos are counted as one when loaded. Each subsequent auto-looped play does not increase this metric. |
video |
INTEGER | The time the video was watched in milliseconds. Video auto-looping will continue to increase this metric for each subsequent play. |
video |
INTEGER | The time watched in milliseconds for video play-pause cycles that are at least 3 seconds. Video auto-looping will continue to increase this metric for each subsequent play. |
linkedInAnalyticsStories
Summary
Holding private information about stories of LinkedIn Company Pages.
Hints
- The stories are not officially documented in the API, therefore data may not always be provided.
- Post statistics only reflect the performance of the past 12 months, using a rolling 12-month window. E.g. engagement on a stories longer than 12 months ago is not included.
- Video views, viewers, time watched and time watched for video views metrics for video stories will not be available after six months.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The unique id of the story. |
internal |
STRING | The quintly internal ID of this post. |
type | ENUM | The type of the post. This can be Link, Image, Status, Rich, Video, Course, Job, Question, Answer, Carousel, Topic, Document, Reference or LiveVideo. |
link | LINK | The link to the story. |
message | STRING | Concatenated overlay texts on the story. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
attachment |
LINK | The link to the story's attachment. |
attachment |
LINK | The thumbnail URL of the story's attachment. |
stickers |
INTEGER | Number of stickers the story contains. |
shares | INTEGER | Number of organic shares the story got. |
clicks | INTEGER | Number of organic clicks the story got. |
impressions | INTEGER | Number of organic impressions the story got. |
engagement |
DECIMAL | Number of organic clicks, likes, comments, and shares divided by impressions. |
video |
INTEGER | The time the video was watched in milliseconds. Video auto-looping will continue to increase this metric for each subsequent play. |
video |
INTEGER | The time watched in milliseconds for video play-pause cycles that are at least 3 seconds. Video auto-looping will continue to increase this metric for each subsequent play. |
tiktok (Deprecates November 25, 2022)
Summary
Holding public data for TikTok profiles and their development over time. All numbers are aggregates across the whole TikTok profile.
This data source deprecates on November 25, 2022. Learn more about recent changes and upcoming deprecations of data sources here.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- TikTok data is being fetched from the public TikTok profile page and relies on profile pages being public. Changes by TikTok might result in the data being inaccessible for us in the future.
- All metric values are abbreviated. E.g. a follower count of 103,125,538 will be shown as 103,100,000 (103.2M).
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
followers | INTEGER | Number of followers for this TikTok profile at the end of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Number of followers for this TikTok profile at the beginning of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Change of the total number of followers for this TikTok profile. |
following | INTEGER | Number of following for this TikTok profile at the end of the current interval (e.g. a day, week, month). |
following |
INTEGER | Number of following for this TikTok profile at the beginning of the current interval (e.g. a day, week, month). |
following |
INTEGER | Change of the total number of following for this TikTok profile. |
likes | INTEGER | Number of likes (lifetime performance) for this TikTok profile at the end of the current interval (e.g. a day, week, month). |
likes |
INTEGER | Number of likes (lifetime performance) for this TikTok profile at the beginning of the current interval (e.g. a day, week, month). |
likes |
INTEGER | Change of the total number of likes (new likes) for this TikTok profile. |
videos | INTEGER | Number of videos (lifetime performance) for this TikTok profile at the end of the current interval (e.g. a day, week, month). |
videos |
INTEGER | Number of videos (lifetime performance) for this TikTok profile at the beginning of the current interval (e.g. a day, week, month). |
videos |
INTEGER | Change of the total number of videos (new videos) for this TikTok profile. |
own |
INTEGER | Number of posts created on this profile. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of likes on the profile's posts. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of comments on the profile's posts. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of shares on the profile's posts. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of video views on the profile's posts. This includes video views of any length. This takes into account the creation time of the post and not when the interaction occurred. |
tiktokOwnPosts (Deprecates November 25, 2022)
Summary
Holding public information about posts of TikTok profiles.
This data source deprecates on November 25, 2022. Learn more about recent changes and upcoming deprecations of data sources here.
Hints
- TikTok data is being fetched from the public TikTok profile page and relies on profile pages being public. Changes by TikTok might result in the data being inaccessible for us in the future.
- When adding a new TikTok profile initially, historical data covers the 30 most recent posts. Ongoing, all posts created within the last 30 days are kept up to date.
- All metric values are abbreviated. E.g. a view count of 4,510,225 will be shown as 4,500,000 (4.5M).
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting from the social network. |
external |
STRING | The unique id of this post. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | The link to this post. |
description | STRING | The description of this post. |
hashtags | OBJECT | The hashtags used in this post. Provided as a list of hashtags, e.g. ["#dating", "#comedy"]. |
challenges | OBJECT | The challenges linked in this post. Provided as a list of objects, e.g. [{"id": "...", "title": "comedy", "description": "Show your comedy skills!"}, ...]. |
video |
STRING | The unique id of the video attached to this post. |
video |
INTEGER | The duration of the video attached to this post, in seconds. |
video |
LINK | The URL of the attached video's cover in this post. |
video |
LINK | The URL of the attached video's dynamic cover in this post, usually in webp format using animations. |
music |
STRING | The unique id of the music used in this post. |
music |
STRING | The title of the music used in this post. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
followers | INTEGER | Number of followers this profile had on the day the post was published. |
likes | INTEGER | Number of times this post has been liked. |
comments | INTEGER | Number of times this post has been commented. |
shares | INTEGER | Number of times this post has been shared. |
views | INTEGER | Number of times this post and it's attached video has been viewed. This includes video views of any length. |
interaction |
PERCENT | Holds the interaction rate of this post, defined as the sum of likes, comments and shares, divided by the number of views. |
tiktokAnalytics
Summary
Holding authenticated data for TikTok profiles and their development over time. All numbers are aggregates across the whole TikTok profile.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- TikTok analytics data has a delay up to 48 hours.
- TikTok does only provide historic access for last 60 days which is why we can only show data for the last 60 days when you had an intact Insights connection set up. You will never receive data before May 15st 2024.
- Demographic metrics, such as gender and countries, are only returned if there is data for 100 or more followers.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
followers | INTEGER | Number of followers for this TikTok profile at the end of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Number of followers for this TikTok profile at the beginning of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Change of the total number of followers for this TikTok profile. |
following (Deprecates June 28, 2024) |
INTEGER | Number of following for this TikTok profile at the end of the current interval (e.g. a day, week, month). |
following (Deprecates June 28, 2024) |
INTEGER | Number of following for this TikTok profile at the beginning of the current interval (e.g. a day, week, month). |
following (Deprecates June 28, 2024) |
INTEGER | Change of the total number of following for this TikTok profile. |
net |
INTEGER | Number of net followers for this TikTok profile in the selected time interval. |
net |
INTEGER | The number of net followers gained by this TikTok profile in the period before the selected time interval, with both periods having the same number of days. |
net |
INTEGER | The difference in the number of net followers by this TikTok profile gained between the selected time interval and the previous period, with both periods having the same number of days. |
likes (Deprecates June 28, 2024) |
INTEGER | Number of likes (lifetime performance) for this TikTok profile at the end of the current interval (e.g. a day, week, month). |
likes (Deprecates June 28, 2024) |
INTEGER | Number of likes (lifetime performance) for this TikTok profile at the beginning of the current interval (e.g. a day, week, month). |
likes (Deprecates June 28, 2024) |
INTEGER | Change of the total number of likes (new likes) for this TikTok profile. |
own |
INTEGER | Number of posts created on this profile. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of likes on the profile's posts. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of comments on the profile's posts. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of shares on the profile's posts. This takes into account the creation time of the post and not when the interaction occurred. |
own |
INTEGER | Number of video views on the profile's posts. This includes video views of any length. This takes into account the creation time of the post and not when the interaction occurred. |
likes |
INTEGER | The number of times viewers liked the TikTok profile's posts in the selected time interval. |
likes |
INTEGER | The number of times viewers liked the TikTok profile's posts in the period before the selected time interval, with both periods having the same number of days. |
likes |
INTEGER | The difference in the number of times viewers liked the TikTok profile's posts between the selected time interval and the previous period, with both periods having the same number of days. |
comments | INTEGER | The number of times the profile's posts were commented in the selected time interval. |
comments |
INTEGER | The number of times the profile's posts were commented in the period before the selected time interval, with both periods having the same number of days. |
comments |
INTEGER | The difference in the number of times the profile's posts were commented between the selected time interval and the previous period, with both periods having the same number of days. |
shares | INTEGER | The number of times the profile's posts were shared in the selected time interval. |
shares |
INTEGER | The number of times the profile's posts were shared in the period before the selected time interval, with both periods having the same number of days. |
shares |
INTEGER | The difference in the number of times the profile's posts were shared between the selected time interval and the previous period, with both periods having the same number of days. |
video |
INTEGER | Number of video views on the profile's posts in the selected time interval. |
video |
INTEGER | The number of times the profile's posts was viewed in the period before the selected time interval, with both periods having the same number of days. |
video |
INTEGER | The difference in the number of times the profile's posts was viewed between the selected time interval and the previous period, with both periods having the same number of days. |
profile |
INTEGER | The number of times the profile was viewed in the selected time interval. |
profile |
INTEGER | The number of times the profile was viewed in the period before the selected time interval, with both periods having the same number of days. |
profile |
INTEGER | The difference in the number of times the profile was viewed between the selected time interval and the previous period, with both periods having the same number of days. |
audience |
OBJECT | Gender distribution in 0 to 1 scale of the TikTok account's all followers. This information is not available for accounts with less than 100 followers. The data is only available on the days with valid TIkTok Business connection. |
audience |
OBJECT | Top ten countries distribution in 0 to 1 scale of the TikTok account's all followers. This information is not available for accounts with less than 100 followers. The data is only available on the days with valid TIkTok Business connection. |
tiktokAnalyticsOwnPosts
Summary
Holding authenticated data about posts of TikTok profiles.
Hints
- TikTok analytics data has a delay up to 48 hours.
- Demographic metrics, such as countries, are only returned if there is data for 100 or more followers.
- If the data for the fields reach, fullVideoWatchedRate, totalTimeWatched, averageTimeWatched, impressionSource, and audienceCountries are unavailable, the reason is usually that the video has not been active (viewed/liked/commented/shared) for more than 7 days. To retrieve the data for these fields, you can view/like/comment/share the inactive video and retry after 48h.
- If a video is not returned, the reason is likely to be that the video has been filtered out due to violations, such as music copyright violation.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting from the social network. |
external |
STRING | The unique id of this post. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | The link to this post. |
description | STRING | The description of this post. |
hashtags | OBJECT | The hashtags used in this post. Provided as a list of hashtags, e.g. ["#dating", "#comedy"]. |
video |
DECIMAL | The duration of the video attached to this post, in seconds, up to three decimal places. |
video |
LINK | The URL of the attached video's cover in this post. |
music (Deprecates June 28, 2024) |
STRING | The unique id of the music used in this post. |
music (Deprecates June 28, 2024) |
STRING | The title of the music used in this post. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
followers | INTEGER | The number of followers this profile had on the day the post was published. |
likes | INTEGER | The number of times this post has been liked. |
comments | INTEGER | The number of times this post has been commented. |
shares | INTEGER | The number of times this post has been shared. |
views | INTEGER | The number of times viewers watched this post and it's attached video has been viewed. This includes video views of any length. |
interaction |
PERCENT | Holds the interaction rate of this post, defined as the sum of likes, comments and shares, divided by the number of views. |
reach | INTEGER | Total number of unique viewers who viewed the video. |
full |
DECIMAL | The percentage of viewers in 0 to 1 scale who finish watching the profile's video. |
total |
DECIMAL | The amount of time viewers spent watching the profile's video. |
average |
DECIMAL | The average time viewers spent watching the profile's video. |
impression |
OBJECT | Traffic source distribution of post view win 0 to 1 scale where its viewers discover the profile's post. The main source types on TikTok are the For You feed, the Following feed, sound pages, profile pages, search pages, and direct messages. The other types are grouped into "Other". |
audience |
OBJECT | Top ten countries distribution in 0 to 1 scale of the TikTok account's all followers. This information is not available for accounts with less than 100 followers. |
threadsInsights
Summary
Holding authenticated data for Threads profiles and their development over time. All numbers are aggregates across the whole Threads profile.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Threads only available since June 15, 2024.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
followers | INTEGER | Number of followers for this Threads profile at the end of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Number of followers for this Threads profile at the beginning of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Change of the total number of followers for this Threads profile. |
likes | INTEGER | Number of likes (lifetime performance) for this Threads profile at the end of the current interval (e.g. a day, week, month). |
likes |
INTEGER | Number of likes (lifetime performance) for this Threads profile at the beginning of the current interval (e.g. a day, week, month). |
likes |
INTEGER | Change of the total number of likes (new likes) for this Threads profile. |
replies | INTEGER | Number of replies (lifetime performance) for this Threads profile at the end of the current interval (e.g. a day, week, month). |
replies |
INTEGER | Number of replies (lifetime performance) for this Threads profile at the beginning of the current interval (e.g. a day, week, month). |
replies |
INTEGER | Change of the total number of replies (new replies) for this Threads profile. |
reposts | INTEGER | Number of reposts (lifetime performance) for this Threads profile at the end of the current interval (e.g. a day, week, month). |
reposts |
INTEGER | Number of reposts (lifetime performance) for this Threads profile at the beginning of the current interval (e.g. a day, week, month). |
reposts |
INTEGER | Change of the total number of reposts (new reposts) for this Threads profile. |
quotes | INTEGER | Number of quotes (lifetime performance) for this Threads profile at the end of the current interval (e.g. a day, week, month). |
quotes |
INTEGER | Number of quotes (lifetime performance) for this Threads profile at the beginning of the current interval (e.g. a day, week, month). |
quotes |
INTEGER | Change of the total number of quotes (new quotes) for this Threads profile. |
views | INTEGER | Number of views on the profile's posts in the selected time interval. |
views |
INTEGER | Number of quotes (lifetime performance) for this Threads profile at the beginning of the current interval (e.g. a day, week, month). |
views |
INTEGER | The difference in the number of times the profile's posts was viewed between the selected time interval and the previous period, with both periods having the same number of days. |
own |
INTEGER | Number of posts created in the selected time period |
threadsInsightsOwnPosts
Summary
Holding authenticated data about posts of Threads profiles.
Hints
- Threads only available since June 15, 2024.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting from the social network. |
external |
STRING | The unique id of this post. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | The link to this post. |
message | STRING | Represents text for a Threads post. |
attachment |
LINK | URL of thumbnail. This only shows up for Threads media with video. |
attachment |
LINK | The postโs media URL. |
type | STRING | The media type for a Threads post will be one of these values: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM, AUDIO, or REPOST_FACADE. |
is |
BOOLEAN | Indicates if the media is a quoted post made by another user. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
views | INTEGER | The number of times the post was viewed. |
likes | INTEGER | The number of times this post has been liked. |
replies | INTEGER | The number of times this post has been commented. |
reposts | INTEGER | The number of times the post was reposted. |
quotes | INTEGER | The number of times the post was quoted. |
threadsInsightsOwnReplies
Summary
Holding authenticated data about posts of Threads profiles.
Hints
- Threads only available since June 15, 2024.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting from the social network. |
external |
STRING | The unique id of this post. |
external |
STRING | The unique id of this post. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | The link to this post. |
message | STRING | Represents text for a Threads post. |
attachment |
LINK | URL of thumbnail. This only shows up for Threads media with video. |
attachment |
LINK | The postโs media URL. |
type | STRING | The media type for a Threads post will be one of these values: TEXT_POST, IMAGE, VIDEO, CAROUSEL_ALBUM or AUDIO. |
is |
BOOLEAN | Indicates if the media is a quoted post made by another user. |
has |
BOOLEAN | Indicates if the post has replies. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
views | INTEGER | The number of times the post was viewed. |
likes | INTEGER | The number of times this post has been liked. |
replies | INTEGER | The number of times this post has been commented. |
reposts | INTEGER | The number of times the post was reposted. |
quotes | INTEGER | The number of times the post was quoted. |
Summary
Holding public data for Twitter profiles and their development over time. All numbers are aggregates across the whole Twitter Profile. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Except for followers, following and lifetime Tweet metrics this data source calculates account-wide metrics by aggregating the results of all the Tweets and Mentions (data sources twitterOwnTweets and twitterMentions) created in each interval. This also means that days, weeks or months without any Tweets or Mentions published show 0 for all engagement metrics.
- This data source segments Tweets into Own Tweets, Retweeted Tweets and Replies. Learn more here.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
followers | INTEGER | Number of followers of the profile at the end of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Number of followers of the profile at the beginning of the current interval (e.g. a day, week, month). |
followers |
INTEGER | Change of followers of the profile between the beginning and the end of the current interval. |
following | INTEGER | Number of handles the profile is following at the end of the current interval (e.g. a day, week, month). |
following |
INTEGER | Number of handles the profile is following at the beginning of the current interval (e.g. a day, week, month). |
following |
INTEGER | Change of handles the profile is following between the beginning and end of the current interval. |
tweets | INTEGER | Total number of Tweets created since the creation of this profile at the end of the current interval (e.g. a day, week, month). This includes Own Tweets, Retweeted Tweets and Replies. |
tweets |
INTEGER | Total number of Tweets created since the creation of this profile at the beginning of the current interval (e.g. a day, week, month). This includes Own Tweets, Retweeted Tweets and Replies. |
tweets |
INTEGER | Change of the total number of Tweets created between the beginning and the end of the current interval. This includes Own Tweets, Retweeted Tweets and Replies. |
own |
INTEGER | Number of Own Tweets created. |
own |
INTEGER | Number of Retweets of Own Tweets. |
own |
INTEGER | Number of Likes on Own Tweets. |
own |
INTEGER | Number of Replies on Own Tweets. This value is calculated based on data source twitterMentions searching against a sampling of Tweets and thus should be considered a rough estimate. When you connect a profile for the first time, you can expect historic data for Replies up to 7 days old. |
retweeted |
INTEGER | Number of Retweeted Tweets created by the handle. |
replies | INTEGER | Number of Replies created by the handle. |
replies |
INTEGER | Number of Replies towards the handle. This value is calculated based on data source twitterMentions searching against a sampling of Tweets and thus should be considered a rough estimate. When you connect a profile for the first time, you can expect historic data for Replies up to 7 days old. |
retweets | INTEGER | Number of retweets on Own Tweets and Replies. |
favorites | INTEGER | Number of Likes on Own Tweets and Replies. |
mentions | INTEGER | Number of Tweets mentioning the @handle of selected Twitter profiles. Retweeted Tweets are excluded. |
response |
INTEGER | Number of questions asked that have been answered in less than 2 hours. |
response |
INTEGER | Number of questions asked that have been answered in 2 to 8 hours. |
response |
INTEGER | Number of questions asked that have been answered in 8 to 24 hours. |
response |
INTEGER | Number of questions asked that have been answered in more than a day. |
response |
INTEGER | Number of questions asked that have not been answered. |
questions | INTEGER | Number of all questions asked. |
twitterAnalyticsOwnTweets
Summary
Holding private-level information about Own Tweets of Twitter profiles, excluding Retweeted Tweets and Replies to users. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Hints
- This data source returns Own Tweets only. Learn more here.
- Twitter provides access to the most recent 3200 Tweets of a Twitter profile. This limit refers to the total set of Tweets, including Own Tweets, Retweeted Tweets and Replies to users. Thus initial imports will cover up to 3200 Tweets into the past. For the same reason metrics of Tweets cannot be updated if they have moved out of the 3200 Tweet window.
- Twitter provides 30 days historic access for private metrics of Tweets including impressions and engagements. Thus while initial imports will cover up to 3200 Tweets, private metrics for those Tweets can only be covered for up to 30 days. For the same reason private metrics of Tweets cannot be updated later than 30 days after their creation.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The unique id of this Tweet. |
internal |
STRING | The quintly internal ID of this post. |
conversation |
STRING | The Tweet ID of the original Tweet of the conversation (which includes direct replies, replies of replies). In case this is a standalone Tweet, it matches the ID of the Tweet itself (also present in "externalId"). |
link | LINK | The link to this Tweet. |
message | STRING | The contents of this Tweet. |
type | STRING | Type of this Tweet (Text, Link, Photo, Video or Animated GIF). |
source | LINK | The name of the source which was used to publish this Tweet. |
media |
STRING | The ID of the attached media in this Tweet. |
media |
LINK | The URL of the attached media in this Tweet. |
thumbnail |
LINK | The URL of the attached media's thumbnail in this Tweet. |
video |
INTEGER | The duration of the video attached to this Tweet, in milliseconds. Returns NULL for non-videos. |
mentions | OBJECT | The users mentioned in this Tweet. Provided as a list of objects, e.g. [{"username": "bmw", "start": 5, "end": 8}, ...]. |
hashtags | OBJECT | The hashtags used in this Tweet. Provided as a list of objects, e.g. [{"hashtag": "#bmw", "start": 5, "end": 9}, ...]. |
entity |
OBJECT | The entity annotations found in this Tweet. Tweet annotations offer a way to understand contextual information about the Tweet itself. Though 100% of Tweets are reviewed, due to the contents of Tweet text, only a portion are annotated. Provided as a list of objects, e.g. [{"type": "Product", "normalizedText": "Twitter", "probability": 0.626, "start": 144, "end": 150}, ...]. |
urls | OBJECT | The URLs/links used in this Tweet. Please be aware that the unwounded URL is not always provided. Provided as a list of objects, e.g. [{"url": "https://t.co/crkYRdjUB0", "displayUrl": "twitter.com", "expandedUrl": "https://twitter.com", "unwoundUrl": "https://twitter.com", "start": 44, "end": 67}, ...]. |
language | STRING | The language of this Tweet, if detected by Twitter. Returned as a BCP47 language tag. |
is |
BOOLEAN | Whether this Tweet is a Quote Tweet or not (Retweeted with a new comment). |
quoted |
STRING | The ID to the Tweet this Tweet quoted (Retweeted with a new comment). Returns NULL for Tweets that did not quote another Tweet. |
is |
BOOLEAN | Whether this Tweet has a poll attached or not. |
poll |
STRING | The ID to the attached poll. |
poll |
INTEGER | Number of minutes the poll attached to this Tweet lasted. |
poll |
DATETIME | The time the poll attached to this Tweet ended. |
is |
BOOLEAN | Whether the poll attached to this Tweet is still active and can receive votes, or if the voting is closed. |
poll |
INTEGER | Number of votes the poll attached to this Tweet got across all choices. |
poll |
OBJECT | The choices of the poll attached to this Tweet, including the vote count on each choice. Provided as a list of objects, e.g. [{"pos": 1, "label": "Choice A", "votes": 50}, ...]. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
followers | INTEGER | Number of followers the profile had on the day this Tweet was created. |
interaction |
PERCENT | Holds the interaction rate of this Tweet defined as Likes+Retweets+Replies divided by the number of Followers the profile had at the day this Tweet was created. Holds "null" if this Tweet is a Retweeted Tweet because it would standardize the interactions of the original Tweet with the number of Followers of the Twitter profile. |
impressions | INTEGER | Number of times this Tweet has been viewed (not unique by user). A view is counted if any part of the Tweet is visible on the screen. |
impressions |
INTEGER | Number of times this Tweet has been viewed in an organic context (not unique by user). A view is counted if any part of the Tweet is visible on the screen. |
impressions |
INTEGER | Number of times this Tweet has been viewed in a promoted context (not unique by user). A view is counted if any part of the Tweet is visible on the screen. |
engagements | INTEGER | Number of times this Tweet was engaged upon by a viewer in an organic and somewhat promoted context. Engagements include, but are not limited to, Likes, Retweets, Replies, URL Clicks, Hashtag Clicks, Mention Clicks, and Media Views. For Likes, Replies, Retweets, and Video Views, the Engagement API will return the total count of activities the Tweets got from either organic or promoted context, in order to maintain consistency with the counts shown publicly on Twitter. Since the Engagements metric is comprised of several metrics including the three metrics listed above, it is a combination of organic and promoted values. |
engagement |
PERCENT | Calculated as the ratio of engagements to impressions. Be aware that engagements cover mostly organic contexts (see above), while impressions cover both organic and promoted contexts. |
favs | INTEGER | Number of times this Tweet has been liked. |
favs |
INTEGER | Number of times this Tweet has been liked in an organic context. |
favs |
INTEGER | Number of times this Tweet has been liked in a promoted context. |
retweets | INTEGER | Number of times this Tweet has been Retweeted. This does not include Quote Tweets ("Retweets with comment"), these are covered by the "quoteTweets" metric. |
retweets |
INTEGER | Number of times this Tweet has been Retweeted in an organic context. This does not include Quote Tweets ("Retweets with comment"), these are covered by the quoteTweets metric. |
retweets |
INTEGER | Number of times this Tweet has been Retweeted in a promoted context. This does not include Quote Tweets ("Retweets with comment"), these are covered by the quoteTweets metric. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message). This does not include regular Retweets, these are covered by the "retweets" metric. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message) in an organic context. This does not include regular Retweets, these are covered by the "retweets" metric. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message) in a promoted context. This does not include regular Retweets, these are covered by the "retweets" metric. |
replies | INTEGER | Number of times this Tweet has been replied to. |
replies |
INTEGER | Number of times this Tweet has been replied to in an organic context. |
replies |
INTEGER | Number of times this Tweet has been replied to in a promoted context. |
video |
INTEGER | Number of times the video in the given Tweet has been 50% visible for at least two seconds. This is the number of video views aggregated across all Tweets in which the given video has been posted. That means that the metric includes the combined views from any instance where the video has been Retweeted or reposted in separate Tweets. |
video |
INTEGER | Number of times the video in the given Tweet has been 50% visible for at least two seconds in an organic context. This is the number of video views aggregated across all Tweets in which the given video has been posted. That means that the metric includes the combined views from any instance where the video has been Retweeted or reposted in separate Tweets. |
video |
INTEGER | Number of times the video in the given Tweet has been 50% visible for at least two seconds in a promoted context. This is the number of video views aggregated across all Tweets in which the given video has been posted. That means that the metric includes the combined views from any instance where the video has been Retweeted or reposted in separate Tweets. |
video |
OBJECT | The number of users who played through to each quartile in the video included in this Tweet. This reflects the number of quartile views across all Tweets in which the given video has been posted. Returns an object with attributes 0, 25, 50, 75 and 100, representing the quartiles as percentages. The values of these attributes hold the number of users as described. E.g. { 0: 100, 25: 90, 50: 80, 75: 50, 100: 25 }. |
video |
OBJECT | The number of users who played through to each quartile in the video included in this Tweet in an organic context. This reflects the number of quartile views across all Tweets in which the given video has been posted. Returns an object with attributes 0, 25, 50, 75 and 100, representing the quartiles as percentages. The values of these attributes hold the number of users as described. E.g. { 0: 100, 25: 90, 50: 80, 75: 50, 100: 25 }. |
video |
OBJECT | The number of users who played through to each quartile in the video included in this Tweet in a promoted context. This reflects the number of quartile views across all Tweets in which the given video has been posted. Returns an object with attributes 0, 25, 50, 75 and 100, representing the quartiles as percentages. The values of these attributes hold the number of users as described. E.g. { 0: 100, 25: 90, 50: 80, 75: 50, 100: 25 }. |
url |
INTEGER | Number of times a user clicks on a URL link or URL preview card in this Tweet. |
url |
INTEGER | Number of times a user clicks on a URL link or URL preview card in this Tweet in an organic context. |
url |
INTEGER | Number of times a user clicks on a URL link or URL preview card in this Tweet in a promoted context. |
user |
INTEGER | Number of times a user clicks the following portions of this Tweet: display name, user name, profile picture. |
user |
INTEGER | Number of times a user clicks the following portions of this Tweet in an organic context: display name, user name, profile picture. |
user |
INTEGER | Number of times a user clicks the following portions of this Tweet in a promoted context: display name, user name, profile picture. |
twitterAnalyticsOwnReplies
Summary
Holding private-level information about Replies to users of Twitter profiles. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Hints
- This data source returns Replies to users only. Learn more here. If combined with data source twitterAnalyticsOwnTweets it covers the set of all Tweets published by a Twitter profile.
- Twitter provides access to the most recent 3200 Tweets of a Twitter profile. This limit refers to the total set of Tweets, including Own Tweets, Retweeted Tweets and Replies to users. Thus initial imports will cover up to 3200 Tweets into the past. For the same reason metrics of Tweets cannot be updated if they have moved out of the 3200 Tweet window.
- Twitter provides 30 days historic access for private metrics of Tweets including impressions and engagements. Thus while initial imports will cover up to 3200 Tweets, private metrics for those Tweets can only be covered for up to 30 days. For the same reason private metrics of Tweets cannot be updated later than 30 days after their creation.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | Twitter's unique id of this Tweet. |
internal |
STRING | The quintly internal ID of this post. |
conversation |
STRING | The Tweet ID of the original Tweet of the conversation (which includes direct replies, replies of replies). In case this is a standalone Tweet, it matches the ID of the Tweet itself (also present in "externalId"). |
link | LINK | The link to this Tweet. |
message | STRING | The contents of this Tweet. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
type | STRING | Type of this Tweet (Text, Link, Photo, Video or Animated GIF). |
source | LINK | The name of the source which was used to publish this Tweet. |
media |
STRING | The ID of the attached media in this Tweet. |
media |
LINK | The URL of the attached media in this Tweet. |
thumbnail |
LINK | The URL of the attached media's thumbnail in this Tweet. |
video |
INTEGER | The duration of the video attached to this Tweet, in milliseconds. Returns NULL for non-videos. |
mentions | OBJECT | The users mentioned in this Tweet. Provided as a list of objects, e.g. [{"username": "bmw", "start": 5, "end": 8}, ...]. |
hashtags | OBJECT | The hashtags used in this Tweet. Provided as a list of objects, e.g. [{"hashtag": "#bmw", "start": 5, "end": 9}, ...]. |
entity |
OBJECT | The entity annotations found in this Tweet. Tweet annotations offer a way to understand contextual information about the Tweet itself. Though 100% of Tweets are reviewed, due to the contents of Tweet text, only a portion are annotated. Provided as a list of objects, e.g. [{"type": "Product", "normalizedText": "Twitter", "probability": 0.626, "start": 144, "end": 150}, ...]. |
urls | OBJECT | The URLs/links used in this Tweet. Please be aware that the unwounded URL is not always provided. Provided as a list of objects, e.g. [{"url": "https://t.co/crkYRdjUB0", "displayUrl": "twitter.com", "expandedUrl": "https://twitter.com", "unwoundUrl": "https://twitter.com", "start": 44, "end": 67}, ...]. |
language | STRING | The language of this Tweet, if detected by Twitter. Returned as a BCP47 language tag. |
reply |
STRING | The ID to the Tweet this Tweet replied to. |
reply |
LINK | The link to the Tweet this Tweet replied to. |
followers | INTEGER | Number of followers the profile had on the day this Tweet was created. |
interaction |
PERCENT | Holds the interaction rate of this Tweet defined as Likes+Retweets+Replies divided by the number of Followers the profile had at the day this Tweet was created. Holds "null" if this Tweet is a Retweeted Tweet because it would standardize the interactions of the original Tweet with the number of Followers of the Twitter profile. |
impressions | INTEGER | Number of times this Tweet has been viewed (not unique by user). A view is counted if any part of the Tweet is visible on the screen. |
impressions |
INTEGER | Number of times this Tweet has been viewed in an organic context (not unique by user). A view is counted if any part of the Tweet is visible on the screen. |
impressions |
INTEGER | Number of times this Tweet has been viewed in a promoted context (not unique by user). A view is counted if any part of the Tweet is visible on the screen. |
engagements | INTEGER | Number of times this Tweet was engaged upon by a viewer in an organic and somewhat promoted context. Engagements include, but are not limited to, Likes, Retweets, Replies, URL Clicks, Hashtag Clicks, Mention Clicks, and Media Views. For Likes, Replies, Retweets, and Video Views, the Engagement API will return the total count of activities the Tweets got from either organic or promoted context, in order to maintain consistency with the counts shown publicly on Twitter. Since the Engagements metric is comprised of several metrics including the three metrics listed above, it is a combination of organic and promoted values. |
engagement |
PERCENT | Calculated as the ratio of engagements to impressions. Be aware that engagements cover mostly organic contexts (see above), while impressions cover both organic and promoted contexts. |
favs | INTEGER | Number of times this Tweet has been liked. |
favs |
INTEGER | Number of times this Tweet has been liked in an organic context. |
favs |
INTEGER | Number of times this Tweet has been liked in a promoted context. |
retweets | INTEGER | Number of times this Tweet has been Retweeted. This does not include Quote Tweets ("Retweets with comment"), these are covered by the "quoteTweets" metric. |
retweets |
INTEGER | Number of times this Tweet has been Retweeted in an organic context. This does not include Quote Tweets ("Retweets with comment"), these are covered by the quoteTweets metric. |
retweets |
INTEGER | Number of times this Tweet has been Retweeted in a promoted context. This does not include Quote Tweets ("Retweets with comment"), these are covered by the quoteTweets metric. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message). This does not include regular Retweets, these are covered by the "retweets" metric. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message) in an organic context. This does not include regular Retweets, these are covered by the "retweets" metric. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message) in a promoted context. This does not include regular Retweets, these are covered by the "retweets" metric. |
replies | INTEGER | Number of times this Tweet has been replied to. |
replies |
INTEGER | Number of times this Tweet has been replied to in an organic context. |
replies |
INTEGER | Number of times this Tweet has been replied to in a promoted context. |
video |
INTEGER | Number of times the video in the given Tweet has been 50% visible for at least two seconds. This is the number of video views aggregated across all Tweets in which the given video has been posted. That means that the metric includes the combined views from any instance where the video has been Retweeted or reposted in separate Tweets. |
video |
INTEGER | Number of times the video in the given Tweet has been 50% visible for at least two seconds in an organic context. This is the number of video views aggregated across all Tweets in which the given video has been posted. That means that the metric includes the combined views from any instance where the video has been Retweeted or reposted in separate Tweets. |
video |
INTEGER | Number of times the video in the given Tweet has been 50% visible for at least two seconds in a promoted context. This is the number of video views aggregated across all Tweets in which the given video has been posted. That means that the metric includes the combined views from any instance where the video has been Retweeted or reposted in separate Tweets. |
video |
OBJECT | The number of users who played through to each quartile in the video included in this Tweet. This reflects the number of quartile views across all Tweets in which the given video has been posted. Returns an object with attributes 0, 25, 50, 75 and 100, representing the quartiles as percentages. The values of these attributes hold the number of users as described. E.g. { 0: 100, 25: 90, 50: 80, 75: 50, 100: 25 }. |
video |
OBJECT | The number of users who played through to each quartile in the video included in this Tweet in an organic context. This reflects the number of quartile views across all Tweets in which the given video has been posted. Returns an object with attributes 0, 25, 50, 75 and 100, representing the quartiles as percentages. The values of these attributes hold the number of users as described. E.g. { 0: 100, 25: 90, 50: 80, 75: 50, 100: 25 }. |
video |
OBJECT | The number of users who played through to each quartile in the video included in this Tweet in a promoted context. This reflects the number of quartile views across all Tweets in which the given video has been posted. Returns an object with attributes 0, 25, 50, 75 and 100, representing the quartiles as percentages. The values of these attributes hold the number of users as described. E.g. { 0: 100, 25: 90, 50: 80, 75: 50, 100: 25 }. |
url |
INTEGER | Number of times a user clicks on a URL link or URL preview card in this Tweet. |
url |
INTEGER | Number of times a user clicks on a URL link or URL preview card in this Tweet in an organic context. |
url |
INTEGER | Number of times a user clicks on a URL link or URL preview card in this Tweet in a promoted context. |
user |
INTEGER | Number of times a user clicks the following portions of this Tweet: display name, user name, profile picture. |
user |
INTEGER | Number of times a user clicks the following portions of this Tweet in an organic context: display name, user name, profile picture. |
user |
INTEGER | Number of times a user clicks the following portions of this Tweet in a promoted context: display name, user name, profile picture. |
twitterKeyInteractingUsers
Summary
Holding information about Twitter users mentioning Twitter profiles, sorting by most active Twitter users by default. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Hints
- This data source is based on twitterMentions, grouping the Mentions by their authors. If multiple Twitter profiles are selected, it can show if users have mentioned multiple of the selected profiles.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
id | STRING | No documentation available yet |
name | STRING | No documentation available yet |
mentions | INTEGER | No documentation available yet |
overlaps | STRING | No documentation available yet |
overlaps |
INTEGER | No documentation available yet |
twitterMentions
Summary
Holding information about Tweets mentioning the @handle of selected Twitter profiles. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Hints
- When you connect a profile for the first time, you can expect historic data for Tweets up to 7 days old.
- Data imports work stream-based and continue where the last import ended. Thus every Mention is only captured once with the state present at this point in time. When using engagement metrics of Mentions be aware that the snapshot might not be up to date. Use the column importTime to identify when the specific Mention has been last updated.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | Twitter's unique id of this Tweet. |
user |
STRING | The unique id of the user who created this Tweet. |
user |
STRING | The @handle of the user who created this Tweet. |
user |
INTEGER | Number of followers of the user who created this Tweet. |
user |
STRING | The location of the user who created this Tweet. |
message | STRING | The contents of this Tweet. |
link | LINK | The link to this Tweet. |
is |
BOOLEAN | Whether this Tweet is a Retweeted Tweet or not. |
retweet |
STRING | If this Tweet is a Retweeted Tweet, this column holds the unique id of the Tweet that has been retweeted. |
retweet |
STRING | If this Tweet is a Retweeted Tweet, this column holds the unique id of the user who has published the Tweet that has been retweeted. |
is |
BOOLEAN | Whether this Tweet is a reply to another Tweet or not. |
reply |
STRING | If this Tweet is a reply to another Tweet, this column holds the unique id of the Tweet that has been replied to. |
is |
BOOLEAN | Whether this Tweet is a question or not. A question is defined as any Mention containing a question mark. |
response |
DATETIME | The date when the profile replied to this Tweet. Learn more here. |
time |
INTEGER | Number of seconds since the creation of this Tweet until the reply of the profile. Learn more here. |
retweets | INTEGER | Number of Retweets this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Retweets of the original Tweet. |
favs | INTEGER | Number of Likes this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Likes of the original Tweet. |
lat | DECIMAL | The location's latitude if this Tweet is geo-tagged with a point location. |
lon | DECIMAL | The location's longitude if this Tweet is geo-tagged with a point location. |
place |
STRING | The place's type if this Tweet is geo-tagged with a Twitter Place. |
place |
STRING | The place's country name if this Tweet is geo-tagged with a Twitter Place. |
place |
STRING | The place's country code if this Tweet is geo-tagged with a Twitter Place. |
place |
STRING | The place's name if this Tweet is geo-tagged with a Twitter Place. |
twitterOwnReplies
Summary
Holding information about Replies to users of Twitter profiles, excluding Own Tweets and Retweeted Tweets. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Hints
- This data source returns Replies to users only. Learn more here. If combined with data source twitterOwnTweets it covers the set of all Tweets published by a Twitter profile.
- Twitter provides access to the most recent 3200 Tweets of a Twitter profile. This limit refers to the total set of Tweets, including Own Tweets, Retweeted Tweets and Replies to users. Thus initial imports will cover up to 3200 Tweets into the past. For the same reason metrics of Tweets cannot be updated if they have moved out of the 3200 Tweet window.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | Twitter's unique id of this Tweet. |
internal |
STRING | The quintly internal ID of this post. |
type | STRING | Type of this Tweet. |
media |
STRING | The ID of the attached media in this Tweet. |
media |
LINK | The URL of the attached media in this Tweet. |
link | LINK | The link to this Tweet. |
message | STRING | The contents of this Tweet. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
reply |
STRING | The ID of the Tweet this Tweet replied to. |
source | STRING | The name of the source which was used to publish this Tweet. |
followers | INTEGER | Number of followers the profile had on the day the Tweet was created. |
interaction |
PERCENT | Holds the interaction rate of this Tweet defined as Likes+Retweets+Replies divided by the number of Followers the profile had at the day this Tweet was created. Holds "null" if this Tweet is a Retweeted Tweet because it would standardize the interactions of the original Tweet with the number of Followers of the Twitter profile. |
retweets | INTEGER | Number of Retweets this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Retweets of the original Tweet. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message). This does not include regular Retweets, these are covered by the "retweets" metric. |
favs | INTEGER | Number of Likes this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Likes of the original Tweet. |
replies | INTEGER | Number of direct Replies by a different user on the original Tweet. It does not include Replies by the creator of the original Tweet. If this Tweet is a Retweeted Tweet it does not include Replies on Retweets. This value should be considered an estimate. |
bookmarks | INTEGER | Number of Bookmarks this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Likes of the original Tweet. |
twitterOwnTweets
Summary
Holding information about Own Tweets and Retweeted Tweets of Twitter profiles, excluding Replies to users. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Hints
- This data source returns Own Tweets and Retweeted Tweets only. Learn more here. If combined with data source twitterOwnReplies it covers the set of all Tweets published by a Twitter profile.
- Twitter provides access to the most recent 3200 Tweets of a Twitter profile. This limit refers to the total set of Tweets, including Own Tweets, Retweeted Tweets and Replies to users. Thus initial imports will cover up to 3200 Tweets into the past. For the same reason metrics of Tweets cannot be updated if they have moved out of the 3200 Tweet window.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | Twitter's unique id of this Tweet. |
internal |
STRING | The quintly internal ID of this post. |
type | STRING | Type of this Tweet. |
media |
STRING | The ID of the attached media in this Tweet. |
media |
LINK | The URL of the attached media in this Tweet. |
link | LINK | The link to this Tweet. |
message | STRING | The contents of this Tweet. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
is |
BOOLEAN | Whether this Tweet is a Retweeted Tweet or not. |
is |
BOOLEAN | Whether this Tweet is withheld or not. Learn more about country withheld content here. |
source | STRING | The name of the source which was used to publish this Tweet. |
followers | INTEGER | Number of followers the profile had on the day this Tweet was created. |
interaction |
PERCENT | Holds the interaction rate of this Tweet defined as Likes+Retweets+Replies divided by the number of Followers the profile had at the day this Tweet was created. Holds "null" if this Tweet is a Retweeted Tweet because it would standardize the interactions of the original Tweet with the number of Followers of the Twitter profile. |
retweets | INTEGER | Number of Retweets this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Retweets of the original Tweet. |
quote |
INTEGER | Number of times this Tweet has been Retweeted with a new comment (message). This does not include regular Retweets, these are covered by the "retweets" metric. |
favs | INTEGER | Number of Likes this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Likes of the original Tweet. |
replies | INTEGER | Number of direct Replies by a different user on the original Tweet. It does not include Replies by the creator of the original Tweet. If this Tweet is a Retweeted Tweet it does not include Replies on Retweets. This value is calculated based on data source twitterMentions searching against a sampling of Tweets and thus should be considered a rough estimate. |
bookmarks | INTEGER | Number of Bookmarks this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Likes of the original Tweet. |
twitterQuestions
Summary
Holding information about questions sent to Twitter profiles in form of a Twitter Mention. To comply with the terms and conditions of Twitter, this data source is not accessible via the quintly API, however you can still access Twitter data directly in the tool.
Hints
- This data source is a subset of twitterMentions, showing Mentions identified as a question.
- A question is defined as any Mention containing a question mark.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | The time this posting was created. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | Twitter's unique id of this Tweet. |
user |
STRING | The @handle of the user who created this Tweet. |
user |
INTEGER | Number of followers of the user who created this Tweet. |
user |
STRING | The location of the user who created this Tweet. |
message | STRING | The contents of this Tweet. |
link | LINK | The link to this Tweet. |
is |
BOOLEAN | Whether this Tweet is a Retweeted Tweet or not. Always false as this data source excludes Retweeted Tweets. |
is |
BOOLEAN | Whether this Tweet is a reply to a user or not. |
is |
BOOLEAN | Whether this Tweet is a question or not. A question is defined as any Mention containing a question mark. This is always true for this data source. |
response |
DATETIME | The date when the profile replied to this Tweet. Learn more here. |
time |
INTEGER | Number of seconds since the creation of this Tweet until the reply of the profile. Learn more here. |
retweets | INTEGER | Number of Retweets this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Retweets of the original Tweet. |
favs | INTEGER | Number of Likes this Tweet got. If this Tweet is a Retweeted Tweet it shows the number of Likes of the original Tweet. |
lat | DECIMAL | The location's latitude if this Tweet is geo-tagged with a point location. |
lon | DECIMAL | The location's longitude if this Tweet is geo-tagged with a point location. |
place |
STRING | The place's type if this Tweet is geo-tagged with a Twitter Place. |
place |
STRING | The place's country name if this Tweet is geo-tagged with a Twitter Place. |
place |
STRING | The place's country code if this Tweet is geo-tagged with a Twitter Place. |
place |
STRING | The place's name if this Tweet is geo-tagged with a Twitter Place. |
youtube
Summary
Holding public data for YouTube channels and their development over time. All numbers are aggregates across the whole YouTube channel.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Historic access is limited to 30 days. Learn more about YouTube's 30-day data limitation here.
- Subscriber counts are shown in abbreviated form. Learn more here.
- Columns with the "Counted" suffix were calculated by walking over all videos present at this point in time and summing up their individual numbers.
- Columns with the "Before" suffix reflect the lifetime number at the beginning of the selected time period.
- Columns with the "Change" suffix reflect the change of a lifetime metric from the beginning to the end of the selected time period.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
subscribers | INTEGER | Total number of subscribers for this YouTube channel at the end of the current interval (e.g. a day, week, month). |
subscribers |
INTEGER | Total number of subscribers for this YouTube channel at the beginning of the current interval (e.g. a day, week, month). |
subscribers |
INTEGER | Change of the total number of subscribers for this YouTube channel between the beginning and the end of the interval. |
views | INTEGER | Total number of views (lifetime performance) for this YouTube channel at the end of the current interval (e.g. a day, week, month). |
views |
INTEGER | Total number of views (lifetime performance) for this YouTube channel at the beginning of the current interval (e.g. a day, week, month). |
views |
INTEGER | Change of the total number of views (new views) for this YouTube channel between the beginning and the end of the interval. |
videos | INTEGER | Total number of videos for this YouTube channel at the end of the current interval (e.g. a day, week, month). |
videos |
INTEGER | Total number of videos for this YouTube channel at the beginning of the current interval (e.g. a day, week, month). |
videos |
INTEGER | Change of the total videos (new videos) for this YouTube channel between the beginning and the end of the interval. |
channel (Deprecates November 28, 2020) |
INTEGER | Total number of channel comments (lifetime performance) for this YouTube channel at the end of the current interval (e.g. a day, week, month). This metric has been deprecated by YouTube. |
channel (Deprecates November 28, 2020) |
INTEGER | Total number of channel comments (lifetime performance) for this YouTube channel at the beginning of the current interval (e.g. a day, week, month). This metric has been deprecated by YouTube. |
channel (Deprecates November 28, 2020) |
INTEGER | Change of the total number of channel comments (new comments) for this YouTube channel between the beginning and the end of the interval. This metric has been deprecated by YouTube. |
videos |
INTEGER | Total number of videos for this YouTube channel at the end of the interval by counting all videos. |
videos |
INTEGER | Total number of videos for this YouTube channel at the beginning of the interval by counting all videos. |
videos |
INTEGER | Change of the total number of videos for this YouTube channel between the beginning and the end of the interval by counting all videos. |
youtubeAnalytics
Summary
Holding private-level data for YouTube channels and their development over time. All numbers are aggregates across the whole YouTube channel.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by YouTube.
- For metrics ending in *Lifetime, all numbers relate to the lifetime performance since the channel was created until the end of the current interval.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
videos | INTEGER | Number of videos published in the current interval (e.g a day, week, month). |
views | INTEGER | Number of times that a video was viewed. |
red |
INTEGER | Number of times that a video was viewed by YouTube Premium (formerly YouTube Red) members. |
likes | INTEGER | Number of times that users indicated that they liked a video by giving it a positive rating. |
dislikes | INTEGER | Number of times that users indicated that they disliked a video by giving it a negative rating. |
comments | INTEGER | Number of times that users commented on a video. Please note that this does not include replies to comments. |
shares | INTEGER | Number of times that users shared a video through the Share button. |
videos |
INTEGER | Number of times that videos of this channel were added to any YouTube playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
videos |
INTEGER | Number of times that videos of this channel were removed from any YouTube playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
estimated |
INTEGER | Number of minutes that users watched videos for the specified channel. |
estimated |
INTEGER | Number of minutes that YouTube Premium (formerly YouTube Red) members watched videos for the specified channel. |
average |
INTEGER | The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. |
average |
PERCENT | The average percentage of a video watched during a video playback. As of December 13, 2021, this metric excludes looping clips traffic. |
annotation |
INTEGER | The total number of annotation impressions. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. |
annotation |
INTEGER | Number of annotations that appeared and could be clicked. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. |
annotation |
INTEGER | Number of clicked annotation. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. |
annotation |
PERCENT | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. |
annotation |
INTEGER | Number of annotations that appeared and could be closed. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. |
annotation |
INTEGER | Number of closed annotations. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. |
annotation |
PERCENT | The ratio of annotations that viewers closed to the total number of annotation impressions. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. |
card |
INTEGER | Number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards. |
card |
INTEGER | Number of times that cards were clicked. |
card |
PERCENT | The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions. |
card |
INTEGER | Number of times that card teasers were displayed. A video view can generate multiple teaser impressions. |
card |
INTEGER | Number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user. |
card |
PERCENT | The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
subscribers |
INTEGER | Number of times that users subscribed to a channel. |
subscribers |
INTEGER | Number of times that users unsubscribed from a channel. |
public |
INTEGER | Total number of public videos at the end of the current interval. This metric does not contain deleted videos. |
public |
INTEGER | Total number of public videos before the current interval (e.g. a day, week, month).. This metric does not contain deleted videos. |
public |
INTEGER | Change of total number of public videos. This metric does not contain deleted videos. |
videos |
INTEGER | Total number of videos published at the end of the current interval. Be aware that this metric contains deleted videos. |
videos |
INTEGER | Total number of videos published before the current interval (e.g. a day, week, month). |
videos |
INTEGER | Change of total number of videos published. |
views |
INTEGER | Number of times that a video was viewed (lifetime performance). |
views |
INTEGER | Number of times that a video was viewed (lifetime performance) before the current interval (e.g. a day, week, month). |
views |
INTEGER | Change of number of times that a video was viewed (lifetime performance). |
red |
INTEGER | Number of times that a video was viewed by YouTube Premium (formerly YouTube Red) members (lifetime performance). |
likes |
INTEGER | Number of times that users indicated that they liked a video by giving it a positive rating (lifetime performance). |
likes |
INTEGER | Total number of times that users indicated that they liked a video by giving it a positive rating before the current interval (e.g. a day, week, month). |
likes |
INTEGER | Change of total number of times that users indicated that they liked a video by giving it a positive rating. |
dislikes |
INTEGER | Number of times that users indicated that they disliked a video by giving it a negative rating (lifetime performance). |
dislikes |
INTEGER | Total number of times that users indicated that they disliked a video by giving it a negative rating before the current interval (e.g. a day, week, month). |
dislikes |
INTEGER | Change of total number of times that users indicated that they disliked a video by giving it a negative rating. |
comments |
INTEGER | Number of times that users commented on a video (lifetime performance). Please note that this does not include replies to comments. |
comments |
INTEGER | Total number of times that users commented on a video before the current interval (e.g. a day, week, month). |
comments |
INTEGER | Change of total number of times that users commented on a video. |
videos |
INTEGER | Number of times that videos of this channel were added to any YouTube playlists (lifetime performance). The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
videos |
INTEGER | Number of times that videos of this channel were removed from any YouTube playlists (lifetime performance). The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. |
shares |
INTEGER | Number of times that users shared a video through the Share button (lifetime performance). |
shares |
INTEGER | Total number of times that users shared a video before the current interval (e.g. a day, week, month). |
shares |
INTEGER | Change of total number of times that users shared a video. |
estimated |
INTEGER | Number of minutes that users watched videos for the specified channel (lifetime performance). |
estimated |
INTEGER | Number of minutes that YouTube Premium (formerly YouTube Red) members watched videos for the specified channel (lifetime performance). |
average |
INTEGER | The average length, in seconds, of video playbacks (lifetime performance). As of December 13, 2021, this metric excludes looping clips traffic. |
average |
PERCENT | The average percentage of a video watched during a video playback (lifetime performance). As of December 13, 2021, this metric excludes looping clips traffic. |
card |
INTEGER | Number of times cards were displayed (lifetime performance). When the card panel is opened, a card impression is logged for each of the video's cards. |
card |
INTEGER | Number of times that cards were clicked (lifetime performance). |
card |
PERCENT | The click-through-rate for cards (lifetime performance), which is calculated as the ratio of card clicks to card impressions. |
card |
INTEGER | Number of times that card teasers were displayed (lifetime performance). A video view can generate multiple teaser impressions. |
card |
INTEGER | Number of clicks on card teasers (lifetime performance). Card icon clicks are attributed to the last teaser displayed to the user. |
card |
PERCENT | The click-through-rate for card teasers (lifetime performance), which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
subscribers |
INTEGER | Number of times that users subscribed to a channel (lifetime performance). |
subscribers |
INTEGER | Number of times that users unsubscribed from a channel (lifetime performance). |
subscribers |
INTEGER | Number of subscribers of a channel (lifetime performance). |
subscribers |
INTEGER | Number of subscribers of a channel (lifetime performance) before the current interval (e.g. a day, week, month). |
subscribers |
INTEGER | Change of the number of subscribers of a channel (lifetime performance). |
views |
OBJECT | Number of times that a video was viewed, segmented by age group and gender. Age group and gender information is only available for logged-in YouTube users. E.g. [{"ageGroup":"age25-34","ageGroupName":"25-34 years","gender":"female","genderName":"Female","value":100}]. Possible age group and gender types can be found here. |
views |
OBJECT | The percentage of views by age and gender who were logged in when watching the video or playlist. E.g. [{"ageGroup":"age25-34","ageGroupName":"25-34 years","gender":"female","genderName":"Female","value":100}]. Possible types can be found here. |
views |
OBJECT | Number of times that a video was viewed, segmented by age group. Age group information is only available for logged-in YouTube users. E.g. [{"ageGroup":"age25-34","ageGroupName":"25-34 years","value":100}]. Possible age group types can be found here. |
views |
OBJECT | The percentage of views by age who were logged in when watching the video or playlist. E.g. [{"ageGroup":"age25-34","ageGroupName":"25-34 years","value":100}]. Possible types can be found here. |
views |
OBJECT | Number of times that a video was viewed, segmented by gender. Gender information is only available for logged-in YouTube users. E.g. [{"gender":"female","genderName":"Female","value":100}]. Possible gender types can be found here. |
views |
OBJECT | The percentage of viewers who were logged in when watching the video, segmented by gender. E.g. [{"gender":"female","genderName":"Female","value":100}]. Possible gender types can be found here. |
views |
OBJECT | Number of times that a video was viewed, segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
likes |
OBJECT | Number of times that users indicated that they liked a video by giving it a positive rating, segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
dislikes |
OBJECT | Number of times that users indicated that they disliked a video by giving it a negative rating, segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
comments |
OBJECT | Number of times that users commented on a video, segmented by country. Please note that this does not include replies to comments. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
shares |
OBJECT | Number of times that users shared a video through the Share button, segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
videos |
OBJECT | Number of times that videos of this channel were added to any YouTube playlists, segmented by country. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
videos |
OBJECT | Number of times that videos of this channel were removed from any YouTube playlists, segmented by country. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
average |
OBJECT | The average length, in seconds, of video playbacks, segmented by country. As of December 13, 2021, this metric excludes looping clips traffic. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
average |
OBJECT | The average percentage of a video watched during a video playback, segmented by country. As of December 13, 2021, this metric excludes looping clips traffic. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
annotation |
OBJECT | The total number of annotation impressions, segmented by country. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
annotation |
OBJECT | Number of annotations that appeared and could be clicked, segmented by country. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
annotation |
OBJECT | Number of clicked annotation, segmented by country. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
annotation |
OBJECT | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions, segmented by country. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
annotation |
OBJECT | Number of annotations that appeared and could be closed, segmented by country. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
annotation |
OBJECT | Number of closed annotations, segmented by country. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
annotation |
OBJECT | The ratio of annotations that viewers closed to the total number of annotation impressions, segmented by country. This metric might be not available from Jan 15th 2019 onwards, as YouTube started to remove the annotation feature at that date. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
card |
OBJECT | Number of times cards were displayed, segmented by country. When the card panel is opened, a card impression is logged for each of the video's cards. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
card |
OBJECT | Number of times that cards were clicked, segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
card |
OBJECT | The click-through-rate for cards, segmented by country, which is calculated as the ratio of card clicks to card impressions. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
card |
OBJECT | Number of times that card teasers were displayed, segmented by country. A video view can generate multiple teaser impressions. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
card |
OBJECT | Number of clicks on card teasers, segmented by country. Card icon clicks are attributed to the last teaser displayed to the user. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
card |
OBJECT | The click-through-rate for card teasers, segmented by country, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
subscribers |
OBJECT | Number of times that users unsubscribed from a channel, segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
subscribers |
OBJECT | Number of times that a video was viewed (lifetime performance), segmented by country. The two-letter ISO-3166-1 country code is used. The country code ZZ is used when YouTube could not identify the associated country of a user. E.g. [{"country": "MX", "countryName": "Mexico", "value": 1}]. |
views |
OBJECT | Number of times that a video was viewed, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
red |
OBJECT | Number of times that a video was viewed by YouTube Premium (formerly YouTube Red) members, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
likes |
OBJECT | Number of times that users indicated that they liked a video by giving it a positive rating, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
dislikes |
OBJECT | Number of times that users indicated that they disliked a video by giving it a negative rating, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
comments |
OBJECT | Number of times that users commented on a video, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
shares |
OBJECT | Number of times that users shared a video through the Share button, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
videos |
OBJECT | Number of times that videos of this channel were added to any YouTube playlists, segmented by subscribed status. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
videos |
OBJECT | Number of times that videos of this channel were removed from any YouTube playlists, segmented by subscribed status. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
estimated |
OBJECT | Number of minutes that YouTube Premium (formerly YouTube Red) members watched videos for the specified channel, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's videos, then subscribes to the channel and watches another video, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
average |
OBJECT | The average length, in seconds, of video playbacks on the YouTube channel by subscribed status. As of December 13, 2021, this metric excludes looping clips traffic. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":1}]. Possible subscribed status types are SUBSCRIBED and UNSUBSCRIBED. |
views |
OBJECT | Number of times that a video was viewed, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
red |
OBJECT | Number of times that a video was viewed by YouTube Premium (formerly YouTube Red) members, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
likes |
OBJECT | Number of times that users indicated that they liked a video by giving it a positive rating, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
dislikes |
OBJECT | Number of times that users indicated that they disliked a video by giving it a negative rating, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
comments |
OBJECT | Number of times that users commented on a video, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
shares |
OBJECT | Number of times that users shared a video through the Share button, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
videos |
OBJECT | Number of times that videos of this channel were added to any YouTube playlists, segmented by youtube product. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, and then adds it again, the metric value reflects the video being added to a playlist twice. Data for this metric is not available for dates before October 1, 2014. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
videos |
OBJECT | Number of times that videos of this channel were removed from any YouTube playlists, segmented by youtube product. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. This metric returns an absolute number, meaning that if a user adds a video to a playlist, removes it, adds it again, and then removes it again, the metric value reflects the video being removed from a playlist twice. Data for this metric is not available for dates before October 1, 2014. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
estimated |
OBJECT | Number of minutes that YouTube Premium (formerly YouTube Red) members watched videos for the specified channel, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
average |
OBJECT | The average length, in seconds, of video playbacks on the YouTube channel by youtube product. As of December 13, 2021, this metric excludes looping clips traffic. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":1}]. Possible youtube product types are SUBSCRIBED and UNSUBSCRIBED. |
views |
OBJECT | Number of times that a video was viewed, segmented by live or on-demand. Live covers user activity associated with views of a live broadcast. E.g. [{"liveOrOnDemand":"LIVE","liveOrOnDemandName":"Live broadcast","value":13},{"liveOrOnDemand":"ON_DEMAND","liveOrOnDemandName":"Not live broadcast","value":21}]. Possible live or on-demand types are LIVE and ON_DEMAND. |
red |
OBJECT | Number of times that a video was viewed by YouTube Premium (formerly YouTube Red) members, segmented by live or on-demand. Live covers user activity associated with views of a live broadcast. E.g. [{"liveOrOnDemand":"LIVE","liveOrOnDemandName":"Live broadcast","value":13},{"liveOrOnDemand":"ON_DEMAND","liveOrOnDemandName":"Not live broadcast","value":21}]. Possible live or on-demand types are LIVE and ON_DEMAND. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by live or on-demand. Live covers user activity associated with views of a live broadcast. E.g. [{"liveOrOnDemand":"LIVE","liveOrOnDemandName":"Live broadcast","value":13},{"liveOrOnDemand":"ON_DEMAND","liveOrOnDemandName":"Not live broadcast","value":21}]. Possible live or on-demand types are LIVE and ON_DEMAND. |
estimated |
OBJECT | Number of minutes that YouTube Premium (formerly YouTube Red) members watched videos for the specified channel, segmented by live or on-demand. Live covers user activity associated with views of a live broadcast. E.g. [{"liveOrOnDemand":"LIVE","liveOrOnDemandName":"Live broadcast","value":13},{"liveOrOnDemand":"ON_DEMAND","liveOrOnDemandName":"Not live broadcast","value":21}]. Possible live or on-demand types are LIVE and ON_DEMAND. |
average |
OBJECT | The average length, in seconds, of video playbacks, segmented by live or on-demand. As of December 13, 2021, this metric excludes looping clips traffic. Live covers user activity associated with views of a live broadcast. E.g. [{"liveOrOnDemand":"LIVE","liveOrOnDemandName":"Live broadcast","value":13},{"liveOrOnDemand":"ON_DEMAND","liveOrOnDemandName":"Not live broadcast","value":21}]. Possible live or on-demand types are LIVE and ON_DEMAND. |
views |
OBJECT | Number of times that a video was viewed, segmented by playback location. The playback location provides insight about the page or application where user activity occurred. E.g. [{"playbackLocation":"WATCH","playbackLocationName":"YouTube watch page","value":32}]. Possible playback location types can be found here. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by playback location. The playback location provides insight about the page or application where user activity occurred. E.g. [{"playbackLocation":"WATCH","playbackLocationName":"YouTube watch page","value":32}]. Possible playback location types can be found here. |
views |
OBJECT | Number of times that a video was viewed, segmented by traffic source. Traffic sources are based on the referrer type, which describes the manner in which users reached the video. E.g. [{"trafficSource":"NO_LINK_OTHER","trafficSourceName":"Direct or unknown","value":2}]. Possible traffic source types can be found here. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by traffic source. Traffic sources are based on the referrer type, which describes the manner in which users reached the video. E.g. [{"trafficSource":"NO_LINK_OTHER","trafficSourceName":"Direct or unknown","value":2}]. Possible traffic source types can be found here. |
views |
OBJECT | Number of times that a video was viewed, segmented by device type. Device types identify the physical form factor of the device on which the view occurred. E.g. [{"deviceType":"DESKTOP","deviceTypeName":"Computer","value":31}]. Possible device types can be found here. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by device type. Device types identify the physical form factor of the device on which the view occurred. E.g. [{"deviceType":"DESKTOP","deviceTypeName":"Computer","value":31}]. Possible device types can be found here. |
views |
OBJECT | Number of times that a video was viewed, segmented by operating system. Operating systems identify the software system of the device on which the view occurred. E.g. [{"operatingSystem":"MACINTOSH","operatingSystemName":"Macintosh","value":26}]. Possible operating system types can be found here. |
estimated |
OBJECT | Number of minutes that users watched videos for the specified channel, segmented by operating system. Operating systems identify the software system of the device on which the view occurred. E.g. [{"operatingSystem":"MACINTOSH","operatingSystemName":"Macintosh","value":26}]. Possible operating system types can be found here. |
youtubeAnalyticsCountries
Summary
Holding private-level data for YouTube channels per country.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by YouTube.
- All numbers relate to the performance within the selected time period. E.g. the views only include those accumulated during the selected time period.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
country |
STRING | The country associated with the metrics in the report row. The dimension value is a two-letter ISO-3166-1 country code, such as US, CN (China), or FR (France). The country code ZZ is used to report metrics for which YouTube could not identify the associated country. |
country |
STRING | The full name of the country from the country Code. |
views | INTEGER | Total number of views counted on this date for the Youtube Channel at the end of the current interval (e.g. a day, week, month). |
likes | INTEGER | Total number of likes for the Youtube Channel at the end of the current interval (e.g. a day, week, month). |
dislikes | INTEGER | Total number of dislikes for the Youtube Channel at the end of the current interval (e.g. a day, week, month). |
subscribers |
INTEGER | The number of people who unsubscribed from the channel during the selected timeframe. |
subscribers |
INTEGER | The number of people who subscribed to the channel during the selected timeframe. |
shares | INTEGER | Total number of shares for the youtube channel at the end of the current interval (e.g. a day, week, month). |
estimated |
INTEGER | The number of minutes that users watched videos for the youtube channel. |
comments | INTEGER | Total number of top-level comments posted on the YouTube channel in the selected time range. Please note that this count does not include replies to comments. |
average |
INTEGER | The average length, in seconds, of video playbacks for the youtube channel. As of December 13, 2021, this metric excludes looping clips traffic. |
annotation |
INTEGER | The ratio of annotations that viewers closed to the total number of annotation impressions. |
annotation |
INTEGER | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. |
average |
PERCENT | The average percentage of a video watched during a video playback. |
youtubeAnalyticsDevices
Summary
Holding private-level data for YouTube channels per device and their development over time. This data source is going to be deprecated and can be replaced with the columns where the name ends with "ByDeviceType" in the data source "youtubeAnalytics".
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by YouTube.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
device |
ENUM | Identifies the physical form factor of the device on which the view occurred. One of: DESKTOP, GAME_CONSOLE, MOBILE, TABLET, TV, UNKNOWN_PLATFORM |
device |
STRING | Readable representation of deviceType. For example: "DESKTOP" => "Laptop and desktops" |
views | INTEGER | Total number of views counted on this date for the Youtube Channel at the end of the current interval (e.g. a day, week, month). |
estimated |
INTEGER | The number of minutes that users watched videos for the youtube channel. |
youtubeAnalyticsPlaybackLocations
Summary
Holding private-level data for YouTube channels per playback location and their development over time. This data source is going to be deprecated and can be replaced with the columns where the name ends with "ByPlaybackLocation" in the data source "youtubeAnalytics".
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by YouTube.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
insight |
ENUM | Type of page or application where video playbacks occured. For example: EMBEDDED, MOBILE |
insight |
STRING | Readable representation if PlaybackLocationType. For example: "EMBEDDED" => "Embedded player on other websites" |
views | INTEGER | Total number of views counted on this date for the Youtube Channel at the end of the current interval (e.g. a day, week, month). |
estimated |
INTEGER | The number of minutes that users watched videos for the youtube channel. |
youtubeAnalyticsPlaylists (Deprecates April 30, 2022)
Summary
Holding private-level data for YouTube channels per playlist.
This data source deprecates on April 30, 2022. Learn more about recent changes and upcoming deprecations of data sources here.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- All numbers relate to the performance within the selected time period. E.g. the views only include those accumulated during the selected time period.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
publish |
DATETIME | Time the playlist was published. |
external |
STRING | Identifier of the playlist. |
link | LINK | Link to the playlist. |
status | STRING | Privacy status of the playlist. |
title | STRING | Title of the playlist. |
description | STRING | Description of the playlist. |
views | INTEGER | The number of times the playlist got viewed. |
estimated |
INTEGER | The number of minutes viewers watched the playlist during the selected timeframe. |
average |
INTEGER | The number of seconds on average that a viewer would watch the playlist during the selected timeframe. |
playlist |
INTEGER | The number of times that viewers initiated playback of the playlist during the selected timeframe. |
views |
DECIMAL | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe. |
average |
DECIMAL | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe. |
youtubeAnalyticsTopPlaylists
Summary
Holding private-level data for YouTube channels per playlist. This data source only contains performed playlists.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- All numbers relate to the performance within the selected time period. E.g. the views only include those accumulated during the selected time period.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
publish |
DATETIME | Time the playlist was published. |
external |
STRING | Identifier of the playlist. |
link | LINK | Link to the playlist. |
status | STRING | Privacy status of the playlist. |
title | STRING | Title of the playlist. |
description | STRING | Description of the playlist. |
added |
OBJECT | List of added videos in the playlist. |
added |
INTEGER | Number of added videos in the playlist. |
views | INTEGER | The number of times the playlist got viewed. |
red |
INTEGER | The number of times that a playlist was viewed by YouTube Red members. |
estimated |
INTEGER | The number of minutes viewers watched the playlist during the selected timeframe. |
estimated |
INTEGER | The number of minutes viewers watched the playlist during the selected timeframe. |
average |
INTEGER | The number of seconds on average that a viewer would watch the playlist during the selected timeframe. |
playlist |
INTEGER | The number of times that viewers initiated playback of the playlist during the selected timeframe. |
views |
DECIMAL | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe. |
average |
DECIMAL | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe. |
playlist |
OBJECT | The number of times that viewers initiated playback of the playlist during the selected timeframe, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's playlists, then subscribes to the channel and watches another playlist, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
views |
OBJECT | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's playlists, then subscribes to the channel and watches another playlist, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
average |
OBJECT | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe, segmented by subscribed status. The subscribed status indicates whether the viewer was subscribed to this channel or not. Note that the value is accurate as of the time that the user activity occurs. For example, suppose a user has not subscribed to a channel and watches one of that channel's playlists, then subscribes to the channel and watches another playlist, all on the same day. Then one view counts towards SUBSCRIBED, and one view counts towards UNSUBSCRIBED. E.g. [{"subscribedStatus":"UNSUBSCRIBED","subscribedStatusName":"Not subscribed","value":13},{"subscribedStatus":"SUBSCRIBED","subscribedStatusName":"Subscribed","value":21}]. |
playlist |
OBJECT | The number of times that viewers initiated playback of the playlist during the selected timeframe, segmented by traffic source. Traffic sources are based on the referrer type, which describes the manner in which users reached the playlist. E.g. [{"trafficSource":"NO_LINK_OTHER","trafficSourceName":"Direct or unknown","value":2}]. Possible traffic source types can be found here. |
views |
OBJECT | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe, segmented by traffic source. Traffic sources are based on the referrer type, which describes the manner in which users reached the playlist. E.g. [{"trafficSource":"NO_LINK_OTHER","trafficSourceName":"Direct or unknown","value":2}]. Possible traffic source types can be found here. |
average |
OBJECT | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe, segmented by traffic source. Traffic sources are based on the referrer type, which describes the manner in which users reached the playlist. E.g. [{"trafficSource":"NO_LINK_OTHER","trafficSourceName":"Direct or unknown","value":2}]. Possible traffic source types can be found here. |
playlist |
OBJECT | The number of times that viewers initiated playback of the playlist during the selected timeframe, segmented by playback location. The playback location provides insight about the page or application where user activity occurred. E.g. [{"playbackLocation":"WATCH","playbackLocationName":"YouTube watch page","value":32}]. Possible playback location types can be found here. |
views |
OBJECT | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe, segmented by playback location. The playback location provides insight about the page or application where user activity occurred. E.g. [{"playbackLocation":"WATCH","playbackLocationName":"YouTube watch page","value":32}]. Possible playback location types can be found here. |
average |
OBJECT | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe, segmented by playback location. The playback location provides insight about the page or application where user activity occurred. E.g. [{"playbackLocation":"WATCH","playbackLocationName":"YouTube watch page","value":32}]. Possible playback location types can be found here. |
playlist |
OBJECT | The number of times that viewers initiated playback of the playlist during the selected timeframe, segmented by operating system. Operating systems identify the software system of the device on which the view occurred. E.g. [{"operatingSystem":"MACINTOSH","operatingSystemName":"Macintosh","value":26}]. Possible operating system types can be found here. |
views |
OBJECT | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe, segmented by operating system. Operating systems identify the software system of the device on which the view occurred. E.g. [{"operatingSystem":"MACINTOSH","operatingSystemName":"Macintosh","value":26}]. Possible operating system types can be found here. |
average |
OBJECT | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe, segmented by operating system. Operating systems identify the software system of the device on which the view occurred. E.g. [{"operatingSystem":"MACINTOSH","operatingSystemName":"Macintosh","value":26}]. Possible operating system types can be found here. |
playlist |
OBJECT | The number of times that viewers initiated playback of the playlist during the selected timeframe, segmented by device type. Device types identify the physical form factor of the device on which the view occurred. E.g. [{"deviceType":"DESKTOP","deviceTypeName":"Computer","value":31}]. Possible device types can be found here. |
views |
OBJECT | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe, segmented by device type. Device types identify the physical form factor of the device on which the view occurred. E.g. [{"deviceType":"DESKTOP","deviceTypeName":"Computer","value":31}]. Possible device types can be found here. |
average |
OBJECT | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe, segmented by device type. Device types identify the physical form factor of the device on which the view occurred. E.g. [{"deviceType":"DESKTOP","deviceTypeName":"Computer","value":31}]. Possible device types can be found here. |
playlist |
OBJECT | The number of times that viewers initiated playback of the playlist during the selected timeframe, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
views |
OBJECT | The number of views on average per playlist start. The average number of video views that occurred each time a playlist was initiated during the selected timeframe, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
average |
OBJECT | The number of minutes on average that a viewer would spend in the playlist during the selected timeframe, segmented by youtube product. The youtube product indicates the YouTube service on which the user activity occurred . E.g. [{"youtubeProduct":"CORE","youtubeProductName":"YouTube","value":13},{"youtubeProduct":"KIDS","youtubeProductName":"YouTube Kids","value":21}]. |
youtubeAnalyticsTopVideos
Summary
Holding private-level data about the top videos of YouTube channels within the selected time period.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- All numbers relate to the performance within the selected time period. E.g. the views only include those accumulated during the selected time period.
- Video views can vary if you look at a video for the same past time period at different times. Learn more about how video views are counted here.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
publish |
DATETIME | The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases: If a video is uploaded as a private video and the video metadata is retrieved by the channel owner, then the property value specifies the date and time that the video was uploaded. If a video is uploaded as an unlisted video, the property value also specifies the date and time that the video was uploaded. In this case, anyone who knows the video's unique video ID can retrieve the video metadata. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The ID that YouTube uses to uniquely identify the video. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | Link to the video. |
thumbnail | LINK | Thumbnail to this video. |
is |
BOOLEAN | Yields "1" if the video was removed, and an empty string otherwise. |
status | STRING | Privacy status of this video. Valid values for this property are: 'private', 'public' and 'unlisted' |
title | STRING | Title of this video. The property value has a maximum length of 100 characters. |
description | STRING | Description of this video. The property value has a maximum length of 5000 bytes. |
public |
BOOLEAN | This value indicates whether the extended video statistics on the video's watch page are publicly viewable. |
made |
BOOLEAN | This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video. |
dimension | STRING | Indicates whether the video is available in 3D or in 2D. |
definition | STRING | Indicates whether the video is available in high definition (HD) or only in standard. Valid values for this property are: 'hd' and 'sd' |
caption | BOOLEAN | Indicates whether captions are available for the video. |
licensed |
BOOLEAN | Indicates whether the video represents licensed content, which means that the content was uploaded to a channel linked to a YouTube content partner and then claimed by that partner. |
live |
ENUM | Indicates if the video is an upcoming/active live broadcast. Or it's "none" if the video is not an upcoming/active live broadcast. Valid values for this property are: 'live', 'none' and 'upcoming' |
live |
DATETIME | The time that the broadcast actually started. This value will not be available until the broadcast begins. |
live |
DATETIME | he time that the broadcast actually ended. This value will not be available until the broadcast is over. |
live |
DATETIME | The time that the broadcast is scheduled to begin. |
live |
DATETIME | The time that the broadcast is scheduled to end. If the value is empty or the property is not present, then the broadcast is scheduled to continue indefinitely. |
restriction |
OBJECT | A list of region codes that identify countries where the video is viewable. If this property is present and a country is not listed in its value, then the video is blocked from appearing in that country. If this property is present and contains an empty list, the video is blocked in all countries. |
restriction |
OBJECT | A list of region codes that identify countries where the video is blocked. If this property is present and a country is not listed in its value, then the video is viewable in that country. If this property is present and contains an empty list, the video is viewable in all countries. |
topic |
OBJECT | A list of Wikipedia URLs that provide a high-level description of the video's content. |
tags | OBJECT | A list of keyword tags associated with the video. Tags may contain spaces. The property value has a maximum length of 500 characters. |
duration | INTEGER | The length of this video in seconds. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
views | INTEGER | The number of times that a video was viewed. |
red |
INTEGER | The number of times that a video was viewed by YouTube Red members. |
comments | INTEGER | Total number of top-level comments for this video. Please note that this count does not include replies to comments. |
likes | INTEGER | TThe number of times that users indicated that they liked a video by giving it a positive rating. |
dislikes | INTEGER | The number of times that users indicated that they disliked a video by giving it a negative rating. |
shares | INTEGER | The number of times that users shared a video through the 'Share' button. |
subscribers |
INTEGER | The number of times that users subscribed to a channel. |
subscribers |
INTEGER | The number of times that users unsubscribed from a channel. |
videos |
INTEGER | The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. |
videos |
INTEGER | The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. |
estimated |
INTEGER | The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. |
estimated |
INTEGER | The number of minutes that YouTube Red members watched a video. |
average |
INTEGER | The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. |
average |
PERCENT | The average percentage of a video watched during a video playback. As of December 13, 2021, this metric excludes looping clips traffic. |
annotation |
INTEGER | The total number of annotation impressions. |
annotation |
INTEGER | The number of annotations that appeared and could be clicked. |
annotation |
INTEGER | The number of clicked annotation. |
annotation |
PERCENT | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. |
annotation |
INTEGER | The number of annotations that appeared and could be closed. |
annotation |
INTEGER | The number of closed annotations. |
annotation |
PERCENT | The ratio of annotations that viewers closed to the total number of annotation impressions. |
card |
INTEGER | The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards. |
card |
INTEGER | The number of times that cards were clicked. |
card |
PERCENT | The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions. |
card |
INTEGER | The number of times that card teasers were displayed. A video view can generate multiple teaser impressions. |
card |
INTEGER | The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user. |
card |
PERCENT | The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
youtubeAnalyticsTotal
Summary
Holding private-level data for YouTube channels since the creation of these channels until the end of the selected time period (lifetime performance).
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- All numbers are aggregates across the whole YouTube channel.
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- All numbers relate to the lifetime performance of the selected YouTube channels until the end of the selected time period.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
views | INTEGER | Total number of views for the youtube channel at the end of the current interval (e.g. a day, week, month). |
likes | INTEGER | Total number of likes for the youtube channel at the end of the current interval (e.g. a day, week, month). |
dislikes | INTEGER | Total number of dislikes for the youtube channel at the end of the current interval (e.g. a day, week, month). |
subscribers |
INTEGER | The number of people who unsubscribed from the channel during the selected timeframe. |
subscribers |
INTEGER | The number of people who subscribed to the channel during the selected timeframe. |
shares | INTEGER | Total number of shares for the youtube channel at the end of the current interval (e.g. a day, week, month). |
estimated |
INTEGER | The number of minutes that users watched videos for the youtube channel |
comments | INTEGER | Total number of top-level comments posted on the YouTube channel at the end of the current interval (e.g. a day, week, month). Please note that this count does not include replies to comments. |
average |
INTEGER | The average length, in seconds, of video playbacks for the youtube channel. As of December 13, 2021, this metric excludes looping clips traffic. |
annotation |
PERCENT | The ratio of annotations that viewers closed to the total number of annotation impressions. |
annotation |
PERCENT | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. |
average |
PERCENT | The average percentage of a video watched during a video playback. |
youtubeAnalyticsTrafficSources
Summary
Holding private-level data for YouTube channels per traffic source and their development over time. This data source is going to be deprecated and can be replaced with the columns where the name ends with "ByTrafficSource" in the data source "youtubeAnalytics".
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- Daily, weekly and monthly intervals are aggregated in PST timezone as provided by YouTube.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day, week, month). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day, week, month) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day, week, month) in user timezone. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
insight |
ENUM | Type of the traffic source. One of: ADVERTISING, ANNOTATION, EXT_URL, NO_LINK_EMBEDDED, NO_LINK_OTHER, PLAYLIST, PROMOTED, RELATED_VIDEO, SUBSCRIBER, YT_CHANNEL, YT_OTHER_PAGE, YT_SEARCH, GOOGLE_SEARCH, EXT_APP, END_SCREEN |
insight |
STRING | More readable representation of the traffic type. For example: "RELATED_VIDEO" => "YouTube suggested video" |
views | INTEGER | Total number of views from this traffic source. |
estimated |
INTEGER | The number of minutes that users watched videos from this traffic source. |
youtubeAnalyticsVideos
Summary
Holding private-level data about videos of YouTube channels created within the selected time period.
Hints
- All numbers reflect the most recent lifetime performance of a video (independent of the selected time period).
- Deleted YouTube videos are not included.
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- Annotation metrics might be not available from January 15, 2019 as Youtube started to remove the annotation feature at that date.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
publish |
DATETIME | The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases: If a video is uploaded as a private video and the video metadata is retrieved by the channel owner, then the property value specifies the date and time that the video was uploaded. If a video is uploaded as an unlisted video, the property value also specifies the date and time that the video was uploaded. In this case, anyone who knows the video's unique video ID can retrieve the video metadata. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The ID that YouTube uses to uniquely identify the video. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | Link to this video. |
thumbnail | LINK | Thumbnail to this video. |
is |
BOOLEAN | Yields "1" if the video was removed, and an empty string otherwise. |
status | STRING | Privacy status of this video. Valid values for this property are: 'private', 'public' and 'unlisted' |
title | STRING | Title of this video. The property value has a maximum length of 100 characters. |
description | STRING | Description of this video. The property value has a maximum length of 5000 bytes. |
public |
BOOLEAN | This value indicates whether the extended video statistics on the video's watch page are publicly viewable. |
made |
BOOLEAN | This value indicates whether the video is designated as child-directed, and it contains the current "made for kids" status of the video. |
dimension | STRING | Indicates whether the video is available in 3D or in 2D. |
definition | STRING | Indicates whether the video is available in high definition (HD) or only in standard. Valid values for this property are: 'hd' and 'sd' |
caption | BOOLEAN | Indicates whether captions are available for the video. |
licensed |
BOOLEAN | Indicates whether the video represents licensed content, which means that the content was uploaded to a channel linked to a YouTube content partner and then claimed by that partner. |
live |
ENUM | Indicates if the video is an upcoming/active live broadcast. Or it's "none" if the video is not an upcoming/active live broadcast. Valid values for this property are: 'live', 'none' and 'upcoming' |
live |
DATETIME | The time that the broadcast actually started. This value will not be available until the broadcast begins. |
live |
DATETIME | The time that the broadcast actually ended. This value will not be available until the broadcast is over. |
live |
DATETIME | The time that the broadcast is scheduled to begin. |
live |
DATETIME | The time that the broadcast is scheduled to end. If the value is empty or the property is not present, then the broadcast is scheduled to continue indefinitely. |
restriction |
OBJECT | A list of region codes that identify countries where the video is viewable. If this property is present and a country is not listed in its value, then the video is blocked from appearing in that country. If this property is present and contains an empty list, the video is blocked in all countries. |
restriction |
OBJECT | A list of region codes that identify countries where the video is blocked. If this property is present and a country is not listed in its value, then the video is viewable in that country. If this property is present and contains an empty list, the video is viewable in all countries. |
topic |
OBJECT | A list of Wikipedia URLs that provide a high-level description of the video's content. |
tags | OBJECT | A list of keyword tags associated with the video. Tags may contain spaces. The property value has a maximum length of 500 characters. These tags are provided by YouTube itself. |
duration | INTEGER | The length of this video in seconds. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
live |
INTEGER | The number of unique viewers that was watching the broadcast. The property and its value will be present if the broadcast owner has not hidden the view count for the video. |
views | INTEGER | The number of times that a video was viewed. |
red |
INTEGER | The number of times that a video was viewed by YouTube Red members. |
comments | INTEGER | Total number of top-level comments for this video. Please note that this count does not include replies to comments. |
likes | INTEGER | TThe number of times that users indicated that they liked a video by giving it a positive rating. |
dislikes | INTEGER | The number of times that users indicated that they disliked a video by giving it a negative rating. |
shares | INTEGER | The number of times that users shared a video through the 'Share' button. |
subscribers |
INTEGER | The number of times that users subscribed to a channel. |
subscribers |
INTEGER | The number of times that users unsubscribed from a channel. |
videos |
INTEGER | The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. |
videos |
INTEGER | The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. |
estimated |
INTEGER | The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. |
estimated |
INTEGER | The number of minutes that YouTube Red members watched a video. |
average |
INTEGER | The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. |
average |
PERCENT | The average percentage of a video watched during a video playback. |
annotation |
INTEGER | The total number of annotation impressions. |
annotation |
INTEGER | The number of annotations that appeared and could be clicked. |
annotation |
INTEGER | The number of clicked annotation. |
annotation |
PERCENT | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. |
annotation |
INTEGER | The number of annotations that appeared and could be closed. |
annotation |
INTEGER | The number of closed annotations. |
annotation |
PERCENT | The ratio of annotations that viewers closed to the total number of annotation impressions. |
card |
INTEGER | The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards. |
card |
INTEGER | The number of times that cards were clicked. |
card |
PERCENT | The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions. |
card |
INTEGER | The number of times that card teasers were displayed. A video view can generate multiple teaser impressions. |
card |
INTEGER | The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user. |
card |
PERCENT | The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
youtubeVideos
Summary
Holding public data about videos of YouTube Channels created within the selected time period.
Hints
- All numbers reflect the most recent lifetime performance of a video (independent of the selected time period).
- Subscriber counts are shown in abbreviated form. Learn more here.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
publish |
DATETIME | The time this posting was published. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
title | STRING | Title of this video. |
description | STRING | Description of this video. The property value has a maximum length of 5000 bytes. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
link | LINK | Link to this video. |
thumbnail | LINK | Thumbnail to this video. |
external |
STRING | Id of this video in youtube's database. |
internal |
STRING | The quintly internal ID of this post. |
video |
STRING | The same as externalId. Node exists for backwards compatibility to an older version of the API. |
views | INTEGER | Total amount of times a user watched this video. |
likes | INTEGER | Total amount of times a user liked this video. |
dislikes | INTEGER | Total amount of times a user disliked this video. From the 10th December 2021 we stop tracking this metric due to the update from YouTube to make the dislikes private. You can find more details here. |
comments | INTEGER | Total amount of comments on this video including replies. |
duration | INTEGER | Duration of this video in seconds. |
subscribers | INTEGER | Total amount of subscribers at the moment this video was published. |
youtubeAnalyticsVideosTimeSeries
Summary
Holding private-level data about videos of YouTube channels and their development over time.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- Deleted YouTube videos are not included.
- YouTube updates analytics data once a day and it has a delay of up to 72 hours.
- All numbers relate to the performance within the selected time period. E.g. the views only include those accumulated during the selected time period.
- Video views can vary if you look at a video for the same past time period at different times. Learn more about how video views are counted here.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
time | DATETIME | Holding the full date and time information describing the current interval (e.g. a day). |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval (e.g. a day) in user timezone. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval (e.g. a day) in user timezone. |
publish |
DATETIME | The date and time that the video was published. Note that this time might be different than the time that the video was uploaded. For example, if a video is uploaded as a private video and then made public at a later time, this property will specify the time that the video was made public. There are a couple of special cases: If a video is uploaded as a private video and the video metadata is retrieved by the channel owner, then the property value specifies the date and time that the video was uploaded. If a video is uploaded as an unlisted video, the property value also specifies the date and time that the video was uploaded. In this case, anyone who knows the video's unique video ID can retrieve the video metadata. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
external |
STRING | The ID that YouTube uses to uniquely identify the video. |
internal |
STRING | The quintly internal ID of this post. |
link | LINK | Link to this video. |
title | STRING | Title of this video. The property value has a maximum length of 100 characters. |
views | INTEGER | The number of times that a video was viewed. |
red |
INTEGER | The number of times that a video was viewed by YouTube Red members. |
comments | INTEGER | Total number of top-level comments for this video. Please note that this count does not include replies to comments. |
likes | INTEGER | TThe number of times that users indicated that they liked a video by giving it a positive rating. |
dislikes | INTEGER | The number of times that users indicated that they disliked a video by giving it a negative rating. |
shares | INTEGER | The number of times that users shared a video through the 'Share' button. |
subscribers |
INTEGER | The number of times that users subscribed to a channel. |
subscribers |
INTEGER | The number of times that users unsubscribed from a channel. |
videos |
INTEGER | The number of times that videos were added to any YouTube playlists. The videos could have been added to the video owner's playlist or to other channels playlists. The metric value does include the number of times that videos were added to default playlists like the "Watch Later" playlist. However, it does not count playlists that a video is automatically added to, such as a channel's uploads playlist or a user's watch history. |
videos |
INTEGER | The number of times that videos were removed from any YouTube playlists. The videos could have been removed from the video owner's playlist or from other channels playlists. The metric value includes the number of times that videos were removed from default playlists like the "Watch Later" playlist. |
estimated |
INTEGER | The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. |
estimated |
INTEGER | The number of minutes that YouTube Red members watched a video. |
average |
INTEGER | The average length, in seconds, of video playbacks. As of December 13, 2021, this metric excludes looping clips traffic. |
average |
PERCENT | The average percentage of a video watched during a video playback. |
annotation |
INTEGER | The total number of annotation impressions. |
annotation |
INTEGER | The number of annotations that appeared and could be clicked. |
annotation |
INTEGER | The number of clicked annotation. |
annotation |
PERCENT | The ratio of annotations that viewers clicked to the total number of clickable annotation impressions. |
annotation |
INTEGER | The number of annotations that appeared and could be closed. |
annotation |
INTEGER | The number of closed annotations. |
annotation |
PERCENT | The ratio of annotations that viewers closed to the total number of annotation impressions. |
card |
PERCENT | The number of times cards were displayed. When the card panel is opened, a card impression is logged for each of the video's cards. |
card |
PERCENT | The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions. |
card |
PERCENT | The click-through-rate for cards, which is calculated as the ratio of card clicks to card impressions. |
card |
INTEGER | The number of times that card teasers were displayed. A video view can generate multiple teaser impressions. |
card |
INTEGER | The number of clicks on card teasers. Card icon clicks are attributed to the last teaser displayed to the user. |
card |
PERCENT | The click-through-rate for card teasers, which is calculated as the ratio of clicks on card teasers to the total number of card teaser impressions. |
snapchatShowInsights
Summary
Holding information about Snapchat shows and their development over time. All numbers are aggregates across the whole show.
Time-series data
This data source returns time-series data representing the development of a set of metrics over time. More specific, time-series data sources return one row per profile per time interval. Each of our data sources supports one or more of the following intervals: daily, weekly, monthly or total. E.g. a request with time period Jan 1st to Jan 10th, daily interval and two profiles selected will return 20 rows. The total interval by definition returns one row per profile holding the numbers for the single "total" interval.
Please note that for weekly and monthly intervals the start and end time of the selected time period will be expanded to cover full intervals. E.g. for monthly interval a time period from 3rd of March to 10th of April will be expanded to March 1st to April 30th to cover full months.
Hints
- This data source only supports daily as an interval.
- Daily intervals are aggregated in PST timezone as provided by Snapchat.
- Snapchat data is usually available with a delay of 2 days.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
interval |
DATETIME | Holding the full date and time information describing the beginning of the current interval. For Snapchat shows there is only the daily interval available. |
interval |
DATETIME | Holding the full date and time information describing the end of the current interval. For Snapchat shows there is only the daily interval available. |
import |
DATETIME | The last time quintly fetched a fresh snapshot for this profile and interval using the APIs of the social networks and there was a modification compared to its former state. |
daily |
INTEGER | The number of unique users who saw this show within the current interval (e.g. a day, week, month). |
monthly |
INTEGER | The number of unique users who saw this show in the context of the month before the current interval. |
subscriber |
INTEGER | The number of the show's subscribers that engaged with the show within the current interval (e.g. a day, week, month). |
new |
INTEGER | The number of the show's subscribers gained within the current interval (e.g. a day, week, month). |
subscribers | INTEGER | The total number of the show's subscribers at the end of the current interval (e.g. a day, week, month). |
loyal |
INTEGER | The number of users that browsed the shows's content 5 to 7 days in the context of the previous 7 days from the current interval. |
frequent |
INTEGER | The number of users that browsed the shows's content 3 to 4 days in the context of the previous 7 days from the current interval. |
returning |
INTEGER | The number of users that browsed the shows's content twice in the context of the previous 7 days from the current interval. |
new |
INTEGER | The number of users that browsed the shows's content once in the context of the previous 7 days from the current interval. |
gender |
INTEGER | The number of male users who saw this show within the current interval (e.g. a day, week, month). |
gender |
INTEGER | The number of female users who saw this show within the current interval (e.g. a day, week, month). |
gender |
INTEGER | The number of users with unknown gender who saw this show within the current interval (e.g. a day, week, month). |
age |
INTEGER | The number of users in the age group 13 to 17 years who saw this show within the current interval (e.g. a day, week, month). |
age |
INTEGER | The number of users in the age group 18 to 24 years who saw this show within the current interval (e.g. a day, week, month). |
age |
INTEGER | The number of users in the age group 25 to 34 years who saw this show within the current interval (e.g. a day, week, month). |
age |
INTEGER | The number of users in the age group 35 and older years who saw this show within the current interval (e.g. a day, week, month). |
age |
INTEGER | The number of users with unknown age who saw this show within the current interval (e.g. a day, week, month). |
total |
INTEGER | The total time users spent on this show's content in seconds. |
average |
DECIMAL | The average time users spent on this show's content in seconds per user. |
unique |
DECIMAL | The average number of topsnaps viewed in this show's stories. |
unique |
INTEGER | The total number of unique topsnap views by users that engaged with this show's content. |
topsnap |
INTEGER | The total number of topsnap views by users that engaged with this show's content. |
attachment |
PERCENT | The percentage of unique users that swiped up on this show's snaps with attachments. |
attachment |
PERCENT | The total number of attachment article views by users that engaged with this show's content. |
attachment |
PERCENT | The total number of attachment video views by users that engaged with this show's content. |
screenshots | INTEGER | The total number of screenshots made of this show's content within the current interval (e.g. a day, week, month). |
shares | INTEGER | The total number of shares of this show's content within the current interval (e.g. a day, week, month). |
snapchatShowInsightsStories
Summary
Holding information about stories of Snapchat Shows.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
id | STRING | The ID of this story. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
create |
DATETIME | The time this story was created. |
start |
DATETIME | The time this story was published. |
first |
DATETIME | The time this story went live for the first time. This is usually only seconds after it was published. |
title | STRING | The title of this story. |
first |
LINK | The URL to the story's first tile media picture. Holds "null" if no picture is available. |
post |
OBJECT | The tags that were assigned to this post via the post tagging feature. Provided as a list of objects, e.g. [{"id": 1, "name": "My first tag"}, ...]. |
internal |
STRING | The quintly internal ID of this post. |
state | ENUM | The state of this story. One of: Available |
spotlight |
DATETIME | The time this story stopped being the show's most recent story. |
spotlight |
DECIMAL | The total time in seconds this story was the shows's most recent story. |
tags | OBJECT | The tags of this story. Provided as a list of strings, e.g. ["tag1", "tag2"]. |
snaps | INTEGER | The number of snaps within this story. |
episode |
INTEGER | The number of the episode this story belongs to. |
season |
STRING | The ID of the season this story belongs to. |
season |
INTEGER | The number of the season this story belongs to. |
season |
STRING | The display name of the season this story belongs to. |
gender |
INTEGER | The number of male users who saw this story. |
gender |
INTEGER | The number of female users who saw this story. |
gender |
INTEGER | The number of users with unknown gender who saw this story. |
age |
INTEGER | The number of users in the age group 13 to 17 years who saw this story. |
age |
INTEGER | The number of users in the age group 18 to 24 years who saw this story. |
age |
INTEGER | The number of users in the age group 25 to 34 years who saw this story. |
age |
INTEGER | The number of users in the age group 35 and older years who saw this story. |
age |
INTEGER | The number of users with unknown age who saw this story. |
view |
DECIMAL | The total time this story was viewed in seconds. |
average |
DECIMAL | The average time per user this story was viewed in seconds. |
total |
INTEGER | The total number of views for this story. |
unique |
INTEGER | The total number of unique viewers for this story. |
unique |
INTEGER | The total number of users who completely watched this story. |
completion |
PERCENT | The percentage of users who completely watched this story. |
shares | INTEGER | The total number of shares for this story. |
unique |
INTEGER | The total number of users sharing this story. |
viewers |
INTEGER | The total number of users viewing this story from a share. |
screenshots | INTEGER | The total number of screenshots made of this story. |
subscribers | INTEGER | The total number of new subscribers to your show added when this story was live. |
topsnap |
DECIMAL | The total time topsnaps of this story were viewed in seconds. |
topsnap |
DECIMAL | The average time per user topsnaps of this story were viewed in seconds. |
topsnap |
INTEGER | The total number of views for topsnaps of this story. |
topsnap |
INTEGER | The total number of unique views for topsnaps of this story. |
unique |
DECIMAL | The average number of topsnaps viewed per user in this story. |
snapchatShowInsightsSnaps
Summary
Holding information about snaps within stories of Snapchat Shows.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
profile |
INTEGER | Identifier for the profile this row belongs to. It's a quintly internal ID and meta data can be fetched by joining the "profiles" table which is ready to be used with all QQL queries. |
id | STRING | The ID of this snap. |
import |
DATETIME | The last time quintly fetched a fresh snapshot of this posting using the APIs of the social networks and there was a modification compared to its former state. |
story |
STRING | The ID of the story this snap belongs to. |
story |
DATETIME | The time the story this snap belongs to was published. |
name | STRING | The name of this snap. |
internal |
STRING | The quintly internal ID of this post. |
position | INTEGER | The position of this snap within the story. The first snap has position 1. |
duration | INTEGER | The duration of this snap in seconds. |
tags | OBJECT | The tags of this snap. Provided as a list of strings, e.g. ["tag1", "tag2"]. |
subscribe |
STRING | The headline of the call to action to subscribe to the show present on this snap. |
tiles | INTEGER | The number of tiles related to this snap. |
tiles |
OBJECT | The headlines of the tiles related to this snap. Provided as a list of strings, e.g. ["headline1", "headline2"]. |
gender |
INTEGER | The number of male users who saw this snap. |
gender |
INTEGER | The number of female users who saw this snap. |
gender |
INTEGER | The number of users with unknown gender who saw this snap. |
age |
INTEGER | The number of users in the age group 13 to 17 years who saw this snap. |
age |
INTEGER | The number of users in the age group 18 to 24 years who saw this snap. |
age |
INTEGER | The number of users in the age group 25 to 34 years who saw this snap. |
age |
INTEGER | The number of users in the age group 35 and older years who saw this snap. |
age |
INTEGER | The number of users with unknown age who saw this snap. |
view |
DECIMAL | The total time this snap was viewed in seconds. |
average |
DECIMAL | The average time per user this snap was viewed in seconds. |
total |
INTEGER | The total number of views for this snap. |
unique |
INTEGER | The total number of unique viewers for this snap. |
unique |
INTEGER | The total number of users who completely watched this snap. |
completion |
PERCENT | The percentage of users who completely watched this snap. |
shares | INTEGER | The total number of shares for this snap. |
unique |
INTEGER | The total number of users sharing this snap. |
viewers |
INTEGER | The total number of users viewing this snap. |
screenshots | INTEGER | The total number of screenshots made of this snap. |
drop |
PERCENT | The percentage of users that dropped off from this snap to the next. |
topsnap |
DECIMAL | The total time topsnaps related to this snap were viewed in seconds. |
topsnap |
DECIMAL | The average time per user topsnaps related to this snap were viewed in seconds. |
topsnap |
INTEGER | The total number of views for topsnaps related to this snap. |
topsnap |
INTEGER | The total number of unique views for topsnaps related to this snap. |
profiles
Summary
Holding information about the selected profiles.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
id | INTEGER | Identifier for the selected profile. It's a quintly internal ID and can be joined with the "profileId" column in all other data sources. |
name | STRING | The default name of this profile, showing the name as close as possible to how the profile is rendered on the social network itself. For Instagram it shows the username, for Twitter and TikTok the @handle, and for all other social networks it shows the profile name. |
name |
STRING | The default name of this profile as described above, plus the appendix set within the profile's settings, if specified. |
appendix | STRING | The appendix of this profile in your account. |
platform |
ENUM | The social network this profile belongs to. One of: facebook, instagram, twitter, youtube, linkedIn, snapchatShow, tiktok |
platform |
STRING | The social network specific identifier of this profile (e.g. the Facebook Page ID). |
platform |
STRING | The username of this profile on the social network. This does not include the @ prefix. |
profile |
STRING | The description of this profile. |
profile |
LINK | The link to this profile on the social network. |
profile |
LINK | The link to the picture of this profile. |
is |
BOOLEAN | Shows if the profile is verified by the social network. Holds "1" if true, "" if not. |
has |
BOOLEAN | Returns true if this profile is a Facebook Page and has already transitioned to the New Pages Experience. |
groups | OBJECT | The groups this profile belongs to. Provided as a list of objects, e.g. [{"id": "1", "name": "Autombile"}, ...]. |
postTags
Summary
Holding information about all available post tags in this space.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
id | INTEGER | Identifier for the post tag. It's a quintly internal ID and can be joined with the "id" attribute of the objects returned by "postTags" columns in data sources supporting post tagging. |
name | STRING | The name of this tag. |
is |
BOOLEAN | If the tag is archived or not. |
create |
DATETIME | The date and time this tag was created. |
last |
DATETIME | The date and time this tag was last updated. |
create |
STRING | The name of the creator of this tag. |
last |
STRING | The name of the user last updating this tag. |
adAccounts
Summary
Holding information about the selected ad accounts.
Schema
Column name | Type | Description |
---|---|---|
unique |
STRING | Unique identifier for this row that can be used as a primary key. |
id | INTEGER | Identifier for the selected ad account. It's a quintly internal ID and can be joined with the "adAccountId" column in all other data sources. |
name | STRING | The default name of this ad account, showing the name as close as possible to how the ad account is rendered on the social network itself. For Instagram it shows the username, for Twitter and TikTok the @handle, and for all other social networks it shows the ad account name. |
name |
STRING | The default name of this ad account as described above, plus the appendix set within the ad account's settings, if specified. |
appendix | STRING | The appendix of this ad account in your account. |
platform |
ENUM | The social network this ad account belongs to. One of: facebook, instagram, twitter, youtube, linkedIn, snapchatShow, tiktok |
platform |
STRING | The social network specific identifier of this ad account (e.g. the Facebook Page ID). |
link | LINK | The link to this ad account in the Meta Ads Manager. |
currency | STRING | The currency set in this ad account. |
groups | OBJECT | The groups this ad account belongs to. Provided as a list of objects, e.g. [{"id": "1", "name": "Autombile"}, ...]. |