The GSS Metric API is used to get statistics about apps registered in Galaxy Store. The GSS Metric API provides programmatic access to some of the statistics in the Galaxy Store Statistics (GSS) system.
The GSS Metric API is part of the Galaxy Store Developer API. You must meet all of the requirements of the Galaxy Store Developer API including, but not limited to, creating the access token and including the access token in the authorization header of every GSS Metric API call.
Every request must include authorization header parameters which specify the content type and your access token. See Create an Access Token for more information about how to create an access token and Use the Access Token for more information about how to use the access token.
Bearer <your-access-token>
application/json
Provides statistics about new downloads, downloads by devices, sales, and item sales for all of the seller's registered apps.
POST /gss/query/sellerMetric
sellerInfo: {gssUserId}
loginUserProfile
startDate
endDate
filters[{country}, {device}]
getBreakdownsByFilter
curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <your-access-token>" \ -H "service-account-id: <your-service-account-id>" \ -H "Cookie:sellerLocale=<your-seller-locale>; gss_auth_token=<your-gss-auth-token>; api_server_url=<your-api-server-url>; auth_server_url=<your-auth-server-url>" \ -d '{"sellerId":"abcdefg123", "periods":[ {"startDate":"2021-03-08","endDate":"2021-03-14"}, {"startDate":"2021-03-01","endDate":"2021-03-07"}], "getDailyMetric":false, "getBreakdownsByFilter":true, "noContentMetadata":true, "metricIds":[ "total_unique_installs_filter", "revenue_total", "dn_by_total_dvce", "revenue_item"], "filters":{}, "trendAggregation":"day"}' \ "https://devapi.samsungapps.com/gss/query/sellerMetric"
Success
Status: 200 Success
{ "sellerId":"abcdefg123", "metricIds":["total_unique_installs_filter"], "data":{ "periods":[ { "startDate":"2021-03-07", "endDate":"2021-03-13", "metricSubValues":{ "total_unique_installs_filter":{ "country":{ "USA":142867.0, "Ireland":3378.0, ... "Korea":162398.0 }, "carrier":{"unknown":1437474.0}, "rgn":{ "Middle East & Africa":149305.0, "Asia Pacific":537159.0, "Europe":316615.0, "America":348903.0, "CIS":85473.0, "unknown":19.0 }, "device":{ "Galaxy A20 ":255.0, ... "Galaxy S21 Plus 5G":16728.0, "Galaxy J2 Core":689.0, "Galaxy Tab A Plus (10.1)":347.0, "Galaxy A51 ":39.0 } } }, "contentMetrics":{}, "metricSummaries":{"total_unique_installs_filter":1437474.0} } ] }, "noContentMetadata":true, "trendAggregation":"day", "periods":[{"endDate":"2021-03-14","startDate":"2021-03-08"}], "filters":{}, "getBreakdownsByFilter":true, "getDailyMetric":false }
Failure: SellerId is required
Status: 400 Bad Request
Failure: Undefined API
Status: 404 Not Found
Provides statistics about new downloads, sales, item purchases, average rating, and ratings volume for the specified app.
POST /gss/query/contentMetric
metricIds
noBreakdown
curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <your-access-token>" \ -H "Cookie:sellerLocale=<your-seller-locale>; gss_auth_token=<your-gss-auth-token>; api_server_url=<your-api-server-url>; auth_server_url=<your-auth-server-url>" \ -d '{ \ "contentId":"000007654321","periods":[{"startDate":"2021-03-08","endDate":"2021-03-14"}, {"startDate":"2021-03-01","endDate":"2021-03-07"}], "noBreakdown":true, "metricIds":["total_unique_installs_filter", "revenue_total", "revenue_iap_order_count", "daily_rat_score", "daily_rat_volumne"], "filters":{}, "trendAggregation":"day"}' \ "https://devapi.samsungapps.com/gss/query/contentMetric" \
{ "metricIds":[ "total_unique_installs_filter", "revenue_total", "revenue_iap_order_count", "daily_rat_score", "daily_rat_volumne" ], "data":{ "periods":[ { "endDate":"2021-03-06", "startDate":"2021-02-28", "000007654321":{ "total_unique_installs_filter":{ "dailyTrend":{ "2021-03-05":{ "value":361.0, "cumulativeValue":2014.0, "subValuesMap":null }, ... }, "value":2300.0, "summary":{} }, "daily_rat_score":{ "dailyTrend":{ "2021-03-05":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} }, "revenue_iap_order_count":{ "dailyTrend":{ "2021-03-05":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} }, "daily_rat_volumne":{ "dailyTrend":{ "2021-03-05":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} }, "revenue_total":{ "dailyTrend":{ "2021-03-05":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} } } }, { "endDate":"2021-03-13", "startDate":"2021-03-07", "000007654321":{ "total_unique_installs_filter":{ "dailyTrend":{ "2021-03-13":{ "value":153.0, "cumulativeValue":1085.0, "subValuesMap":null }, ... }, "value":1085.0, "summary":{} }, "daily_rat_score":{ "dailyTrend":{ "2021-03-13":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} }, "revenue_iap_order_count":{ "dailyTrend":{ "2021-03-13":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} }, "daily_rat_volumne":{ "dailyTrend":{ "2021-03-13":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} }, "revenue_total":{ "dailyTrend":{ "2021-03-13":{ "value":0.0, "cumulativeValue":0.0, "subValuesMap":null }, ... }, "value":0.0, "summary":{} } } } ], "distinctValues":{}, "content":{ "content_name":"The best app ever!", ... "store_type":"Apps", "updated_date":"2021-03-02", "content":"000007654321", "status":"For Sale" } }, "noBreakdown":true, "trendAggregation":"day", "contentId":"000007654321", "periods":[ {"endDate":"2021-03-13","startDate":"2021-03-07"}, {"endDate":"2021-03-06","startDate":"2021-02-28"} ], "filters":{"country":["Korea"], "device":["Galaxy S21 5G"]} }
Failure: Content ID is required