Sign in
trends

Get featured topics

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

get/trends/topics/featured

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

Changed in 2 of the 29 revisions of this API.16

  • v5b698c180678a15See the full diff
    • ▲

      the response property items/trends/items/percent_growth_mom became optional for the status 200

      response-property-became-optional

    • ○

      api tag trends added

      api-tag-added

    • ○

      api tag product_categories removed

      api-tag-removed

    • ○

      added the optional property items/trends/items/pins/items/vertical_offset to the response with the 200 status

      response-optional-property-added

    • ○

      added the required property items/trends/items/id to the response with the 200 status

      response-required-property-added

    • ○

      added the required property items/trends/items/pins/items/color to the response with the 200 status

      response-required-property-added

    This revision also has 182 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • v5537bde5a50b11See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog