Skip to main content

Metrics

Metrics for Profile Content

Profile Stats

The profile stats endpoint is a single endpoint to retrieve stats for all assets related to a profile. This includes the Profile, Lenses, Stories and Saved Stories. The API can also retrieve stats for different granularities and supports multiple different breakdowns. This endpoint retrieves all available stats for a profile.

HTTP Request

GET https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/stats

Parameters

Field nameRequiredDescriptionPossible Values
profile_idRThis is provided in the URL. This is a required field.
assetTypeODefault value is PROFILE. Providing an asset type other than PROFILE returns stats of all assets of the specified type under the profile.PROFILE, STORY, SAVED_STORY, LENS, SPOTLIGHT
fieldsOA comma separated list of the fields for which stats are required. If this parameter is not specified in the request then stats of all fields supported by the asset type are provided in the response. Request Validation : If a requested field is not available for the requested asset type, then a validation exception will be thrown.All possible values can be found in the metrics table below
granularityOGranularity of the stats. Default Value is LIFETIME.DAY, TOTAL, LIFETIME.
startTimeOStart time of the stats. Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00 Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00 Start time must be within the past 90 days. end_time - start_time should be greater than 0
endTimeOEnd time of the stats Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00 Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00 End time must be within the past 90 days. end_time - start_time should be greater than 0
breakdownDimensionsOA comma separated list of breakdown dimensions Breaks down the stats over the provided dimensions. Request Validation : PRODUCT breakdown is only available when Asset Type is Lens. PLACEMENT breakdown is only available for the SUBSCRIBERS metric field.AGE, GENDER, COUNTRY, REGION, OS, SUBSCRIPTION, AGE_GENDER,COUNTRY_GENDER, COUNTRY_AGE, COUNTRY_SUBSCRIPTION
limitONumber of assets per page. This is useful when asset type is not PROFILE.10 - 1000
cursorOThis can be provided to fetch the next page of stats. Its value would be the next_page_id received in the previous response.

HTTP Response

NameDescriptionPossible Values
request_idA UUID to identify this request.
request_statusSUCCESS / PARTIAL
granularityThe requested level of granularity.LIFETIME, TOTAL, DAY
assetsList of all assets Each entry represents stats for an assetRefer to assets table below
pageInformation about the next page of response. If there is a next page available then this will contain the next_page_id and the next_page_link.

Assets

NameDescriptionPossible Values
sub_request_statusSUCCESS / ERROR
error_messageIf there was an error then the error message will be present
asset_typeThe type of the asset for which stats are being provided.PROFILE, STORY, SAVED_STORY, LENS
asset_idId of the asset
timeseriesAn array of stats. Each entry represents an asset’s Daily, Total or Lifetime stats. If the requested granularity is DAY, then this array can contain more than one entry.Refer to timeseries table below

TimeSeries

NameDescriptionPossible Values
start_timeStart time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
end_timeEnd time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
fieldsArray of all stats fields that were requested.Refer to fields table below

Fields

NameDescriptionPossible Values
fieldContains the field name and the breakdown dimension.Refer to field table below
statsList of stats for this field. If no breakdown was requested then this list will contain only one entry.Refer to stats table below

Field

NameDescriptionPossible Values
field_nameThe field’s name
report_dimensionThe requested breakdown dimension. If no breakdown was requested then this field’s value would be DEFAULT.

Stats

NameDescriptionPossible Values
dimension_breakdownA string representing the value of the breakdown. For example if the dimension breakdown for AGE was requested then this string could be “AGE_13_17” or “AGE_35_UP” e.t.c If no dimension breakdown was requested then this field will not be available in the response.
valueThe stats value.
percentage_valueIf dimension breakdown was requested then this value represents the percent of the total field value this breakdown makes.

Example

curl "https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/stats"
-H "Authorization: <ACCESS_TOKEN>

Response

{
"request_id": "ecfe244d-0b1b-4787-9919-4ee7dd275a0a",
"request_status": "SUCCESS",
"granularity": "DAY",
"assets": [
{
"sub_request_status": "SUCCESS",
"asset_type": "PROFILE",
"asset_id": "6cbe6ba5-9ee8-43f3-9a2d-dbe3e6aa8f21",
"timeseries": [
{
"start_time": "2021-11-10T00:00:00Z",
"end_time": "2021-11-11T00:00:00Z",
"fields": [
{
"field":
{
"field_name": "STORY_VIEWS",
"report_dimension": "AGE"
},
"stats": [
{
"dimension_breakdown": "AGE_UNKNOWN",
"value": "0"
},
{
"dimension_breakdown": "AGE_13_17",
"value": "20"
}, ….]
},
{
"field":
{
"field_name": "VIEWS",
"report_dimension": "AGE"
},
"stats": [….]
}]
},
{
"start_time": "2021-11-11T00:00:00Z",
"end_time": "2021-11-12T00:00:00Z",
"fields": [….]
}, ….]
}],
"paging":
{
"next_page_id": "... ",
"next_page_link": "..."
}
}

API Usage This API can be used to

Retrieving specific Metrics If you would like to retrive just a few specific metrics, then you can provide the fields parameter with a comma separated list of all metrics that are needed.
Eg: https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/stats?fields=VIEWS,STORY_VIEWS,LENS_UNIQUES

Please refer to the Metrics section for all the fields, their descriptions and supported asset types for each metric.

Breakdown Dimensions Stats can be broken down into dimensions using the breakdownDimensions parameter. The breakdownDimensions parameter accepts a comma separated list of dimensions. Example : https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/stats?breakdownDimensions=AGE,AGE_GENDER,COUNTRY

If you want the audience breakdown by country you can provide "breakdown_dimensions=country" in the request. Http Request curl -v https://businessapi.snapchat.com/v1/public_profiles/{profile_id}/stats?fields="STORY_VIEWS&breakdown_dimensions=country

Pagination The API supports paginating over assets, if the assetType parameter is specified in the request, and a limit is also specified, then the response may be split into multiple pages. Each response will contain the next page’s id.

Example: If we have a profile with 4 lenses in it. We can get stats for those lenses in 2 pages by making the following request :

https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/stats?assetType=LENS&limit=2 The response from the above request will contain the stats for the first 2 lenses and a next_page_id (“next_page_id”:“c9dd5567-975a-4e1e-9415-559b821d7ba9”).

The next page of lens stats can be requested by specifying the cursor parameter in the request : https://businessapi.snapchat.com/v1/public_profiles/{profile_Id}/stats?assetType=LENS&limit=2&cursor=c9dd5567-975a-4e1e-9415-559b821d7ba9

Saved Story Stats

This endpoint retrieves all available stats for a saved story.

HTTP Request

GET https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/saved_stories/{id}/stats

Parameters

Field nameRequiredDescriptionPossible Values
profile_idRThis is provided in the URL. This is a required field.
idRThe story id. This is provided in the URL.
assetTypeODefault value is SAVED_STORY. Providing SNAP as the assetType returns stats of the snaps in the story.SAVED_STORY, SNAP
fieldsOA comma separated list of the fields for which stats are required. If this parameter is not specified in the request then stats of all fields supported by the asset type are provided in the response. Request Validation : If a requested field is not available for the requested asset type, then a validation exception will be thrown.All possible values can be found in the metrics section.
granularityODefault Value is LIFETIME. Granularity of the stats.DAY, TOTAL, LIFETIME.
startTimeOStart time of the stats. Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00Z Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00Z Start time must be within the past 90 days. end_time - start_time should be greater than 0
endTimeOEnd time of the stats Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00Z Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00Z End time must be within the past 90 days. end_time - start_time should be greater than 0
breakdownDimensionsOA comma separated list of breakdown dimensions Breaks down the stats over the provided dimensions. Request Validation : PRODUCT breakdown is only available when Asset Type is Lens. PLACEMENT breakdown is only available for the SUBSCRIBERS metric field.AGE_GENDER COUNTRY INTEREST_CATEGORY_ID OS PLACEMENT PLATFORM PRODUCT PRODUCT_CATEGORY REGION SDK_VERSION SPONSOR_TYPE
limitONumber of assets per page. This is useful when asset type is not PROFILE.10 - 1000
cursorOThis can be provided to fetch the next page of stats. Its value would be the next_page_id received in the previous response.

HTTP Response

NameDescriptionPossible Values
request_idA UUID to identify this request.
request_statusSUCCESS / PARTIAL
granularityThe requested level of granularity.LIFETIME, TOTAL, DAY
assetsList of all assets Each entry represents stats for an asset
error_codeIf an error occurs then an error code will be present in this field.
debug_messageAn error message in case an error occurs.
pagingInformation about the next page of response. If there is a next page available then this object will contain the next_page_id and the next_page_link fields.

Assets

NameDescriptionPossible Values
sub_request_statusSUCCESS / ERROR
error_codeIf an error occurs then an error code will be present in this field.
debug_messageIf there was an error then the debug message will be present
asset_typeThe type of the asset for which stats are being provided.SAVED_STORY, SNAP
asset_idId of the asset
timeseriesAn array of stats. Each entry represents an asset’s Daily, Total or Lifetime stats. If the requested granularity is DAY, then this array can contain more than one entry.

TimeSeries

NameDescriptionPossible Values
start_timeStart time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
end_timeEnd time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
fieldsArray of all stats fields that were requested.Refer to fields table below

Fields

NameDescriptionPossible Values
fieldContains the field name and the breakdown dimension.Refer to field table below
statsList of stats for this field. If no breakdown was requested then this list will contain only one entry.Refer to stats table below

Field

NameDescriptionPossible Values
field_nameThe field’s name
report_dimensionThe requested breakdown dimension. If no breakdown was requested then this field’s value would be DEFAULT.

Stats

NameDescriptionPossible Values
dimension_breakdownA string representing the value of the breakdown. For example if the dimension breakdown for AGE was requested then this string could be “AGE_13_17” or “AGE_35_UP” e.t.c If no dimension breakdown was requested then this field will not be available in the response.
valueThe stats value.
percentage_valueIf dimension breakdown was requested then this value represents the percent of the total field value this breakdown makes.

Example

curl "https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/saved_stories/{id}/stats"
-H "Authorization: <ACCESS_TOKEN>"

Response

{
"request_id": "ecfe244d-0b1b-4787-9919-4ee7dd275a0a",
"request_status": "SUCCESS",
"granularity": "DAY",
"assets": [
{
"sub_request_status": "SUCCESS",
"asset_type": "SAVED_STORY",
"asset_id": "6cbe6ba5-9ee8-43f3-9a2d-dbe3e6aa8f21",
"timeseries": [
{
"start_time": "2021-11-10T00:00:00Z",
"end_time": "2021-11-11T00:00:00Z",
"fields": [
{
"field":
{
"field_name": "SAVED_STORY_VIEWS",
"report_dimension": "AGE"
},
"stats": [
{
"dimension_breakdown": "AGE_UNKNOWN",
"value": "0"
},
{
"dimension_breakdown": "AGE_13_17",
"value": "20"
}, ….]
},
{
"field":
{
"field_name": "SAVED_STORY_SUBSCRIBES",
"report_dimension": "AGE"
},
"stats": [….]
}]
},
{
"start_time": "2021-11-11T00:00:00Z",
"end_time": "2021-11-12T00:00:00Z",
"fields": [….]
}, ….]
}],
"paging":
{
"next_page_id”: “...”,
“next_page_link”: “...”
}
}

Story Stats

This endpoint retrieves all available stats for a story.

HTTP Request

GET https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/stories/{id}/stats

Parameters

Field nameRequiredDescriptionPossible Values
profile_idRThis is provided in the URL. This is a required field.
idRThe story id. This is provided in the URL.
assetTypeODefault value is STORY. Providing SNAP as the assetType returns stats of the snaps in the story.STORY, SNAP
fieldsOA comma separated list of the fields for which stats are required. If this parameter is not specified in the request then stats of all fields supported by the asset type are provided in the response. Request Validation : If a requested field is not available for the requested asset type, then a validation exception will be thrown.All possible values can be found in the metrics section.
granularityODefault Value is LIFETIME. Granularity of the stats.DAY, TOTAL, LIFETIME.
startTimeOStart time of the stats. Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00 Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00 Start time must be within the past 90 days. end_time - start_time should be greater than 0
endTimeOEnd time of the stats Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00 Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00 End time must be within the past 90 days. end_time - start_time should be greater than 0
breakdownDimensionsOA comma separated list of breakdown dimensions Breaks down the stats over the provided dimensions. Request Validation : PRODUCT breakdown is only available when Asset Type is Lens. PLACEMENT breakdown is only available for the SUBSCRIBERS metric field.AGE_GENDER COUNTRY INTEREST_CATEGORY_ID OS PLACEMENT PLATFORM PRODUCT PRODUCT_CATEGORY REGION SDK_VERSION SPONSOR_TYPE
limitONumber of assets per page. This is useful when asset type is not PROFILE.10 - 1000
cursorOThis can be provided to fetch the next page of stats. Its value would be the next_page_id received in the previous response.
created_atNoCreated timestamp of the story if AssetType is SNAPFormat of UTC like 2021-03-05T02:33:39.240Z
ended_atNoEnded timestamp of the story if AssetType is SNAPended_at should be within 24hr range of PST if created_at is provided

HTTP Response

NameDescriptionPossible Values
request_idA UUID to identify this request.
request_statusSUCCESS / PARTIAL
granularityThe requested level of granularity.LIFETIME, TOTAL, DAY
assetsList of all assets Each entry represents stats for an asset
error_codeIf an error occurs then an error code will be present in this field.
debug_messageAn error message in case an error occurs.
pagingInformation about the next page of response. If there is a next page available then this object will contain the next_page_id and the next_page_link fields.

Assets

NameDescriptionPossible Values
sub_request_statusSUCCESS / ERROR
error_codeIf an error occurs then an error code will be present in this field.
debug_messageIf there was an error then the debug message will be present
asset_typeThe type of the asset for which stats are being provided.SAVED_STORY, SNAP
asset_idId of the asset
timeseriesAn array of stats. Each entry represents an asset’s Daily, Total or Lifetime stats. If the requested granularity is DAY, then this array can contain more than one entry.

TimeSeries

NameDescriptionPossible Values
start_timeStart time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
end_timeEnd time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
fieldsArray of all stats fields that were requested.Refer to fields table below

Fields

NameDescriptionPossible Values
fieldContains the field name and the breakdown dimension.Refer to field table below
statsList of stats for this field. If no breakdown was requested then this list will contain only one entry.Refer to stats table below

Field

NameDescriptionPossible Values
field_nameThe field’s name
report_dimensionThe requested breakdown dimension. If no breakdown was requested then this field’s value would be DEFAULT.

Stats

NameDescriptionPossible Values
dimension_breakdownA string representing the value of the breakdown. For example if the dimension breakdown for AGE was requested then this string could be “AGE_13_17” or “AGE_35_UP” e.t.c If no dimension breakdown was requested then this field will not be available in the response.
valueThe stats value.
percentage_valueIf dimension breakdown was requested then this value represents the percent of the total field value this breakdown makes.

Example

curl "https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/stories/{id}/stats"
-H "Authorization: <ACCESS_TOKEN>"

Response

{
"request_id": "ecfe244d-0b1b-4787-9919-4ee7dd275a0a",
"request_status": "SUCCESS",
"granularity": "DAY",
"assets": [
{
"sub_request_status": "SUCCESS",
"asset_type": "STORY",
"asset_id": "6cbe6ba5-9ee8-43f3-9a2d-dbe3e6aa8f21",
"timeseries": [
{
"start_time": "2021-11-10T00:00:00Z",
"end_time": "2021-11-11T00:00:00Z",
"fields": [
{
"field": {
"field_name": "STORY_VIEWS",
"report_dimension": "AGE"
},
"stats": [
{
"dimension_breakdown": "AGE_UNKNOWN",
"value": "0"
},
{
"dimension_breakdown": "AGE_13_17",
"value": "20"
},
….
]
},
{
"field": {
"field_name": "STORY_SUBSCRIBES",
"report_dimension": "AGE"
},
"stats": [
….
]
}
]
},
{
"start_time": "2021-11-11T00:00:00Z",
"end_time": "2021-11-12T00:00:00Z",
"fields": [
….
]
},
….
]
}
],
"paging": {
“next_page_id” : “...”,
“next_page_link” : “...”,
}
}

Spotlight Stats

This endpoint retrieves all available stats for a profile.

HTTP Request

GET https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/spotlights/{id}/stats

Parameters

Field nameRequiredDescriptionPossible Values
profile_idRThis is provided in the URL. This is a required field.
idRThe spotlight id. This is provided in the URL.
assetTypeODefault value is SPOTLIGHT.SPOTLIGHT
fieldsOA comma separated list of the fields for which stats are required. If this parameter is not specified in the request then stats of all fields supported by the asset type are provided in the response. Request Validation : If a requested field is not available for the requested asset type, then a validation exception will be thrown.All possible values can be found in the metrics section.
granularityODefault Value is LIFETIME. Granularity of the stats.DAY, TOTAL, LIFETIME.
startTimeOStart time of the stats. Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00 Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00 Start time must be within the past 90 days. end_time - start_time should be greater than 0
endTimeOEnd time of the stats Required if granularity is not LIFETIME Input format : yyyy-mm-ddT00:00:00 Request Validation : String Should be in UTC yyyy-mm-ddT00:00:00 End time must be within the past 90 days. end_time - start_time should be greater than 0
breakdownDimensionsOA comma separated list of breakdown dimensions Breaks down the stats over the provided dimensions. Request Validation : PRODUCT breakdown is only available when Asset Type is Lens. PLACEMENT breakdown is only available for the SUBSCRIBERS metric field.AGE_GENDER COUNTRY INTEREST_CATEGORY_ID OS PLACEMENT PLATFORM PRODUCT PRODUCT_CATEGORY REGION SDK_VERSION SPONSOR_TYPE
limitONumber of assets per page. This is useful when asset type is not PROFILE.10 - 1000
cursorOThis can be provided to fetch the next page of stats. Its value would be the next_page_id received in the previous response.

HTTP Response

NameDescriptionPossible Values
request_idA UUID to identify this request.
request_statusSUCCESS / PARTIAL
granularityThe requested level of granularity.LIFETIME, TOTAL, DAY
assetsList of all assets Each entry represents stats for an asset
error_codeIf an error occurs then an error code will be present in this field.
debug_messageAn error message in case an error occurs.
pagingInformation about the next page of response. If there is a next page available then this object will contain the next_page_id and the next_page_link fields.

Assets

NameDescriptionPossible Values
sub_request_statusSUCCESS / ERROR
error_codeIf an error occurs then an error code will be present in this field.
debug_messageIf there was an error then the debug message will be present
asset_typeThe type of the asset for which stats are being provided.SPOTLIGHT
asset_idId of the asset
timeseriesAn array of stats. Each entry represents an asset’s Daily, Total or Lifetime stats. If the requested granularity is DAY, then this array can contain more than one entry.

TimeSeries

NameDescriptionPossible Values
start_timeStart time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
end_timeEnd time of metrics time bucket in UTC yyyy-mm-ddThh:mm:ss
fieldsArray of all stats fields that were requested.Refer to fields table below

Fields

NameDescriptionPossible Values
fieldContains the field name and the breakdown dimension.Refer to field table below
statsList of stats for this field. If no breakdown was requested then this list will contain only one entry.Refer to stats table below

Field

NameDescriptionPossible Values
field_nameThe field’s name
report_dimensionThe requested breakdown dimension. If no breakdown was requested then this field’s value would be DEFAULT.

Stats

NameDescriptionPossible Values
dimension_breakdownA string representing the value of the breakdown. For example if the dimension breakdown for AGE was requested then this string could be “AGE_13_17” or “AGE_35_UP” e.t.c If no dimension breakdown was requested then this field will not be available in the response.
valueThe stats value.
percentage_valueIf dimension breakdown was requested then this value represents the percent of the total field value this breakdown makes.

Example

curl "https://businessapi.snapchat.com/v1/public_profiles/\{profile_id}/spotlights/{id}/stats"
-H "Authorization: <ACCESS_TOKEN>”

Response

The above command returns JSON structured like this:
{
"request_id": "ecfe244d-0b1b-4787-9919-4ee7dd275a0a",
"request_status": "SUCCESS",
"granularity": "DAY",
"assets": [
{
"sub_request_status": "SUCCESS",
"asset_type": "SPOTLIGHT",
"asset_id": "W7_EDlXWTBiXAEEniNoMPwAAYcGV3eGF4aXVnAX5Pn720AX5Pn7ufAAAAAA",
"timeseries": [
{
"start_time": "2021-11-10T00:00:00Z",
"end_time": "2021-11-11T00:00:00Z",
"fields": [
{
"field":
{
"field_name": "SPOTLIGHT_VIEWS",
"report_dimension": "AGE"
},
"stats": [
{
"dimension_breakdown": "AGE_UNKNOWN",
"value": "0"
},
{
"dimension_breakdown": "AGE_13_17",
"value": "20"
}, ….]
},
{
"field":
{
"field_name": "SPOTLIGHT_SUBSCRIBES",
"report_dimension": "AGE"
},
"stats": [….]
}]
},
{
"start_time": "2021-11-11T00:00:00Z",
"end_time": "2021-11-12T00:00:00Z",
"fields": [….]
}, ….]
}],
"paging":
{“
next_page_id”: “...”,
“next_page_link”: “...”,
}
}

Core Metrics

Field NameIs PublicField Description
METRIC_FIELD_UNSETPlaceholder if the field is not set.
VIEWSNumber of times an asset has been viewed
STORY_FAVORITESNumber of times an asset has been liked
STORY_VIEWSViews for Story container
STORY_UNIQUESUnique users who have viewed a story / snap within a story
STORY_VIEW_TIME_MILLISMilliseconds a story & snap in story asset has been viewed
STORY_AVG_VIEW_TIME_MILLIScalculated field: STORY_VIEW_TIME_MILLIS / STORY_UNIQUES
STORY_SUBSCRIBESNumber of subscribe events occurringon story asset
SAVED_STORY_FAVORITESNumber of times an asset has been liked
SAVED_STORY_VIEWSViews for Saved Stories
SAVED_STORY_UNIQUESUnique users who have viewed a saved story / snap within a saved story
SAVED_STORY_VIEW_TIME_MILLISmilliseconds a saved story has been viewed
SAVED_STORY_SUBSCRIBESNumber of subscribe events occurring on a saved story
SAVED_STORY_AVG_VIEW_TIME_MILLIScalculated field : SAVED_STORY_VIEW_TIME_MILLIS/SAVED_STORY_VIEWS
SPOTLIGHT_AVG_VIEW_TIME_MILLIScalculated field : SPOTLIGHT_VIEW_TIME_MILLIS/SPOTLIGHT_VIEWS
SPOTLIGHT_VIEWSYViews for Spotlight container
SPOTLIGHT_UNIQUESUnique users who have viewed a spotlight asset
SPOTLIGHT_VIEW_TIME_MILLISMilliseconds a spotlight asset has been viewed
SPOTLIGHT_SUBSCRIBESNumber of subscribe events occurring on spotlight asset
LENS_VIEWSViews for lens
LENS_UNIQUESUnique users who have viewed a lens asset
LENS_VIEW_TIME_MILLISmilliseconds a lens asset has been viewed
LENS_SUBSCRIBESNumber of subscribe events occurring on lens asset
LENS_AVG_VIEW_TIME_MILLIScalculated field: LENS_VIEW_TIME_MILLIS / LENS_VIEWS
UNIQUE_SESSIONSNumber of unique sessions an asset has been engaged in
VIEWERSNumber of unique users who have viewed an asset
REPLIESNumber of replies to a snap or story
SCREENSHOTSNumber of screenshots of a snap
UNIQUE_SCREENSHOTSNumber of users who have taken a screenshot of a snap
SWIPE_UPSNumber of swipe ups on an asset
SWIPE_DOWNSNumber of swipe downs on an asset
INTERACTIONSNumber of times a user interacted with an asset. These include: tap forwards/backwards, swipe-away
AVG_VIEW_TIME_MILLIS**calculated fields, not aggregation VIEW_TIME_MILLIS/VIEWS
VIEW_TIME_MILLISmilliseconds an asset has been viewed
SHARESNumber of times an asset has been shared
LENS_PLAYSnumber of plays on a lens
PLAY_TIME_MILLISlens play time, only available for lens
SUBSCRIBESNumber of subscribe events
UNSUBSCRIBESNumber of unsubscribe events
FAVORITESNumber of times an asset has been favorited
SUBSCRIBERS_GAINEDIncremental subscribers gained - only available at TOTAL & DAILY granularity- PLACEMENT LEVEL ONLY INSIGHTS ONLY AVAILABLE AT PROFILE/USER ENTITY
SUBSCRIBERSYUnique subscribers ONLY AVAILABLE AT PROFILE/USER ENTITY
SCANSA Lens’s total scans by scanning its Snapcode, opening the Lens from Snapcode Scan History, or opening the Lens by tapping on its Lens link on their mobile device.
SOCIAL_UNLOCKSNumber of Unlocks from social context card
LENS_DAU_OVER_WAUt[0, 1)/t[-7,0) (these are date ranges for lens uniques)
LENS_DAU_OVER_MAUt[0, 1)/t[-28,0) (these are date ranges for lens uniques)
TAP_FORWARDNumber of times a user taps forward on an asset
TAP_BACKNumber of times a user taps backward on an asset
LONG_IMPRESSIONSThe total number of times a tile was viewed at least 1.2 seconds and viewed at least 25% of the tile on Snapchat within selected time range.
PRODUCT_PLAYSNumber of times a user has played with a lens for a specific product variant
PRODUCT_SWIPESNumber of times a user has swiped/click on a lens for a specific product variant
PRODUCT_SHARESNumber of times a user has shared a lens for a specific product variant
PRODUCT_PLAY_TIME_MILLISMilliseconds a lens asset has been viewed
PRODUCT_AVG_PLAY_TIME_MILLIScalculated fields: PRODUCT_PLAYTIME_MILLIS/PRODUCT_PLAYS
CAMERA_PLAY_TIME_MILLISThe total amount of time a Lens is used by Snap Camera users
LENS_SHARESNumber of times a lens has been shared
COMPLETESNumber of times an asset is finished (story complete, stories & saved stories)
LENS_SUBSCRIBERS_GAINEDIncremental lens subscribers gained - only available at TOTAL & DAILY granularity- PLACEMENT LEVEL ONLY INSIGHTS ONLY AVAILABLE AT PROFILE/USER ENTITY
LENS_SUBSCRIBERSUnique lens subscribers ONLY AVAILABLE AT PROFILE/USER ENTITY
STORY_SUBSCRIBERS_GAINEDIncremental story subscribers gained - only available at TOTAL & DAILY granularity- PLACEMENT LEVEL ONLY INSIGHTS ONLY AVAILABLE AT PROFILE/USER ENTITY
STORY_SUBSCRIBERSUnique story subscribers ONLY AVAILABLE AT PROFILE/USER ENTITY
PROFILE_VIEWSNumber of views for a Profile
SPOTLIGHT_SCREENSHOTSNumber of screenshots of a snap in spotlight
SPOTLIGHT_FAVORITESNumber of times a spotlight has been liked
SPOTLIGHT_SHARESYNumber of times a spotlight has been shared
SPOTLIGHT_SUBSCRIBERS_GAINEDIncremental spotlight subscribers gained - only available at TOTAL & DAILY granularity - PLACEMENT LEVEL ONLY INSIGHTS

Combined Metrics

Metric NameDescription
ADS_SUBSCRIBESNumber of subscribe events resulting from SnapPromote Ads
PROFILE_PAID_VIEWSNumber of clicks to a profile on ads
SNAP_PAID_VIEWSThe sum of paid impression for ads promoting the snaps within the Public Story
SNAP_PAID_UNIQUESThe sum of paid uniques for ads promoting the snaps within the Public Story
SNAP_COMBINED_VIEWSThe combined value of SNAP_PAID_VIEWS and SNAP_VIEWS
SNAP_COMBINED_UNIQUESThe combined value of SNAP_PAID_UNIQUES + STORY_UNIQUES
SPOTLIGHT_PAID_VIEWSThe sum of paid impression for ads promoting the snaps within the Spotlight
SPOTLIGHT_PAID_UNIQUESThe sum of paid uniques for ads promoting the snaps within the Spotlight
SPOTLIGHT_COMBINED_VIEWSThe combined value of SPOTLIGHT_PAID_VIEWS and SPOTLIGHT_VIEWS
SPOTLIGHT_COMBINED_UNIQUESThe combined value of SPOTLIGHT_PAID_UNIQUES and SPOTLIGHT_UNIQUES
SAVED_STORY_SNAP_PAID_VIEWSThe sum of paid impression for ads promoting the snaps within the Saved Story
SAVED_STORY_SNAP_PAID_UNIQUESThe sum of paid uniques for ads promoting the snaps within the Saved Story
SAVED_STORY_SNAP_COMBINED_VIEWSThe combined value of SAVED_STORY_SNAP_PAID_VIEWS and SAVED_STORY_SNAP_VIEWS
SAVED_STORY_SNAP_COMBINED_UNIQUESThe combined value of SAVED_STORY_SNAP_PAID_UNIQUES and SAVED_STORY_UNIQUES

Metrics By Asset Type

Field NamePROFILESTORYSAVED_STORYSNAPLENSSPOTLIGHT
ADS_SUBSCRIBESx
PROFILE_PAID_VIEWSx
VIEWSxXXXXX
STORY_FAVORITESxX
STORY_VIEWSxX
STORY_UNIQUESxX
STORY_VIEW_TIME_MILLISxX
STORY_AVG_VIEW_TIME_MILLISxX
STORY_SUBSCRIBESxX
SNAP_PAID_VIEWSxXX
SNAP_PAID_UNIQUESxXX
SNAP_COMBINED_VIEWSxXX
SNAP_COMBINED_UNIQUESxXX
SAVED_STORY_FAVORITESxX
SAVED_STORY_VIEWSxX
SAVED_STORY_UNIQUESxX
SAVED_STORY_VIEW_TIME_MILLISxX
SAVED_STORY_SUBSCRIBESxX
SAVED_STORY_AVG_VIEW_TIME_MILLISxX
SAVED_STORY_SNAP_PAID_VIEWSxX
SAVED_STORY_SNAP_PAID_UNIQUESxX
SAVED_STORY_SNAP_COMBINED_VIEWSxX
SAVED_STORY_SNAP_COMBINED_UNIQUESxX
SPOTLIGHT_AVG_VIEW_TIME_MILLISxX
SPOTLIGHT_VIEWSxX
SPOTLIGHT_UNIQUESxX
SPOTLIGHT_VIEW_TIME_MILLISxX
SPOTLIGHT_SUBSCRIBESxX
SPOTLIGHT_PAID_VIEWSxX
SPOTLIGHT_PAID_UNIQUESxX
SPOTLIGHT_COMBINED_VIEWSxX
SPOTLIGHT_COMBINED_UNIQUESxX
LENS_VIEWSxX
LENS_UNIQUESxX
LENS_VIEW_TIME_MILLISxX
LENS_SUBSCRIBESxX
LENS_AVG_VIEW_TIME_MILLISxX
UNIQUE_SESSIONSXXXXXX
VIEWERSXXXXXX
REPLIESXXXX
SCREENSHOTSXX
UNIQUE_SCREENSHOTSXX
SWIPE_UPSXXXXXX
SWIPE_DOWNSXXXXXX
INTERACTIONSXXXXXX
AVG_VIEW_TIME_MILLISXXXXXX
VIEW_TIME_MILLISXXXXXX
SHARESXXXXXX
LENS_PLAYSXX
PLAY_TIME_MILLISXX
SUBSCRIBESX
UNSUBSCRIBESX
FAVORITESXXXX
SUBSCRIBERS_GAINEDX
SUBSCRIBERSX
SCANSXX
SOCIAL_UNLOCKSXX
LENS_DAU_OVER_WAUXX
LENS_DAU_OVER_MAUXX
TAP_FORWARDX
TAP_BACKX
LONG_IMPRESSIONSX
PRODUCT_PLAYSX
PRODUCT_SWIPESX
PRODUCT_SHARESX
PRODUCT_PLAY_TIME_MILLISX
PRODUCT_AVG_PLAY_TIME_MILLISX
CAMERA_PLAY_TIME_MILLISX
LENS_SHARESX
COMPLETESXX
LENS_SUBSCRIBERS_GAINEDX
LENS_SUBSCRIBERSX
STORY_SUBSCRIBERS_GAINEDX
STORY_SUBSCRIBERSX
PROFILE_VIEWSX
SPOTLIGHT_SCREENSHOTSXX
SPOTLIGHT_FAVORITESXX
SPOTLIGHT_SHARESXX
SPOTLIGHT_SUBSCRIBERS_GAINEDXX

Metrics and Supported Granularities

The following table lists any metric not supported with a particular granularity.

GranularityUnsupported Metrics
DAY
TOTALLENS_DAU_OVER_WAU, LENS_DAU_OVER_MAU
LIFETIMESUBSCRIBERS_GAINED, STORY_SUBSCRIBERS_GAINED, LENS_SUBSCRIBERS_GAINED, SPOTLIGHT_SUBSCRIBERS_GAINED, LENS_DAU_OVER_WAU, LENS_DAU_OVER_MAU
Was this page helpful?
Yes
No

AI-Powered Search