Pinterest Organic Connector Reference

24 metrics57 dimensions

The Pinterest Organic connector retrieves Pinterest organic data on an account, board and pin level.

https://connectors.windsor.ai/pinterest_organic?api_key=[your API key]&date_preset=last_7d&fields=date,pin_id,pin_impression,pin_click,pin_outbound_click

The Pinterest Organic connector exposes 81 fields (24 metrics, 57 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


Available options


pin__pin_filter Pins - Pin Filter

Pin filter to use when requesting pin data. Default - None

Possible values (4)
defaultexclude_nativeexclude_repinshas_been_promoted
pin__include_protected_pins Pins - Include Protected Pins

Specify if return pins from protected boards. Default - false

pin__creative_types Pins - Creative Types

Pin creative types filter. By default returns all pin types

Possible values (8)
ALLdefaultREGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOCOLLECTIONIDEA
board__privacy Boards - Privacy Types

Privacy setting for a board to return. By default returns all boards.

Possible values (5)
ALLdefaultPROTECTEDPUBLICSECRETPUBLIC_AND_SECRET
account__from_claimed_content Account Analytics - From Claimed Content

Filter on Pins that match your claimed domain. Default: BOTH

Possible values (3)
BOTHdefaultOTHERCLAIMED
account__pin_format Account Analytics - Pin Format

Pin format to get data for. Default: ALL

Possible values (11)
ALLdefaultORGANIC_IMAGEORGANIC_PRODUCTORGANIC_VIDEOADS_STANDARDADS_PRODUCTADS_VIDEOADS_IDEAPRODUCTREGULARVIDEO
account__app_types Account Analytics - App Types

Apps or devices to get data for. Default: ALL

Possible values (4)
ALLdefaultMOBILETABLETWEB
account__content_type Account Analytics - Content Type

Filter to paid or organic data. Default: ALL

Possible values (3)
ALLdefaultPAIDORGANIC
account__source Account Analytics - Source

Filter to activity from Pins created and saved by your, or activity created and saved by others from your claimed accounts. Default: ALL

Possible values (3)
ALLdefaultYOUR_PINSOTHER_PINS
pin_analytics__app_types Pin Analytics - App Types

Apps or devices to get data for. Default: ALL

Possible values (4)
ALLdefaultMOBILETABLETWEB

Pinterest Organic Fields

Pinterest Organic Account fields

The Account report of the Pinterest Organic connector includes 12 fields.

IDTypeNameDescription
account_aboutTEXTAccount aboutUser profile about description.
account_account_typeTEXTAccount typeType of account. Enum: 'PINNER', 'BUSINESS'.
account_board_countNUMERICAccount board countUser account board count. Note: Board count on user account level may differ from counts found elsewhere due to attribution of collaborative Boards.
account_business_nameTEXTAccount business nameAccount business name
account_follower_countNUMERICAccount follower countUser account follower count.
account_following_countNUMERICAccount following countUser account following count.
account_idTEXTAccount idAccount id
account_monthly_viewsNUMERICAccount monthly viewsUser account monthly views
account_nameTEXTAccount nameAccount name
account_pin_countNUMERICAccount pin countUser account pin count. This includes both created and saved pins.
account_profile_imageIMAGE_URLAccount profile image URLAccount profile image URL
account_website_urlTEXTAccount website urlAccount website url

Pinterest Organic Board fields

The Board report of the Pinterest Organic connector includes 13 fields.

IDTypeNameDescription
board_board_pins_modified_atTIMESTAMPBoard pins modified atBoard pins modified at
board_collaborator_countNUMERICBoard collaborator countBoard collaborator count
board_created_atTIMESTAMPBoard created dateBoard created date
board_descriptionTEXTBoard descriptionBoard description
board_follower_countNUMERICBoard follower countBoard follower count
board_idTEXTBoard IDBoard ID
board_image_cover_urlIMAGE_URLBoard image cover urlBoard image cover url
board_media_image_cover_urlIMAGE_URLBoard media image cover urlBoard media image cover url
board_nameTEXTBoard nameBoard name
board_ownerTEXTBoard ownerBoard owner username
board_owner_usernameTEXTBoard owner usernameBoard owner username
board_pin_countNUMERICBoard pin countBoard pin count
board_privacyTEXTBoard privacyBoard privacy

Pinterest Organic Pin fields

The Pin report of the Pinterest Organic connector includes 24 fields.

IDTypeNameDescription
pin_alt_textTEXTPin alt_textPin alt_text
pin_board_section_idIMAGE_URLPin board section IDPin board section ID
pin_created_atTIMESTAMPPin created datePin created date
pin_creative_typeTIMESTAMPPin creative typePin creative type. Enum: 'REGULAR' 'VIDEO' 'SHOPPING' 'CAROUSEL' 'MAX_VIDEO' 'COLLECTION' 'IDEA' 'SHOWCASE' 'QUIZ'
pin_descriptionTEXTPin descriptionPin description
pin_dominant_colorTEXTPin dominant colorDominant pin color. Hex number, e.g. '#6E7874'.
pin_has_been_promotedBOOLEANPin has been promotedWhether the Pin has been promoted or not.
pin_idTEXTPin idPin id
pin_image_urlIMAGE_URLPin image urlPin image url
pin_is_ownerBOOLEANPin is ownerWhether the 'operation user_account' is the Pin owner.
pin_is_standardBOOLEANPin is standardWhether the Pin is standard or not. See documentation on https://developers.pinterest.com/docs/content/update/ for more information.
TEXTPin linkPin link
pin_media_cover_image_urlIMAGE_URLPin media cover image urlPin media cover image url
pin_media_durationNUMERICPin media duration (video)Pin media duration (in milliseconds)
pin_media_heightNUMERICPin media height (video)Pin media height (in pixels)
pin_media_images_1200x_urlIMAGE_URLPin image 1200px urlPin image 1200px url
pin_media_images_150x150_urlIMAGE_URLPin image 150px urlPin image 150px url
pin_media_images_400x300_urlIMAGE_URLPin image 400px urlPin image 400px url
pin_media_media_typeTEXTPin media typePin media type
pin_media_video_urlTEXTPin media video urlVideo url (720p). Note: This field is limited and not available to all apps.
pin_media_widthNUMERICPin media width (video)Pin media width (in pixels)
pin_noteTEXTPin private notePrivate note for this Pin.
TEXTPin permalinkPin permalink
pin_titleTEXTPin titlePin title

Pinterest Organic pin_analytics fields

The pin_analytics report of the Pinterest Organic connector includes 14 fields.

IDTypeNameDescription
dateDATEDatePin analytics date
pin_clickNUMERICPin pin_clickPin analytics pin_click
pin_impressionNUMERICPin impressionPin analytics impression
pin_outbound_clickNUMERICPin outbound_clickPin analytics outbound_click
pin_quartile_95_percent_viewNUMERICPin quartile_95_percent_viewPin analytics quartile_95_percent_view
pin_saveNUMERICPin savePin analytics save
pin_save_ratePERCENTPin save ratePin analytics save rate
pin_total_commentsNUMERICPin total commentsPin analytics total comments
pin_total_reactionsNUMERICPin total reactionsPin analytics total reactions
pin_video_10s_viewNUMERICPin video_10s_viewPin analytics video_10s_view
pin_video_avg_watch_timeNUMERICPin video_avg_watch_timePin analytics video_avg_watch_time
pin_video_mrc_viewNUMERICPin video_mrc_viewPin analytics video_mrc_view
pin_video_startNUMERICPin video_startPin analytics video_start
pin_video_v50_watch_timeNUMERICPin video_v50_watch_timePin analytics video_v50_watch_time

Pinterest Organic other fields

The Pinterest Organic connector has 18 fields that do not belong to a named report, or belong to a report with only one or two fields.

IDTypeNameDescriptionReport
data_fetched_atTIMESTAMPData fetched atUTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasourceTEXTData SourceThe name of the Windsor connector returning the row
day_of_monthTEXTDay of monthDay of the month
monthTEXTMonthNumber of the month
nowTIMESTAMPNowCurrent timestamp
sourceTEXTSourceThe name of the Windsor connector returning the row
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_month_nameTEXTYear month nameYear and month with the month name written out, e.g. "Jan 2025".
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20