PIpinterest
trends

Get featured topics

Changed on

Enables advertisers to pull top five trending topics by interest and market, at full parity with the Pinterest Trends UI.

get/trends/topics/featured

Request

  • Base URL
    https://api.pinterest.com/v5
  • Auth
    • OAuth 2
      Authorization codehttps://www.pinterest.com/oauth/
      Token URLhttps://api.pinterest.com/v5/oauth/token
      Scopesuser_accounts:read
    • or OAuth 2
      Client credentials
      Token URLhttps://api.pinterest.com/v3/oauth/access_token/
      Scopesuser_accounts:read
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

interest'ALL' | 'ANIMALS' | 'ARCHITECTURE' | 'ART' | 'BEAUTY' | 'DIY_AND_CRAFTS' | 'EDUCATION' | 'EVENT_PLANNING' | 'FASHION' | 'FOOD_AND_DRINKS' | 'GARDENING' | 'HEALTH' | 'HOME_DECOR' | 'PARENTING' | 'TRAVEL' | 'WEDDING'

Interest to filter by

region'US' | 'GB+IE' | 'CA' required
 The geographic region of interest. Only top product categories within the specified region will be returned.
 The `region` parameter is formatted as ISO 3166-2 country codes delimited by `+`.

- `US` - United States
- `GB+IE` - Great Britain & Ireland
- `CA` - Canada

Response

The request has succeeded.

interest'ALL' | 'ANIMALS' | 'ARCHITECTURE' | 'ART' | 'BEAUTY' | 'DIY_AND_CRAFTS' | 'EDUCATION' | 'EVENT_PLANNING' | 'FASHION' | 'FOOD_AND_DRINKS' | 'GARDENING' | 'HEALTH' | 'HOME_DECOR' | 'PARENTING' | 'TRAVEL' | 'WEDDING' required
market'US' | 'GB+IE' | 'CA'

Changes

  • v5b698c180678aRevision changes
    • breaking

      the response property /// became optional for the status

    • info

      api tag trends added

    • info

      api tag product_categories removed

    • info

      added the optional property ///// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property ///// to the response with the status

  • v5537bde5a50b1Revision changes
    • info

      endpoint added