Get user account top video pins analytics
GET {{baseUrl}}/user_account/analytics/top_video_pins?start_date=<date>&end_date=<date>&sort_by=QUARTILE_95_PERCENT_VIEW&from_claimed_content=BOTH&pin_format=ALL&app_types=ALL&metric_types=OUTBOUND_CLICK,VIDEO_AVG_WATCH_TIME&num_of_pins=10&created_in_last_n_days=30&ad_account_id=579382468
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. Cannot be more than 90 days back from today. | |
end_date | string | (Required) Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date. | |
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":"\u003cnumber\u003e","is_realtime":"\u003cboolean\u003e"},"pins":[{"metrics":{"Excepteur77b":"\u003cnumber\u003e","Excepteurb":"\u003cnumber\u003e"},"data_status":{"tempor_73":"BEFORE_ASSIST_METRIC_START_DATE","sunt1":"BEFORE_PIN_FORMAT_METRIC_START_DATE","veniam8a":"READY"},"pin_id":"\u003cstring\u003e"},{"metrics":{"dolore0_4":"\u003cnumber\u003e","sit_17":"\u003cnumber\u003e","eu3":"\u003cnumber\u003e"},"data_status":{"consectetur871":"BEFORE_METRIC_START_DATE","eiusmod_a":"PURCHASERS_METRIC_SMALLER_THAN_THRESHOLD"},"pin_id":"\u003cstring\u003e"}],"sort_by":"VIDEO_10S_VIEW"}