Get Pin analytics

GET {{baseUrl}}/pins/:pin_id/analytics?start_date=<date>&end_date=<date>&app_types=ALL&metric_types=PIN_CLICK,USER_FOLLOW&split_field=NO_SPLIT&ad_account_id=47

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 adaccountid (obtained via List ad accounts) to use the owner of that adaccount as the "operation useraccount. In order to do this, the token user_account must have one of the following https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access roles on the ad_account:

  • For Pins on public or protected boards: Admin, Analyst.
  • For Pins on secret boards: Admin.

Request Params

KeyDatatypeRequiredDescription
start_datestring(Required) Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.
end_datestring(Required) Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.
app_typesstringApps or devices to get data for, default is all.
metric_typesstring(Required) Pin metric types to get data for, default is all.
split_fieldstringHow to split the data into groups. Not including this param means data won't be split.
ad_account_idnumberUnique identifier of an ad account.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;in3_5&quot;:{&quot;lifetime_metrics&quot;:{&quot;veniam2&quot;:&quot;\u003cinteger\u003e&quot;},&quot;daily_metrics&quot;:[{&quot;data_status&quot;:&quot;BEFORE_DEMOGRAPHIC_FILTERS_START_DATE&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;in_5bb&quot;:&quot;\u003cnumber\u003e&quot;,&quot;enim_5c&quot;:&quot;\u003cnumber\u003e&quot;}},{&quot;data_status&quot;:&quot;AUDIENCE_TOTAL_SMALLER_THAN_THRESHOLD&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;ad0_7&quot;:&quot;\u003cnumber\u003e&quot;}}],&quot;summary_metrics&quot;:{&quot;sint_3&quot;:&quot;\u003cnumber\u003e&quot;,&quot;laboris9db&quot;:&quot;\u003cnumber\u003e&quot;}},&quot;occaecat_695&quot;:{&quot;lifetime_metrics&quot;:{&quot;reprehenderit886&quot;:&quot;\u003cinteger\u003e&quot;,&quot;eiusmod_2&quot;:&quot;\u003cinteger\u003e&quot;,&quot;labore80&quot;:&quot;\u003cinteger\u003e&quot;},&quot;daily_metrics&quot;:[{&quot;data_status&quot;:&quot;BEFORE_DEMOGRAPHIC_FILTERS_START_DATE&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;voluptate915&quot;:&quot;\u003cnumber\u003e&quot;,&quot;officia_1d&quot;:&quot;\u003cnumber\u003e&quot;}},{&quot;data_status&quot;:&quot;BEFORE_PIN_CREATED&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;ut_253&quot;:&quot;\u003cnumber\u003e&quot;,&quot;magnaba2&quot;:&quot;\u003cnumber\u003e&quot;}}],&quot;summary_metrics&quot;:{&quot;enim_078&quot;:&quot;\u003cnumber\u003e&quot;}},&quot;eiusmod_5c0&quot;:{&quot;lifetime_metrics&quot;:{&quot;irure2a&quot;:&quot;\u003cinteger\u003e&quot;,&quot;non0ea&quot;:&quot;\u003cinteger\u003e&quot;},&quot;daily_metrics&quot;:[{&quot;data_status&quot;:&quot;PROCESSING&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;labore50&quot;:&quot;\u003cnumber\u003e&quot;,&quot;cillum5e&quot;:&quot;\u003cnumber\u003e&quot;}},{&quot;data_status&quot;:&quot;PROCESSING&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;consequat137&quot;:&quot;\u003cnumber\u003e&quot;,&quot;in_b_&quot;:&quot;\u003cnumber\u003e&quot;}}],&quot;summary_metrics&quot;:{&quot;veniam4c&quot;:&quot;\u003cnumber\u003e&quot;,&quot;doloree&quot;:&quot;\u003cnumber\u003e&quot;,&quot;enim_78&quot;:&quot;\u003cnumber\u003e&quot;}},&quot;cupidatat12&quot;:{&quot;lifetime_metrics&quot;:{&quot;eiusmod3c9&quot;:&quot;\u003cinteger\u003e&quot;,&quot;non957&quot;:&quot;\u003cinteger\u003e&quot;,&quot;dolor_b5&quot;:&quot;\u003cinteger\u003e&quot;},&quot;daily_metrics&quot;:[{&quot;data_status&quot;:&quot;READY&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;cupidatata&quot;:&quot;\u003cnumber\u003e&quot;}},{&quot;data_status&quot;:&quot;AUDIENCE_TOTAL_SMALLER_THAN_THRESHOLD&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;laborisf&quot;:&quot;\u003cnumber\u003e&quot;}}],&quot;summary_metrics&quot;:{&quot;ametd&quot;:&quot;\u003cnumber\u003e&quot;,&quot;non_d06&quot;:&quot;\u003cnumber\u003e&quot;}},&quot;id_24e&quot;:{&quot;lifetime_metrics&quot;:{&quot;sunt637&quot;:&quot;\u003cinteger\u003e&quot;,&quot;aliquipf&quot;:&quot;\u003cinteger\u003e&quot;},&quot;daily_metrics&quot;:[{&quot;data_status&quot;:&quot;READY&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;ut_2&quot;:&quot;\u003cnumber\u003e&quot;,&quot;ut0&quot;:&quot;\u003cnumber\u003e&quot;}},{&quot;data_status&quot;:&quot;BEFORE_AUDIENCE_MONTHLY_METRIC_START_DATE&quot;,&quot;date&quot;:&quot;\u003cstring\u003e&quot;,&quot;metrics&quot;:{&quot;officiaf_1&quot;:&quot;\u003cnumber\u003e&quot;,&quot;labore3&quot;:&quot;\u003cnumber\u003e&quot;,&quot;commodo73&quot;:&quot;\u003cnumber\u003e&quot;}}],&quot;summary_metrics&quot;:{&quot;inca1&quot;:&quot;\u003cnumber\u003e&quot;,&quot;veniam_d&quot;:&quot;\u003cnumber\u003e&quot;,&quot;consecteture23&quot;:&quot;\u003cnumber\u003e&quot;,&quot;eta&quot;:&quot;\u003cnumber\u003e&quot;}}}