News Feed Card Analytics Endpoint

get

/feed/data_series

This endpoint allows you to retrieve a daily series of engagement stats for a card over time.

Request Parameters

Parameter Required Data Type Description
card_id Yes String Card API Identifier
length Yes Integer Max number of units (days or hours) before ending_at to include in the returned series - must be between 1 and 100 inclusive
unit No String Unit of time between data points - can be “day” or “hour” (defaults to “day”)
ending_at No DateTime (ISO 8601 string) Date on which the data series should end - defaults to time of the request

Request Components

Example URL

https://rest.iad-01.braze.com/feed/data_series?card_id=3bbc4555-8fa0-4c9b-a5c0-4505edf3e064&length=14&unit=day&ending_at=2018-06-28T23:59:59-5:00

Example Request

1
2
curl --location --request GET 'https://rest.iad-01.braze.com/feed/data_series?card_id=3bbc4555-8fa0-4c9b-a5c0-4505edf3e064&length=14&unit=day&ending_at=2018-06-28T23:59:59-5:00' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
{
    "message": (required, string) the status of the export, returns 'success' when completed without errors,
    "data" : [
        {
            "time" : (string) point in time - as ISO 8601 extended when unit is "hour" and as ISO 8601 date when unit is "day",
            "clicks" : (int) ,
            "impressions" : (int),
            "unique_clicks" : (int),
            "unique_impressions" : (int)
        },
        ...
    ]
}
WAS THIS PAGE HELPFUL?
New Stuff!