Pinterest

Pinterest Results API

The Results API from Pinterest — 2 operation(s) for results.

GitHub OpenAPI

Operations 2

GET /catalogs/feeds/{feed_id}/processing_results List processing results for a given feed #
GET /catalogs/processing_results/{processing_result_id}/item_issues List item issues for a given processing result #

Documentation

📖
Documentation
https://developers.pinterest.com/docs/api/v5/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/openapi/pinterest-results-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/openapi/pinterest-asyncapi.yml

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/pinterest/refs/heads/main/graphql/pinterest-graphql.md

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/pinterest-results-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pinterest-results-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 5.13.0
  title: Pinterest Results 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: Results
paths:
  /catalogs/feeds/{feed_id}/processing_results:
    get:
      x-ratelimit-category: catalogs_read
      summary: List processing results for a given feed
      description: 'Fetch a feed processing results owned by the "operation user_account". Please note that for now the bookmark parameter is not functional and only the first page will be available until it is implemented in some release in the near future.

        - By default, the "operation user_account" is the token user_account.


        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href=''/docs/api/v5/#operation/ad_accounts/list''>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.


        <a href=''/docs/shopping/catalog/''>Learn more</a>'
      operationId: feed_processing_results/list
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/path_catalogs_feed_id'
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CatalogsFeedProcessingResult'
          description: Success
        '400':
          description: Invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InvalidRequest:
                  value:
                    code: 1
                    message: Parameter 'page_size' was not numeric (was 3e)"
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '404':
          description: Feed not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                FeedNotFound:
                  value:
                    code: 4161
                    message: Sorry! We could not find your catalogs feed.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Results
  /catalogs/processing_results/{processing_result_id}/item_issues:
    get:
      x-ratelimit-category: catalogs_read
      summary: List item issues for a given processing result
      description: 'List item validation issues for a given feed processing result owned by the "operation user_account". Up to 20 random samples of affected items are returned for each error and warning code. Please note that for now query parameters ''item_numbers'' and ''item_validation_issue'' cannot be used simultaneously until it is implemented in some release in the future.

        - By default, the "operation user_account" is the token user_account.


        Optional: Business Access: Specify an <code>ad_account_id</code> (obtained via <a href=''/docs/api/v5/#operation/ad_accounts/list''>List ad accounts</a>) 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 <a href="https://help.pinterest.com/en/business/article/share-and-manage-access-to-your-ad-accounts">Business Access</a> roles on the ad_account: Owner, Admin, Catalogs Manager.


        <a href=''/docs/shopping/catalog/''>Learn more</a>'
      operationId: items_issues/list
      security:
      - pinterest_oauth2:
        - catalogs:read
      x-sandbox: enabled
      parameters:
      - $ref: '#/components/parameters/query_bookmark'
      - $ref: '#/components/parameters/query_page_size'
      - $ref: '#/components/parameters/path_catalogs_processing_result_id'
      - $ref: '#/components/parameters/query_catalogs_item_numbers'
      - $ref: '#/components/parameters/query_catalogs_item_validation_issue'
      - $ref: '#/components/parameters/query_ad_account_id'
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Paginated'
                - type: object
                  properties:
                    items:
                      type: array
                      items:
                        $ref: '#/components/schemas/CatalogsItemValidationIssues'
          description: Success
        '401':
          description: Unauthorized access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UnauthorizedAccess:
                  value:
                    code: 29
                    message: You are not permitted to access that resource.
        '404':
          description: Processing Result not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ProcessingResultFound:
                  value:
                    code: 4184
                    message: Sorry! We could not find your processing result.
        '501':
          description: Not implemented.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                NotImplemented:
                  value:
                    code: 4181
                    message: Not implemented at the moment. Please, see documentation.
        default:
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Results
components:
  schemas:
    CatalogsFeedProductCounts:
      type:
      - object
      - 'null'
      description: The counts can be null early in the process.
      properties:
        original:
          description: The number of products in the feed file.
          type: integer
        ingested:
          description: The number of products successfully ingested from the feed file.
          type: integer
    CatalogsDbItem:
      type: object
      title: db_item
      properties:
        created_at:
          type: string
          format: date-time
          example: '2022-03-14T15:15:22Z'
        id:
          type: string
        updated_at:
          type: string
          format: date-time
          example: '2022-03-14T15:16:34Z'
    CatalogsFeedIngestionErrors:
      type: object
      properties:
        LINE_LEVEL_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to ingest this some items. The next ingestion will happen in 24 hours.
        LARGE_PRODUCT_COUNT_DECREASE:
          type: integer
          enum:
          - 1
          description: The product count has decreased by more than 99% compared to the last successful ingestion.
        ACCOUNT_FLAGGED:
          type: integer
          description: We detected an issue with your account and are not currently ingesting your items. Please review our policies at policy.pinterest.com/community-guidelines#section-spam or contact us at help.pinterest.com/contact for more information.
        IMAGE_LEVEL_INTERNAL_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to download some images. The next download attempt will happen in 24 hours.
        IMAGE_FILE_NOT_ACCESSIBLE:
          type: integer
          description: Image files are unreadable. Please upload new files to continue.
        IMAGE_MALFORMED_URL:
          type: integer
          description: Image files are unreadable. Please check your link and upload new files to continue.
        IMAGE_FILE_NOT_FOUND:
          type: integer
          description: Image files are unreadable. Please upload new files to continue.
        IMAGE_INVALID_FILE:
          type: integer
          description: Image files are unreadable. Please upload new files to continue.
    Paginated:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
        bookmark:
          type:
          - string
          - 'null'
      required:
      - items
    CatalogsFeedValidationDetails:
      type: object
      properties:
        errors:
          $ref: '#/components/schemas/CatalogsFeedValidationErrors'
        warnings:
          $ref: '#/components/schemas/CatalogsFeedValidationWarnings'
      required:
      - errors
      - warnings
    CatalogsItemValidationIssue:
      type: string
      enum:
      - AD_LINK_FORMAT_WARNING
      - AD_LINK_SAME_AS_LINK
      - ADDITIONAL_IMAGE_LINK_LENGTH_TOO_LONG
      - ADDITIONAL_IMAGE_LINK_WARNING
      - ADULT_INVALID
      - ADWORDS_FORMAT_INVALID
      - ADWORDS_FORMAT_WARNING
      - ADWORDS_SAME_AS_LINK
      - AGE_GROUP_INVALID
      - ANDROID_DEEP_LINK_INVALID
      - AVAILABILITY_DATE_INVALID
      - AVAILABILITY_INVALID
      - BLOCKLISTED_IMAGE_SIGNATURE
      - COUNTRY_DOES_NOT_MAP_TO_CURRENCY
      - CUSTOM_LABEL_LENGTH_TOO_LONG
      - DESCRIPTION_LENGTH_TOO_LONG
      - DESCRIPTION_MISSING
      - DUPLICATE_PRODUCTS
      - EXPIRATION_DATE_INVALID
      - GENDER_INVALID
      - GTIN_INVALID
      - IMAGE_LINK_INVALID
      - IMAGE_LINK_LENGTH_TOO_LONG
      - IMAGE_LINK_MISSING
      - IMAGE_LINK_WARNING
      - INVALID_DOMAIN
      - IOS_DEEP_LINK_INVALID
      - IS_BUNDLE_INVALID
      - ITEM_ADDITIONAL_IMAGE_DOWNLOAD_FAILURE
      - ITEM_MAIN_IMAGE_DOWNLOAD_FAILURE
      - ITEMID_MISSING
      - LINK_FORMAT_INVALID
      - LINK_FORMAT_WARNING
      - LINK_LENGTH_TOO_LONG
      - LIST_PRICE_INVALID
      - MAX_ITEMS_PER_ITEM_GROUP_EXCEEDED
      - MIN_AD_PRICE_INVALID
      - MPN_INVALID
      - MULTIPACK_INVALID
      - OPTIONAL_CONDITION_INVALID
      - OPTIONAL_CONDITION_MISSING
      - OPTIONAL_PRODUCT_CATEGORY_INVALID
      - OPTIONAL_PRODUCT_CATEGORY_MISSING
      - PARSE_LINE_ERROR
      - PINJOIN_CONTENT_UNSAFE
      - PRICE_CANNOT_BE_DETERMINED
      - PRICE_MISSING
      - PRODUCT_CATEGORY_DEPTH_WARNING
      - PRODUCT_LINK_MISSING
      - PRODUCT_PRICE_INVALID
      - PRODUCT_TYPE_LENGTH_TOO_LONG
      - SALE_DATE_INVALID
      - SALES_PRICE_INVALID
      - SALES_PRICE_TOO_HIGH
      - SALES_PRICE_TOO_LOW
      - SHIPPING_INVALID
      - SHIPPING_HEIGHT_INVALID
      - SHIPPING_WEIGHT_INVALID
      - SHIPPING_WIDTH_INVALID
      - SIZE_SYSTEM_INVALID
      - SIZE_TYPE_INVALID
      - TAX_INVALID
      - TITLE_LENGTH_TOO_LONG
      - TITLE_MISSING
      - TOO_MANY_ADDITIONAL_IMAGE_LINKS
      - UTM_SOURCE_AUTO_CORRECTED
      - WEIGHT_UNIT_INVALID
    CatalogsFeedValidationErrors:
      type: object
      properties:
        FETCH_ERROR:
          type: integer
          description: Pinterest couldn't download your feed.
        FETCH_INACTIVE_FEED_ERROR:
          type: integer
          description: Your feed wasn't ingested because it hasnt changed in the previous 90 days.
        ENCODING_ERROR:
          type: integer
          description: Your feed includes data with an unsupported encoding format.
        DELIMITER_ERROR:
          type: integer
          description: Your feed includes data with formatting errors.
        REQUIRED_COLUMNS_MISSING:
          type: integer
          description: Your feed is missing some required column headers.
        DUPLICATE_PRODUCTS:
          type: integer
          description: Some products are duplicated.
        IMAGE_LINK_INVALID:
          type: integer
          description: Some image links are formatted incorrectly.
        ITEMID_MISSING:
          type: integer
          description: Some items are missing an item id in their product metadata, those items will not be published.
        TITLE_MISSING:
          type: integer
          description: Some items are missing a title in their product metadata, those items will not be published.
        DESCRIPTION_MISSING:
          type: integer
          description: Some items are missing a description in their product metadata, those items will not be published.
        PRODUCT_LINK_MISSING:
          type: integer
          description: Some items are missing a link URL in their product metadata, those items will not be published.
        IMAGE_LINK_MISSING:
          type: integer
          description: Some items are missing an image link URL in their product metadata, those items will not be published.
        AVAILABILITY_INVALID:
          type: integer
          description: Some items are missing an availability value in their product metadata, those items will not be published.
        PRODUCT_PRICE_INVALID:
          type: integer
          description: Some items have price formatting errors in their product metadata, those items will not be published.
        LINK_FORMAT_INVALID:
          type: integer
          description: Some link values are formatted incorrectly.
        PARSE_LINE_ERROR:
          type: integer
          description: Your feed contains formatting errors for some items.
        ADWORDS_FORMAT_INVALID:
          type: integer
          description: Some adwords links contain too many characters.
        INTERNAL_SERVICE_ERROR:
          type: integer
          description: We experienced a technical difficulty and were unable to ingest your feed. The next ingestion will happen in 24 hours.
        NO_VERIFIED_DOMAIN:
          type: integer
          description: Your merchant domain needs to be claimed.
        ADULT_INVALID:
          type: integer
          description: Some items have invalid adult values.
        IMAGE_LINK_LENGTH_TOO_LONG:
          type: integer
          description: Some items have image_link URLs that contain too many characters, so those items will not be published.
        INVALID_DOMAIN:
          type: integer
          description: Some of your product link values don't match the verified domain associated with this account.
        FEED_LENGTH_TOO_LONG:
          type: integer
          description: Your feed contains too many items, some items will not be published.
        LINK_LENGTH_TOO_LONG:
          type: integer
          description: Some product links contain too many characters, those items will not be published.
        MALFORMED_XML:
          type: integer
          description: Your feed couldn't be validated because the xml file is formatted incorrectly.
        PRICE_MISSING:
          type: integer
          description: Some products are missing a price, those items will not be published.
        FEED_TOO_SMALL:
          type: integer
          description: Your feed couldn't be validated because the file doesn't contain the minimum number of lines required.
        MAX_ITEMS_PER_ITEM_GROUP_EXCEEDED:
          type: integer
          description: Some items exceed the maximum number of items per item group, those items will not be published.
        ITEM_MAIN_IMAGE_DOWNLOAD_FAILURE:
          type: integer
          description: Some items' main images can't be found.
        PINJOIN_CONTENT_UNSAFE:
          type: integer
          description: Some items were not published because they don't meet Pinterest's Merchant Guidelines.
        BLOCKLISTED_IMAGE_SIGNATURE:
          type: integer
          description: Some items were not published because they don't meet Pinterest's Merchant Guidelines.
        LIST_PRICE_INVALID:
          type: integer
          description: Some items have list price formatting errors in their product metadata, those items will not be published.
        PRICE_CANNOT_BE_DETERMINED:
          type: integer
          description: Some items were not published because price cannot be determined. The price, list price, and sale price are all different, so those items will not be published.
    CatalogsItemValidationDetails:
      type: object
      properties:
        attribute_name:
          $ref: '#/components/schemas/NullableCatalogsItemFieldType'
          description: Attribute that has a validation issue.
        provided_value:
          type:
          - string
          - 'null'
          description: Provided value that caused the validation issue.
      required:
      - attribute_name
      - provided_value
    CatalogsFeedProcessingResult:
      type: object
      allOf:
      - $ref: '#/components/schemas/CatalogsDbItem'
      - type: object
        title: catalogs_feed_processing_result_fields
        properties:
          ingestion_details:
            $ref: '#/components/schemas/CatalogsFeedIngestionDetails'
          status:
            $ref: '#/components/schemas/CatalogsFeedProcessingStatus'
          product_counts:
            $ref: '#/components/schemas/CatalogsFeedProductCounts'
          validation_details:
            $ref: '#/components/schemas/CatalogsFeedValidationDetails'
        required:
        - ingestion_details
        - status
        - product_counts
        - validation_details
    CatalogsItemValidationErrors:
      type: object
      properties:
        ADULT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an invalid adult value.
        ADWORDS_FORMAT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Adword link contains too many characters.
        AVAILABILITY_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing availability value in its product metadata, this item will not be published.
        BLOCKLISTED_IMAGE_SIGNATURE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item will not be published because it doesn't meet Pinterest's Merchant Guidelines.
        DESCRIPTION_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing description in its product metadata, this item will not be published.
        DUPLICATE_PRODUCTS:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: This product is duplicated. The duplicate entry will not be published.
        IMAGE_LINK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Image link is invalid.
        IMAGE_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has image_link URL that contains too many characters, so the item will not be published.
        IMAGE_LINK_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing an image link URL in its product metadata, this item will not be published.
        INVALID_DOMAIN:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Product link value doesn't match the verified domain associated with this account.
        ITEMID_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing item id in its product metadata, this item will not be published.
        ITEM_MAIN_IMAGE_DOWNLOAD_FAILURE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Main image can't be found.
        LINK_FORMAT_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Link is invalid.
        LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Product link contains too many characters, this item will not be published.
        LIST_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a list price formatting error, this item will not be published.
        MAX_ITEMS_PER_ITEM_GROUP_EXCEEDED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item exceed the maximum number of items per item group, this item will not be published.
        PARSE_LINE_ERROR:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item contains formating errors.
        PINJOIN_CONTENT_UNSAFE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item will not be published because it doesn't meet Pinterest's Merchant Guidelines.
        PRICE_CANNOT_BE_DETERMINED:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item price cannot be determined because the price, list price, and sale price are all different.
        PRICE_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Product is missing a price, this item will not be published.
        PRODUCT_LINK_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing a link URL in its product metadata, this item will not be published.
        PRODUCT_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a price formatting error in its product metadata, this item will not be published.
        TITLE_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing title in its product metadata, this item will not be published.
    CatalogsFeedIngestionDetails:
      type: object
      properties:
        errors:
          $ref: '#/components/schemas/CatalogsFeedIngestionErrors'
        info:
          $ref: '#/components/schemas/CatalogsFeedIngestionInfo'
        warnings:
          $ref: '#/components/schemas/CatalogsFeedIngestionWarnings'
      required:
      - errors
      - info
      - warnings
    CatalogsItemValidationIssues:
      type: object
      properties:
        item_number:
          description: Item number based on order of appearance in the Catalogs Feed. For example, '0' refers to first item found in a feed that was downloaded from a 'location' specified during feed creation.
          example: 0
          type: integer
        item_id:
          description: The merchant-created unique ID that represents the product.
          example: DS0294-L
          type:
          - string
          - 'null'
        errors:
          $ref: '#/components/schemas/CatalogsItemValidationErrors'
        warnings:
          $ref: '#/components/schemas/CatalogsItemValidationWarnings'
      required:
      - item_number
      - item_id
      - errors
      - warnings
    NullableCatalogsItemFieldType:
      description: Product item fields
      example: TITLE
      type:
      - string
      - 'null'
      enum:
      - ITEM_ID
      - ITEM_GROUP_ID
      - TITLE
      - DESCRIPTION
      - ITEM_LINK
      - ORGANIC_LINK
      - IMAGE_LINK
      - ADWORDS_REDIRECT_LINK
      - AD_LINK
      - SIZE
      - GOOGLE_PRODUCT_CATEGORY
      - PRODUCT_CATEGORY
      - CONDITION
      - AVAILABILITY
      - GENDER
      - AGE_GROUP
      - SIZE_TYPE
      - SIZE_SYSTEM
      - ADULT
      - SHIPPING
      - SHIPPING_WEIGHT
      - TAX
      - MULTIPACK
      - ADDITIONAL_IMAGE_LINK
      - PRICE
      - SALE_PRICE
      - IS_BUNDLE
      - EXPIRATION_DATE
      - SALE_PRICE_EFFECTIVE_DATE
      - AVAILABILITY_DATE
      - WEIGHT_UNIT
      - PRODUCT_TYPE
      - CUSTOM_LABEL_0
      - CUSTOM_LABEL_1
      - CUSTOM_LABEL_2
      - CUSTOM_LABEL_3
      - CUSTOM_LABEL_4
      - MATERIAL
      - PATTERN
      - COLOR
      - BRAND
      - GTIN
      - MPN
      - IOS_DEEP_LINK
      - ANDROID_DEEP_LINK
      - FREE_SHIPPING_LABEL
      - FREE_SHIPPING_LIMIT
      - AVG_REVIEW_RATING
      - NUM_RATINGS
      - NUM_REVIEWS
      - ALT_TEXT
      - VARIANT_NAMES
      - VARIANT_VALUES
      - MIN_AD_PRICE
      - SHIPPING_WIDTH
      - SHIPPING_HEIGHT
      - null
    CatalogsFeedProcessingStatus:
      type: string
      enum:
      - COMPLETED
      - COMPLETED_EARLY
      - DISAPPROVED
      - FAILED
      - PROCESSING
      - QUEUED_FOR_PROCESSING
      - UNDER_APPEAL
      - UNDER_REVIEW
    CatalogsItemValidationWarnings:
      type: object
      properties:
        AD_LINK_FORMAT_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an ad link that is formatted incorrectly.
        AD_LINK_SAME_AS_LINK:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an ad link URL that is duplicate of the link URL.
        ADDITIONAL_IMAGE_LINK_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an additional_image_link URL that contains too many characters, so the item will not be published.
        ADDITIONAL_IMAGE_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has additional_image_link URLs that are formatted incorrectly and will not be published with your items.
        ADWORDS_FORMAT_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an adwords_redirect link that is formatted incorrectly.
        ADWORDS_SAME_AS_LINK:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an adwords_redirect URL that is duplicate of the link URL.
        AGE_GROUP_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an age group value that is formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences.
        SIZE_SYSTEM_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Some items have size system values which are not one of the supported size systems.
        ANDROID_DEEP_LINK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes an invalid android_deep_link.
        AVAILABILITY_DATE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an availability_date value that is formatted incorrectly, this item will be published without an availability date.
        COUNTRY_DOES_NOT_MAP_TO_CURRENCY:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a currency that doesn't match the usual currency for the location where the product is sold or shipped.
        CUSTOM_LABEL_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a custom_label value that is too long, this item will be published without that custom label.
        DESCRIPTION_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: The description for this item was truncated because it contains too many characters.
        EXPIRATION_DATE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an expiration_date value that is formatted incorrectly, this item will be published without an expiration date.
        GENDER_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a gender value that is formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences.
        GTIN_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a GTIN value that is formatted incorrectly.
        IMAGE_LINK_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an image_link URL that is formatted incorrectly and will not be published.
        IOS_DEEP_LINK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes an invalid ios_deep_link value.
        IS_BUNDLE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an is_bundle value that is formatted incorrectly, this item will be published without being bundled with other products.
        ITEM_ADDITIONAL_IMAGE_DOWNLOAD_FAILURE:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes additional_image_links that can't be found.
        LINK_FORMAT_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an invalid product link which contains invalid UTM tracking paramaters.
        MIN_AD_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a min_ad_price value that is formatted incorrectly.
        MPN_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a MPN value that is formatted incorrectly.
        MULTIPACK_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an invalid multipack value.
        OPTIONAL_CONDITION_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a condition value that is formatted incorrectly, which may limit visibility in recommendations, search results and shopping experiences.
        OPTIONAL_CONDITION_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing condition value, which may limit visibility in recommendations, search results and shopping experiences.
        OPTIONAL_PRODUCT_CATEGORY_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item includes a google_product_category value that is not formatted correctly according to the GPC taxonomy.
        OPTIONAL_PRODUCT_CATEGORY_MISSING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item is missing google_product_category.
        PRODUCT_CATEGORY_DEPTH_WARNING:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item only has 1 or 2 levels of google_product_category value, which may limit visibility in recommendations, search results and shopping experiences.
        PRODUCT_TYPE_LENGTH_TOO_LONG:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a product_type value that is too long, this item will be published without that product type.
        SALES_PRICE_INVALID:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has an incorrectly formatted sales price.
        SALES_PRICE_TOO_LOW:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a sale price value that is discounted very low compared to the price.
        SALES_PRICE_TOO_HIGH:
          $ref: '#/components/schemas/CatalogsItemValidationDetails'
          description: Item has a sale price value that is higher than the original price of the item.
        SALE_DATE_INVALID:
          $ref: '#/components/sc

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