Skip to content

Developer Platform

Search docs & API
Log in
Sign up

Trends

Overview

Trends on Pinterest allows your business to quickly understand what is trending with your audience and ensure every campaign is aligned to creative and targeting that match real-time Pinner interests to increase performance.
The new Pinterest API for Trends & Insights allows agencies, Enterprise clients, and partner platforms to integrate Trends into their own systems to better inform their creative, campaigns, targeting, and more.
The Trends API offers some of the features and functionality seen today at trends.pinterest.com so that developers can ingest and utilize trends data in their own systems.

API Availability

The API is limited in scope, and does not offer the full suite of features and functionality seen on trends.pinterest.com to-date. The API will return up to 50 results for any of the single or combination filters/API calls to the endpoints listed above. At this time, users are not able to retrieve trends for past dates. API data is returned for today's date only.

How it Works

The primary endpoint for the Pinterest Trends API is the
GET
List trending keywords
endpoint.

Request

In the call to the endpoint, you must pass in
trend_type
and
region
and can pass in various other parameters to filter the resulting keywords including
interests
genders
ages
. See the
GET
List trending keywords
for details on what parameter values are accepted.

Response

The response will show you the top trending keywords for the specified trend type in the requested region. Results are ordered, with the first element in the array representing the #1 top trend.
For each keyword, the response will include
pct_growth_wow
pct_growth_mom
pct_growth_yoy
which reflects the percent growth in search volume for the keyword week over week, month over month, and year over year respectively. The growth rates are rounded, with a maximum of +/- 10000% change. For example, a value of 10001 indicates that this keyword experienced > 10000% growth over the time period.
The response also includes
time_series
which is a sequence of weekly observations of the relative search volume for this keyword over the past year. These values are normalized to a [0-100] range, and can be used to visualize the history of user interest in this keyword. By default, normalization is applied independently to the time series of each keyword, but the normalize_against_group query parameter can be used in cases where you wish to compare relative volume between keywords.
Note: The date of each observation is in ISO-8601 format and represents the end of the week. For example, a value of 2023-10-31 would include searches that happened between 2023-10-25 and 2023-10-31.

Example Request/Response

Sample Request

In this request, we query for one trending keyword in the
US
region (
region
parameter) that is
growing
(
trend_type
parameter).
curl --location 'https://api.pinterest.com/v5/trends/keywords/US/top/growing?limit=1'

Sample Response

We see that the trending keyword that matches our request is "summer nails" with various percent growths and relative weekly search volume over the last year.
{
  "trends": [
    {
      "keyword": "summer nails",
      "pct_growth_wow": 30,
      "pct_growth_mom": 100,
      "pct_growth_yoy": 10,
      "time_series": {
        "2023-05-15": 71,
        "2023-05-22": 87,
        "2023-05-29": 95,
        "2023-06-05": 100,
        "2023-06-12": 91,
        "2023-06-19": 85,
        "2023-06-26": 82,
        "2023-07-03": 79,
        "2023-07-10": 70,
        "2023-07-17": 62,
        "2023-07-24": 51,
        "2023-07-31": 43,
        "2023-08-07": 32,
        "2023-08-14": 26,
        "2023-08-21": 19,
        "2023-08-28": 12,
        "2023-09-04": 7,
        "2023-09-11": 4,
        "2023-09-18": 3,
        "2023-09-25": 2,
        "2023-10-02": 2,
        "2023-10-09": 3,
        "2023-10-16": 2,
        "2023-10-23": 2,
        "2023-10-30": 2,
        "2023-11-06": 2,
        "2023-11-13": 2,
        "2023-11-20": 2,
        "2023-11-27": 2,
        "2023-12-04": 2,
        "2023-12-11": 2,
        "2023-12-18": 3,
        "2023-12-25": 2,
        "2024-01-01": 3,
        "2024-01-08": 4,
        "2024-01-15": 4,
        "2024-01-22": 4,
        "2024-01-29": 5,
        "2024-02-05": 5,
        "2024-02-12": 6,
        "2024-02-19": 7,
        "2024-02-26": 12,
        "2024-03-04": 12,
        "2024-03-11": 14,
        "2024-03-18": 18,
        "2024-03-25": 20,
        "2024-04-01": 20,
        "2024-04-08": 27,
        "2024-04-15": 30,
        "2024-04-22": 35,
        "2024-04-29": 42,
        "2024-05-06": 61
      }
    }
  ]
}
Was this page helpful?