---
title: "Get featured topics"
method: GET
path: "/trends/topics/featured"
tags: ["trends"]
---

# Get featured topics

`GET /trends/topics/featured`

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

## 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'
- `region` 'US' | 'GB+IE' | 'CA', required

## Response `200`

The request has succeeded.

- FeaturedTrend[]
  - `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'
  - `trends` TrendingTopic[] — List of trending topics within this interest category
    - `description` string, required — Description of the trending topic
    - `id` string, required — Unique identifier for the trending topic
    - `percent_growth_mom` integer — Month-over-month growth percentage
    - `pins` TrendingPin[], required — Array of pin images related to this trend (up to 6)
      - `color` string, required — Dominant color of the pin image in hex format
      - `height` integer, required — Height of the pin image in pixels
      - `id` string, required — Unique identifier for the pin
      - `src` string, required — URL of the pin image
      - `vertical_offset` number, double — The vertical offset of the pin image as a percentage from 0 to 100, where 0 is the top of the image and 100 is the bottom.
      - `width` integer, required — Width of the pin image in pixels
    - `related_interests` string[], required — List of related interest categories
    - `related_searches` string[], required — List of related search terms
    - `time_series` object, required — Time series data showing trend values over time, with dates as keys and values as numeric
    - `title` string, required — Title of the trending topic

## Other responses

- `400` — The request could not be understood by the server due to unexpected data.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/versions/b698c180678a/schema)