Get user account top video pins analytics
GET {{baseUrl}}/user_account/analytics/top_video_pins?start_date=1970-08-02&end_date=1970-08-02&sort_by=VIDEO_MRC_VIEW&from_claimed_content=BOTH&pin_format=ALL&app_types=ALL&metric_types=SAVE,VIDEO_MRC_VIEW&num_of_pins=25&created_in_last_n_days=30&ad_account_id=91255
Gets analytics data about a user's top video pins (limited to the top 50).
- By default, the operation user_account
is the token user_account.
Optional: Business Access: Specify an adaccountid to use the owner of that adaccount as the "operation useraccount".
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
start_date | string | (Required) Metric report start date (UTC). Format: YYYY-MM-DD | |
end_date | string | (Required) Metric report end date (UTC). Format: YYYY-MM-DD | |
sort_by | string | (Required) Specify sorting order for video metrics | |
from_claimed_content | string | Filter on Pins that match your claimed domain. | |
pin_format | string | Pin formats to get data for, default is all. | |
app_types | string | Apps or devices to get data for, default is all. | |
metric_types | string | Metric types to get video data for, default is all. | |
num_of_pins | number | Number of pins to include, default is 10. Max is 50. | |
created_in_last_n_days | number | Get metrics for pins created in the last "n" days. | |
ad_account_id | number | Unique identifier of an ad account. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"date_availability":{"latest_available_timestamp":1649116799000,"is_realtime":false},"pins":[{"metrics":{"IMPRESSION":7,"QUARTILE_95_PERCENT_VIEW":2,"SAVE":1,"VIDEO_10S_VIEW":5,"VIDEO_AVG_WATCH_TIME":86989,"VIDEO_MRC_VIEW":2,"VIDEO_START":2,"VIDEO_V50_WATCH_TIME":173979,"OUTBOUND_CLICK":2},"data_status":{"laborum_0b":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"ad59b":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"pin_id":"642396334344813594"},{"metrics":{"IMPRESSION":7,"QUARTILE_95_PERCENT_VIEW":2,"SAVE":1,"VIDEO_10S_VIEW":5,"VIDEO_AVG_WATCH_TIME":86989,"VIDEO_MRC_VIEW":2,"VIDEO_START":2,"VIDEO_V50_WATCH_TIME":173979,"OUTBOUND_CLICK":2},"data_status":{"nisi_31f":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"laborumc":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"pin_id":"642396334344813594"}],"sort_by":"IMPRESSION"}