Get Pinterest Trends for a country
List the top Pinterest search terms for one of 23 countries, with rank, search index and change, growing or seasonal. 100 credits per call.
To see what a market is searching for on Pinterest, call GET /v1/pinterest/trends with a country code and a type. It returns up to 50 ranked search terms from Pinterest Trends, each with a relative search index, its weekly, monthly and yearly change, a seasonality score and the date of the list. It costs 100 credits per call, whether you ask for 5 terms or 50. You need no keyword to start from.
Cost
100 credits per call, at any limit from 1 to 50. Pulling all four tables for one country costs 400 credits. Asking for the same list again within 6 hours is answered from the shared cache for 2 credits. Failed calls and empty results are free, and so is a request for an unsupported country (a 400).
Which parameters can I set?
| Parameter | Values |
|---|---|
country | AR, AU, BR, CA, CO, DE, EG, ES, FR, GB, ID, IE, IN, IT, KR, MX, MY, NZ, PH, SA, TH, TR, US, in any case. Defaults to US. |
type | Which Trends table: growing (the default), seasonal, top_monthly or top_yearly. |
limit | How many terms to return from the top, 1 to 50. Defaults to 25. |
include | Keep only terms that contain one of these keywords, comma-separated, up to 10 (for example nails,wedding). |
exclude | Drop terms that contain any of these keywords, comma-separated, up to 10 (for example fall). |
Use growing for terms picking up now, seasonal for terms that return at this time of year, and top_monthly or top_yearly for the most searched terms over a month or a year.
Make the request
curl "https://api.insightsocial.app/v1/pinterest/trends?country=US&type=growing&limit=10" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"What comes back
A real response from 2026-10-14 (country=US, type=growing, limit=10), shortened to two of the 10 terms.
{
"success": true,
"endpoint": "/v1/pinterest/trends",
"schema_version": "2",
"data": {
"items": [
{
"rank": 3,
"term": "october nails ideas 2026",
"country": "US",
"market": "US",
"type": "growing",
"search_index": 37,
"weekly_change": 0.06,
"monthly_change": 100.01,
"yearly_change": 100.01,
"seasonality": 0.32323614,
"url": "https://trends.pinterest.com/detail/?terms=october+nails+ideas+2026&country=US",
"as_of": "2026-10-05"
},
{
"rank": 6,
"term": "happy october",
"country": "US",
"market": "US",
"type": "growing",
"search_index": 39,
"weekly_change": 55,
"monthly_change": 100.01,
"yearly_change": -0.08,
"seasonality": 0.8605102,
"url": "https://trends.pinterest.com/detail/?terms=happy+october&country=US",
"as_of": "2026-10-05"
}
],
"total": 10
},
"pagination": { "next_cursor": null, "has_more": false, "page_size": 10 },
"unavailable": [],
"credits_used": 100
}| Field | What it holds |
|---|---|
rank | The term's position in the table. |
term | The search term. |
market | Which Pinterest list the term came from. It can differ from country: IE reads the GB+IE list, AU and NZ read the AU+NZ list. |
search_index | Pinterest's relative search index for the term. In this response the highest value is 100. |
weekly_change, monthly_change, yearly_change | The change Pinterest reports for the term over each period. |
seasonality | Pinterest's seasonality score. Here the October greetings score about 0.86 to 0.88; most other terms score about 0.32. |
url | The term's page on Pinterest Trends. |
as_of | The date of the Trends list. |
What are the limits?
- 23 countries. Pinterest publishes no list for other countries; asking for one returns a free 400.
- Shared lists.
IEreturns Pinterest's GB+IE list andAUandNZreturn the AU+NZ list.GBalone has its own list. - 50 terms at most.
limitgoes from 1 to 50. The endpoint does not paginate. - Not real time. The list is dated: the response captured on 2026-10-14 carried
as_of: "2026-10-05". - Read the change fields with care. No unit is documented, and in the sample most growing terms show the same
monthly_changeof 100.01. Compare terms byrankandsearch_indexfirst.
What can I build with it?
- Content calendars. Pull the
seasonaltable each week and plan pins and blog posts around the terms that are coming back. - Product and niche research. Filter with
include(for examplenails,wedding) to watch only the terms in your category, across several countries. - Trend alerts. Store the
growingtable daily and flag terms that enter it or climb inrank.
Related
GET /v1/pinterest/trendsreference: every parameter and field.GET /v1/pinterest/search: the pins behind a trending term.- Pinterest endpoints: everything the API covers on Pinterest.
Search Reddit comments by keyword
Search comments across all of Reddit by keyword, author or subreddit, each with its post title, subreddit and score. 10 credits per page.
Get Pinterest save counts for any URL
See how many times up to 10 web pages have been saved to Pinterest through the Save button, in one call. 10 credits per call.