Qodex.ai

Get Pin analytics

GET {{baseUrl}}/pins/:pin_id/analytics?start_date=2003-07-02&end_date=2003-07-02&app_types=ALL&metric_types=OUTBOUND_CLICK,PIN_CLICK&split_field=NO_SPLIT&ad_account_id=6342

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
end_datestring(Required) Metric report end date (UTC). Format: YYYY-MM-DD
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

{"aliqua_8a6":{"daily_metrics":[{"data_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"metrics":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"data_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"metrics":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}],"summary_metrics":{"SAVE":20,"SAVE_RATE":0.18,"IMPRESSION":240,"OUTBOUND_CLICK":200,"PIN_CLICK":37,"VIDEO_10S_VIEW":2,"VIDEO_V50_WATCH_TIME":10031,"QUARTILE_95_PERCENT_VIEW":8,"VIDEO_AVG_WATCH_TIME":2507.75,"VIDEO_START":2,"VIDEO_MRC_VIEW":2}},"esse_":{"daily_metrics":[{"data_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"metrics":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"data_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"metrics":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}],"summary_metrics":{"SAVE":20,"SAVE_RATE":0.18,"IMPRESSION":240,"OUTBOUND_CLICK":200,"PIN_CLICK":37,"VIDEO_10S_VIEW":2,"VIDEO_V50_WATCH_TIME":10031,"QUARTILE_95_PERCENT_VIEW":8,"VIDEO_AVG_WATCH_TIME":2507.75,"VIDEO_START":2,"VIDEO_MRC_VIEW":2}},"do_741":{"daily_metrics":[{"data_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"metrics":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"data_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"metrics":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}],"summary_metrics":{"SAVE":20,"SAVE_RATE":0.18,"IMPRESSION":240,"OUTBOUND_CLICK":200,"PIN_CLICK":37,"VIDEO_10S_VIEW":2,"VIDEO_V50_WATCH_TIME":10031,"QUARTILE_95_PERCENT_VIEW":8,"VIDEO_AVG_WATCH_TIME":2507.75,"VIDEO_START":2,"VIDEO_MRC_VIEW":2}}}