Get Pin analytics
Get analytics for a Pin owned by the "operation user_account" - or on a group board that has been shared with this account.
- By default, the "operation user_account" is the token user_account.
Optional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following Business Access roles on the ad_account:
- For Pins on public or protected boards: Admin, Analyst.
- For Pins on secret boards: Admin.
If Pin was created before 2023-03-20 lifetime metrics will only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin formats since then.
Path parameters
Unique identifier of a Pin.
Query parameters
Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
Apps or devices to get data for, default is all.
Pin metric types to get data for. VIDEO_MRC_VIEW are Video views, VIDEO_V50_WATCH_TIME is Total play time. If Pin was created before 2023-03-20, Profile visits and Follows will only be available for Idea Pins. These metrics are available for all Pin formats since then. Keep in mind this cannot have ALL if split_field is set to any value other than NO_SPLIT.
How to split the data into groups. Not including this param means data won't be split.
Unique identifier of an ad account.
Response
The request has succeeded.