Pinterest Templates API

The Templates API from Pinterest — 3 operation(s) for templates.

OpenAPI Specification

pinterest-templates-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  version: 5.13.0
  title: Pinterest Templates API
  description: This is the description of your API.
  contact:
    name: Pinterest, Inc.
    url: https://developers.pinterest.com/
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://developers.pinterest.com/terms/
servers:
- url: https://api.pinterest.com/v5
tags:
- name: Templates
paths:
  /ad_accounts/{ad_account_id}/targeting_templates:
    get:
      summary: List targeting templates
      description: Get a list of the targeting templates in the specified <code>ad_account_id</code>
      operationId: targeting_template/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_order'
      - in: query
        description: Include audience sizing in result or not
        name: include_sizing
        required: false
        schema:
          type: boolean
          default: false
      - description: Search keyword for targeting templates
        in: query
        name: search_query
        example: gaming
        required: false
        schema:
          type: string
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/TargetingTemplateResponseData'
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - Templates
    post:
      summary: Create targeting templates
      description: "<p>Targeting templates allow advertisers to save a set of targeting details including audience lists,\n keywords & interest, demographics, and placements to use more than once during the campaign creation process.</p>\n <p>Templates can be used to build out basic targeting criteria that you plan to use across campaigns and to reuse\n  performance targeting from prior campaigns for new campaigns.</p>"
      operationId: targeting_template/create
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: targeting template creation entity
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetingTemplateCreate'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetingTemplateGetResponseData'
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - Templates
    patch:
      summary: Update targeting templates
      description: <p>Update the targeting template given advertiser ID and targeting template ID</p>
      operationId: targeting_template/update
      security:
      - pinterest_oauth2:
        - ads:write
      x-ratelimit-category: ads_write
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      requestBody:
        description: Operation type and targeting template ID
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetingTemplateUpdateRequest'
      responses:
        '200':
          description: Success
        '400':
          description: Invalid ad account id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account id
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unexpected error
      tags:
      - Templates
  /ad_accounts/{ad_account_id}/templates:
    get:
      summary: List templates
      description: Gets all Templates associated with an ad account ID.
      operationId: templates/list
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_order'
      - $ref: '#/components/parameters/query_bookmark'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/TemplateResponse'
          description: Success
        '400':
          description: Invalid ad account template parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account template parameters
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Templates
  /ad_accounts/{ad_account_id}/templates/{template_id}/reports:
    post:
      summary: Create async request for an analytics report using a template
      description: 'This takes a template ID and an optional custom timeframe and constructs an asynchronous report based on the

        template. It returns a token that you can use to download the report when it is ready.'
      operationId: analytics/create_template_report
      security:
      - pinterest_oauth2:
        - ads:read
      x-ratelimit-category: ads_analytics
      x-sandbox: disabled
      parameters:
      - $ref: '#/components/parameters/path_ad_account_id'
      - $ref: '#/components/parameters/path_template_id'
      - $ref: '#/components/parameters/query_start_date_async'
      - $ref: '#/components/parameters/query_end_date_async'
      - $ref: '#/components/parameters/query_granularity_async'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdsAnalyticsCreateAsyncResponse'
          description: Success
        '400':
          description: Invalid ad account ads analytics template parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                code: 400
                message: Invalid ad account analytics template parameters.
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Templates
components:
  schemas:
    TargetingTemplateAudienceSizing:
      type: object
      nullable: true
      description: 'Gets an audience size estimate for a set of given targeting spec data. <p>Returns:</p> An object containing an audience size estimate that has a reach estimate (number of unique users) against the given targeting template. This by default provides a monthly estimate. '
      example:
        reach_estimate:
          estimate: 63492000
          lower_bound: 47619000
          upper_bound: 79365000
      properties:
        reach_estimate:
          type: object
          properties:
            estimate:
              example: 63492000
              type: integer
              format: int64
            lower_bound:
              example: 47619000
              type: integer
              format: int64
            upper_bound:
              example: 79365000
              type: integer
              format: int64
    TargetingTemplateResponseData:
      type: object
      allOf:
      - $ref: '#/components/schemas/TargetingTemplateCommon'
      - type: object
        title: TargetingTemplateResponseData
        properties:
          id:
            description: Targeting template ID.
            example: '643'
            type: string
            pattern: ^\d+$
          created_time:
            description: Targeting template created time. Unix timestamp in seconds.
            example: 1432744744
            title: created_time
            type: integer
          updated_time:
            description: Targeting template updated time.Unix timestamp in seconds.
            example: 1432744744
            title: updated_time
            type: integer
          ad_account_id:
            description: The ID of the advertiser that this targeting template belongs to.
            example: '549755885175'
            type: string
            pattern: ^\d+$
          status:
            type: string
            description: Indicate targeting template is active or Deleted
            allOf:
            - type: string
              description: Indicate targeting template is active or Deleted
              example: ACTIVE
              default: ACTIVE
              enum:
              - ACTIVE
              - DELETED
          sizing:
            $ref: '#/components/schemas/TargetingTemplateAudienceSizing'
    Error:
      title: Error
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
      required:
      - code
      - message
    TargetingTemplateCommon:
      type: object
      properties:
        name:
          type: string
          example: Gaming
          description: targeting template name
        auto_targeting_enabled:
          type: boolean
          default: true
          description: Enable auto-targeting for ad group. Also known as <a href="https://help.pinterest.com/en/business/article/expanded-targeting" target="_blank">"expanded targeting"</a>.
        targeting_attributes:
          $ref: '#/components/schemas/TargetingSpec'
        placement_group:
          $ref: '#/components/schemas/PlacementGroupType'
        keywords:
          type: array
          example:
          - value: cats
            match_type: EXACT_NEGATIVE
          items:
            $ref: '#/components/schemas/TargetingTemplateKeyword'
        tracking_urls:
          $ref: '#/components/schemas/TrackingUrls'
    MetricsReportingLevel:
      type: string
      description: Level of the reporting request
      example: CAMPAIGN
      enum:
      - ADVERTISER
      - ADVERTISER_TARGETING
      - CAMPAIGN
      - CAMPAIGN_TARGETING
      - AD_GROUP
      - AD_GROUP_TARGETING
      - PIN_PROMOTION
      - PIN_PROMOTION_TARGETING
      - KEYWORD
      - PRODUCT_GROUP
      - PRODUCT_GROUP_TARGETING
      - PRODUCT_ITEM
    TargetingTemplateKeyword:
      type: object
      properties:
        match_type:
          $ref: '#/components/schemas/MatchType'
        value:
          type: string
          description: The keyword targeting (120 chars max).
          example: couples halloween costumes
    CustomColumnId:
      description: Custom Column ID
      example: '123456789'
      type: string
    TargetingSpec:
      description: Ad group targeting specification defining the ad group target audience. For example, `{"APPTYPE":["iphone"], "GENDER":["male"], "LOCALE":["en-US"], "LOCATION":["501"], "AGE_BUCKET":["25-34"]}`
      type: object
      properties:
        AGE_BUCKET:
          type: array
          nullable: true
          description: Age ranges. If the AGE_BUCKET field is missing, the default behavior in terms of ad delivery is that **All age buckets** will be targeted.
          example:
          - 35-44
          - 50-54
          items:
            type: string
            enum:
            - 18-24
            - 21+
            - 25-34
            - 35-44
            - 45-49
            - 50-54
            - 55-64
            - 65+
        APPTYPE:
          type: array
          nullable: true
          description: Allowed devices. If the APPTYPE field is missing, the default behavior in terms of ad delivery is that **All devices/apptypes** will be targeted.
          example:
          - ipad
          - iphone
          items:
            type: string
            enum:
            - android_mobile
            - android_tablet
            - ipad
            - iphone
            - web
            - web_mobile
        AUDIENCE_EXCLUDE:
          type: array
          nullable: true
          description: 'Excluded customer list IDs. Used to drive new customer acquisition goals. For example: ["2542620905475"]. Audience lists need to have at least 100 people with Pinterest accounts in them. If the AUDIENCE_EXCLUDE field is missing, the default behavior in terms of ad delivery is that **No users will be excluded**.'
          items:
            type: string
            pattern: ^\d+$
            minItems: 100
        AUDIENCE_INCLUDE:
          type: array
          nullable: true
          description: 'Targeted customer list IDs. For example: ["2542620905473"]. Audience lists need to have at least 100 people with Pinterest accounts in them Audience lists need to have at least 100 people with Pinterest accounts in them. If the AUDIENCE_INCLUDE field is missing, the default behavior in terms of ad delivery is that **All users will be included**.'
          items:
            type: string
            pattern: ^\d+$
            minItems: 100
        GENDER:
          type: array
          nullable: true
          description: 'Targeted genders. Values: ["unknown","male","female"]. If the GENDER field is missing, the default behavior in terms of ad delivery is that **All genders will be targeted**.'
          items:
            type: string
            enum:
            - unknown
            - male
            - female
        GEO:
          type: array
          nullable: true
          description: Location region codes, e.g., "BE-VOV" (East Flanders, Belgium) For complete list, <a href="https://help.pinterest.com/sub/helpcenter/partner/pinterest_location_targeting_codes.xlsx" target="_blank">click here</a> or postal codes, e.g., "US-94107". Use either region codes or postal codes but not both. At least one of LOCATION or GEO must be specified. If the GEO field is missing, then only LOCATION values will be targeted (see LOCATION field below).
          items:
            type: string
        INTEREST:
          type: array
          description: Array of interest object IDs. If the INTEREST field is missing, the default behavior in terms of ad delivery is that **All interests will be targeted**.
          items:
            type: string
        LOCALE:
          type: array
          nullable: true
          description: 24 ISO 639-1 two letter language codes. If the LOCALE field is missing, the default behavior in terms of ad delivery is that **All languages will be targeted, only english non-sublanguage will be targeted**.
          items:
            type: string
        LOCATION:
          type: array
          nullable: true
          description: 22 ISO Alpha 2 two letter country codes or US Nielsen DMA (Designated Market Area) codes (location region codes) (e.g., ["US", "807"]). For complete list, click here. Location-Country and Location-Metro codes apply. At least one of LOCATION or GEO must be specified. If the LOCATION field is missing, then only GEO values will be targeted (see GEO field above).
          items:
            type: string
        SHOPPING_RETARGETING:
          type: array
          nullable: true
          description: "Array of object: lookback_window\t[Integer]: Number of days ago to start lookback timeframe for dynamic retargeting tag_types [Array of integer]: Event types to target for dynamic retargeting exclusion_window [Integer]: Number of days ago to stop lookback timeframe for dynamic retargeting"
          items:
            type: object
            example:
              lookback_window: 30
              exclusion_window: 14
              tag_types:
              - 0
              - 6
            properties:
              lookback_window:
                description: Number of days ago to start lookback timeframe for dynamic retargeting
                example: 30
                title: lookback_window
                type: integer
              tag_types:
                description: Event types to target for dynamic retargeting
                example:
                - 0
                - 6
                items:
                  type: integer
                title: tag_types
                type: array
              exclusion_window:
                description: Number of days ago to stop lookback timeframe for dynamic retargeting
                example: 14
                title: exclusion_window
                type: integer
            title: TargetingSpec_SHOPPING_RETARGETING
        TARGETING_STRATEGY:
          type: array
          nullable: true
          description: ''
          items:
            enum:
            - CHOOSE_YOUR_OWN
            - FIND_NEW_CUSTOMERS
            - RECONNECT_WITH_USERS
    TargetingTemplateCreate:
      type: object
      allOf:
      - $ref: '#/components/schemas/TargetingTemplateCommon'
      - type: object
        required:
        - name
        - targeting_attributes
        properties:
          name:
            type: string
            example: Gaming
            description: Name of targeting template.
          targeting_attributes:
            $ref: '#/components/schemas/TargetingSpec'
    Paginated:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
        bookmark:
          type: string
          nullable: true
      required:
      - items
    AdsAnalyticsCreateAsyncResponse:
      type: object
      properties:
        report_status:
          type: string
          allOf:
          - $ref: '#/components/schemas/BulkReportingJobStatus'
        token:
          type: string
        message:
          type: string
          nullable: true
    MatchType:
      type: string
      description: Keyword match type
      example: BROAD
      enum:
      - BROAD
      - PHRASE
      - EXACT
      - EXACT_NEGATIVE
      - PHRASE_NEGATIVE
    DataOutputFormat:
      type: string
      description: Format of generated report
      example: JSON
      enum:
      - JSON
      - CSV
    TrackingUrls:
      description: Third-party tracking URLs. Up to three tracking URLs - with a max length of 2,000 - are supported for each event type. Tracking URLs set at the ad group or ad level can override those set at the campaign level. For more information, see <a href="https://help.pinterest.com/en/business/article/third-party-and-dynamic-tracking" target="_blank">Third-party and dynamic tracking</a>.
      example:
        impression:
        - URL1
        - URL2
        click:
        - URL1
        - URL2
        engagement:
        - URL1
        - URL2
        buyable_button:
        - URL1
        - URL2
        audience_verification:
        - URL1
        - URL2
      type: object
      nullable: true
      properties:
        impression:
          type: array
          items:
            type: string
        click:
          type: array
          items:
            type: string
        engagement:
          type: array
          items:
            type: string
        buyable_button:
          type: array
          items:
            type: string
        audience_verification:
          type: array
          items:
            type: string
    TargetingTemplateUpdateRequest:
      required:
      - operation_type
      - id
      type: object
      properties:
        operation_type:
          enum:
          - REMOVE
          type: string
        id:
          description: Targeting template ID
          example: '643'
          type: string
          pattern: ^\d+$
    BulkReportingJobStatus:
      type: string
      description: Possible status for a bulk reporting job
      example: FINISHED
      enum:
      - DOES_NOT_EXIST
      - FINISHED
      - IN_PROGRESS
      - EXPIRED
      - FAILED
      - CANCELLED
    TemplateResponse:
      type: object
      description: Template fields
      properties:
        id:
          description: Template ID
          example: '6739202847590'
          type: string
        ad_account_id:
          description: ID of the Ad Account that owns the template
          example: '547664674848'
          type: string
        ad_account_ids:
          description: IDs of the Ad Accounts that have access to this template
          example:
          - '547664674848'
          type: array
          items:
            type: string
        user_id:
          description: ID of the user who created the template
          example: '784762938748396'
          type: string
        name:
          description: Template Name
          example: Week over week spend
          nullable: true
          type: string
        report_start_relative_days_in_past:
          description: The number of days prior to the day the report will be delivered at which the report will start
          example: 7
          type: number
        report_end_relative_days_in_past:
          description: The number of days prior to the day the report will be delivered at which the report will end
          example: 7
          type: number
        date_range:
          properties:
            dynamic_date_range:
              description: The dynamic date range of the template
              nullable: true
              example:
                range: YEAR_TO_DATE
                type: dynamic
              properties:
                type:
                  description: The date range type
                  example: dynamic
                  type: string
                range:
                  description: The dynamic range type
                  enum:
                  - YEAR_TO_DATE
                  - QUARTER_TO_DATE
                  - MONTH_TO_DATE
                  - LAST_MONTH
                  example: YEAR_TO_DATE
                  type: string
              type: object
            relative_date_range:
              description: The relative date range of the template
              nullable: true
              example:
                end_days_in_past: 7
                type: relative
                start_days_in_past: 14
              properties:
                type:
                  description: The date range type
                  example: relative
                  type: string
                start_days_in_past:
                  description: The start date of the date range
                  example: 14
                  type: number
                end_days_in_past:
                  description: The end date of the date range
                  example: 7
                  type: number
              type: object
            absolute_date_range:
              description: The absolute date range of the template
              nullable: true
              example:
                end_date: 6.027456183070403
                type: absolute
                start_date: 0.8008281904610115
              properties:
                type:
                  description: The date range type
                  example: absolute
                  type: string
                start_date:
                  description: The start date of the date range
                  example: 0.8008281904610115
                  type: number
                end_date:
                  description: The end date of the date range
                  example: 6.027456183070403
                  type: number
              type: object
          type: object
        report_level:
          $ref: '#/components/schemas/MetricsReportingLevel'
        report_format:
          $ref: '#/components/schemas/DataOutputFormat'
        columns:
          description: A list of columns to be included in the report
          example:
          - SPEND_IN_DOLLAR
          items:
            type: string
            description: Reporting Columns (Internal)
            example: TOTAL_CONVERSIONS
            enum:
            - SPEND_IN_MICRO_DOLLAR
            - SPEND_IN_MICRO_US_DOLLAR
            - BONUS_SPEND_IN_MICRO_DOLLAR
            - BONUS_SPEND_IN_DOLLAR
            - PAID_IMPRESSION
            - PAID_CLICKTHROUGH
            - SPEND_IN_DOLLAR
            - SPEND_IN_US_DOLLAR
            - CPC_IN_MICRO_DOLLAR
            - ECPC_IN_MICRO_DOLLAR
            - CPC_IN_DOLLAR
            - ECPC_IN_DOLLAR
            - CTR
            - ECTR
            - OUTBOUND_CTR
            - CPC_IN_MICRO_CURRENCY
            - CPW_IN_MICRO_DOLLAR
            - CPW_IN_DOLLAR
            - COST_PER_OUTBOUND_CLICK
            - AD_ONLY_PIN
            - CAMPAIGN_NAME
            - CAMPAIGN_STATUS
            - DATE
            - BUDGET_IN_DOLLAR
            - AVAILABLE_BUDGET_IN_DOLLAR
            - TARGETING_TYPE
            - TARGETING_VALUE
            - TARGETING_VALUE_NAME
            - PAID_EVENTS
            - BONUS_EVENTS
            - INSERTION
            - LEGACY_CAMPAIGN_ID
            - HBASE_ID
            - PIN_DESCRIPTION
            - CAMPAIGN_END_DATE
            - PIN_PROMOTION_STATUS
            - AD_STATUS
            - PIN_ID
            - CROSS_DEVICE_TYPE
            - INGESTION_SOURCE
            - SOURCE_PLATFORM
            - PIN_PROMOTION_IS_RUNNING
            - TOTAL_ENGAGEMENT
            - ENGAGEMENT_1
            - ENGAGEMENT_2
            - CPE_IN_MICRO_DOLLAR
            - ECPE_IN_MICRO_DOLLAR
            - CPE_IN_DOLLAR
            - ECPE_IN_DOLLAR
            - ENGAGEMENT_RATE
            - EENGAGEMENT_RATE
            - INTERNAL_ECPE_IN_MICRO_DOLLAR
            - INTERNAL_ECPE_IN_DOLLAR
            - ECPM_IN_MICRO_DOLLAR
            - ECPM_IN_DOLLAR
            - REPIN_RATE
            - REPIN_RATE_2
            - CTR_2
            - CAMPAIGN_ID
            - ADVERTISER_ID
            - AD_ACCOUNT_ID
            - ADVERTISER_OWNER_USER_ID
            - ADVERTISER_OWNER_USER_NAME
            - PIN_PROMOTION_ID
            - AD_ID
            - AD_GROUP_ID
            - KEYWORD_ID
            - KEYWORD_IS_DELETED
            - BRAND_SFDC_ACCOUNT_ID
            - CAMPAIGN_ACTION_TYPE
            - CAMPAIGN_BID_TYPE
            - CAMPAIGN_ENTITY_STATUS
            - CAMPAIGN_MANAGED_STATUS
            - CAMPAIGN_OBJECTIVE_TYPE
            - CPM_IN_MICRO_DOLLAR
            - CPM_IN_DOLLAR
            - BUDGET_TYPE
            - BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_NAME
            - AD_GROUP_STATUS
            - AD_GROUP_END_DATE
            - AD_GROUP_BUDGET_TYPE
            - AD_GROUP_BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_SUGGESTED_BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_SUGGESTED_BONUS_BUDGET_IN_LOCAL_CURRENCY
            - AD_GROUP_ENTITY_STATUS
            - AD_GROUP_ACTION_TYPE
            - AD_GROUP_CONVERSION_LEARNING_MODE_TYPE
            - AD_GROUP_TARGET_CPA
            - AD_GROUP_BID_STRATEGY_TYPE
            - AD_GROUP_EXPERIMENT_NAME
            - AD_GROUP_EXPERIMENT_CELL
            - CAMPAIGN_WEB_CLOSEUP_WHITELISTED
            - PRODUCT_GROUP_ID
            - PRODUCT_GROUP_DEFINITION
            - PARENT_PRODUCT_GROUP_ID
            - PRODUCT_GROUP_TYPE
            - PRODUCT_GROUP_BID_IN_MICRO_CURRENCY
            - PRODUCT_GROUP_STATUS
            - PRODUCT_GROUP_ENTITY_STATUS
            - PRODUCT_GROUP_INCLUSION
            - PRODUCT_GROUP_CREATIVE_TYPE
            - ITEM_ID
            - PRODUCT_ITEM_ID
            - INTERNAL_PRODUCT_ITEM_ID
            - PRODUCT_ITEM_NAME
            - PRODUCT_ITEM_IMAGE_URL
            - PRODUCT_ITEM_PRICE
            - ORDER_LINE_ID
            - ORDER_LINE_NAME
            - ORDER_LINE_PIN_REV_SHARE
            - ORDER_LINE_PAID_TYPE
            - SPEND_ORDER_LINE_ID
            - SPEND_ORDER_LINE_PAID_TYPE
            - CLICKTHROUGH_1
            - REPIN_1
            - IMPRESSION_1
            - LIKE_1
            - SEND_1
            - FLAG_1
            - HIDE_1
            - INSERTION_1
            - IMPRESSION_1_GROSS
            - CLICKTHROUGH_1_GROSS
            - OUTBOUND_CLICK_1
            - CLICKTHROUGH_USER_1
            - REPIN_USER_1
            - IMPRESSION_USER_1
            - LIKE_USER_1
            - SEND_USER_1
            - FLAG_USER_1
            - HIDE_USER_1
            - INSERTION_USER_1
            - CLICKTHROUGH_2
            - REPIN_2
            - IMPRESSION_2
            - LIKE_2
            - SEND_2
            - FLAG_2
            - OUTBOUND_CLICK_2
            - CLICKTHROUGH_USER_2
            - REPIN_USER_2
            - IMPRESSION_USER_2
            - LIKE_USER_2
            - SEND_USER_2
            - FLAG_USER_2
            - TOTAL_CLICKTHROUGH
            - TOTAL_REPIN
            - TOTAL_IMPRESSION
            - TOTAL_LIKE
            - TOTAL_SEND
            - TOTAL_FLAG
            - TOTAL_IMPRESSION_USER
            - TOTAL_IMPRESSION_FREQUENCY
            - TOTAL_OUTBOUND_CLICK
            - COST_PER_OUTBOUND_CLICK_IN_DOLLAR
            - ENGAGEMENT_PAGE_VISIT_1
            - ENGAGEMENT_SIGNUP_1
            - ENGAGEMENT_CHECKOUT_1
            - ENGAGEMENT_CUSTOM_1
            - ENGAGEMENT_ADD_TO_CART_1
            - ENGAGEMENT_LEAD_1
            - ENGAGEMENT_SEARCH_1
            - ENGAGEMENT_WATCH_VIDEO_1
            - ENGAGEMENT_VIEW_CATEGORY_1
            - ENGAGEMENT_APP_INSTALL_1
            - ENGAGEMENT_UNKNOWN_1
            - CLICK_PAGE_VISIT_1
            - CLICK_SIGNUP_1
            - CLICK_CHECKOUT_1
            - CLICK_CUSTOM_1
            - CLICK_ADD_TO_CART_1
            - CLICK_LEAD_1
            - CLICK_SEARCH_1
            - CLICK_WATCH_VIDEO_1
            - CLICK_VIEW_CATEGORY_1
            - CLICK_APP_INSTALL_1
            - CLICK_UNKNOWN_1
            - VIEW_PAGE_VISIT_1
            - VIEW_SIGNUP_1
            - VIEW_CHECKOUT_1
            - VIEW_CUSTOM_1
            - VIEW_ADD_TO_CART_1
            - VIEW_LEAD_1
            - VIEW_SEARCH_1
            - VIEW_WATCH_VIDEO_1
            - VIEW_VIEW_CATEGORY_1
            - VIEW_APP_INSTALL_1
            - VIEW_UNKNOWN_1
            - CONVERSIONS_1
            - ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_SEARCH_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_VIEW_CATEGORY_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR_1
            - ENGAGEMENT_UNKNOWN_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_LEAD_VALUE_IN_MICRO_DOLLAR_1
            - CLICK_SEARCH_VALUE_IN_MICRO_DOLLAR_1
            

# --- truncated at 32 KB (94 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/openapi/pinterest-templates-api-openapi.yml