# Pinterest Trends API. Trends, on request. Top, rising and seasonal searches by country. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dpinterest.top_trends) ## Pinterest Trends API at a glance Returns the searches trending on Pinterest in a country, from Pinterest Trends' top monthly, top yearly, growing and seasonal boards. Each term comes with its rank, how much it is searched against the board's top term, its weekly, monthly and yearly change, how seasonal it is and a link to its Pinterest search. Filter by interest, age, gender or keywords; with no parameters you get the US top monthly board. GET `/v1/pinterest/top_trends` [Read the API reference](https://socialtap.dev/docs/reference/pinterest/top_trends/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **8 typed fields** null when unknown - **50** top, rising and seasonal searches per page, Pinterest Trends' rank for the board (1 = top) - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get up to 50 top, rising and seasonal searches back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` [Open in playground](https://socialtap.dev/playground/?endpoint=pinterest.top_trends) cURL: ```shell curl 'https://socialtap.dev/v1/pinterest/top_trends' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.pinterest.topTrends.list({}); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ }); const res = await fetch(`https://socialtap.dev/v1/pinterest/top_trends?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/pinterest/top_trends", params={}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} req, err := http.NewRequest("GET", "https://socialtap.dev/v1/pinterest/top_trends?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [ "platform_specific.pinterest.weekly_change", "platform_specific.pinterest.monthly_change", "platform_specific.pinterest.yearly_change" ], "categories": [], "platform": "pinterest", "platform_specific": { "pinterest": { "country_code": "US", "history": [], "market_country_codes": [ "US" ], "monthly_change": -0.1, "period_end_at": "2026-11-07T00:00:00Z", "search_index": 100, "seasonality": 0.9816409, "weekly_change": 0.1, "yearly_change": 0.2 } }, "rank": 1, "term": "fall nails", "thumbnail_url": null, "unknown_fields": [ "categories", "platform_specific.pinterest.history" ], "url": "https://www.pinterest.com/search/pins/?q=fall+nails" }, { "approximate_fields": [ "platform_specific.pinterest.weekly_change", "platform_specific.pinterest.monthly_change", "platform_specific.pinterest.yearly_change" ], "categories": [], "platform": "pinterest", "platform_specific": { "pinterest": { "country_code": "US", "history": [], "market_country_codes": [ "US" ], "monthly_change": 10, "period_end_at": "2026-11-07T00:00:00Z", "search_index": 71, "seasonality": 0.98047054, "weekly_change": -0.6, "yearly_change": -0.02 } }, "rank": 2, "term": "pumpkin carving ideas", "thumbnail_url": null, "unknown_fields": [ "categories", "platform_specific.pinterest.history" ], "url": "https://www.pinterest.com/search/pins/?q=pumpkin+carving+ideas" }, { "approximate_fields": [ "platform_specific.pinterest.weekly_change", "platform_specific.pinterest.monthly_change", "platform_specific.pinterest.yearly_change" ], "categories": [], "platform": "pinterest", "platform_specific": { "pinterest": { "country_code": "US", "history": [], "market_country_codes": [ "US" ], "monthly_change": 5, "period_end_at": "2026-11-07T00:00:00Z", "search_index": 54, "seasonality": 0.9750034, "weekly_change": -0.7, "yearly_change": 0.3 } }, "rank": 3, "term": "pumpkin painting ideas", "thumbnail_url": null, "unknown_fields": [ "categories", "platform_specific.pinterest.history" ], "url": "https://www.pinterest.com/search/pins/?q=pumpkin+painting+ideas" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "pinterest", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 0, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## What you send and what comes back. The [response reference](https://socialtap.dev/docs/reference/pinterest/top_trends/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/trend/index.md). - ### Null means unknown A field Pinterest doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### No input needed Every parameter is optional: the plain request returns the default list. - ### What comes back What is trending on a platform: the searches or topics rising there, in the platform's rank order, with how they move. - **`platform`string**: Platform ID (pinterest, google, bluesky, …). - **`term`string**: The trend's words as the platform shows them, whitespace-trimmed: a search term (Pinterest, Google and Instagram, usually lowercase: pass it as query to the platform's search endpoints) or a topic's headline (Bluesky). - **`url`string**: The trend's public page on the platform: its trend page where one answers logged out (Google Trends' explore page, Instagram's page for the term, Bluesky's feed of the topic's posts), else the platform's search results for it (Pinterest). - **`rank`integer**: Position on the requested board, 1 = top; null when the answer is not a board. - **`categories`string\[\]**: Categories the platform files the trend under, as shown (not normalized), the main one first; \[\] when none (listed in unknown_fields when the source cannot see them). - **`thumbnail_url`string**: A picture the platform shows beside the trend (a Pin's on Pinterest, a news article's on Google, a post's on Instagram); null when none or not read. Platform CDN URLs can expire. - **`approximate_fields`string\[\]**: JSON paths of values rounded, bucketed or capped by the platform (Google's search volume bucket, Pinterest's rounded changes). \[\] when all exact. - **`unknown_fields`string\[\]**: JSON paths of lists whose \[\] means unknown rather than none (a source that cannot see them, such as a board's history); null already means unknown for every other field. \[\] when every list is known. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Pinterest Trends API. - ### Plan seasonal content before searches peak - ### Find rising product ideas by interest - ### Compare what each country searches on Pinterest - ### Pick keywords for pins and ads ## Good to know before you build. - Pinterest publishes its boards weekly, a few days behind: platform_specific.pinterest.period_end_at says when the figures stop. - Pinterest rounds the weekly, monthly and yearly changes to one or two significant digits, and caps them for terms that were barely searched before: each is listed in approximate_fields. - Some countries share one board with their neighbors (Ireland with Great Britain, Australia with New Zealand, Austria and Switzerland with Germany, and others); market_country_codes names the countries a board counts. - A board ends after its hundredth term: Pinterest serves no more, and page.end_reason says platform_limit. - categories is filled when you filter by category; without it Pinterest does not say which interests a term belongs to, so it is \[\] and listed in unknown_fields. - platform_specific.pinterest.history, a year of weekly search popularity, is filled only on a first page read from Pinterest's default board (the fallback when its filtered board fails), which then lacks the search index, yearly change and seasonality, and whose weekly and monthly changes Pinterest rounds apart, so one can differ by a rounding step from the filtered board's (-0.2 against -0.1); otherwise history is \[\] and listed in unknown_fields. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/pinterest/top_trends/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Pinterest Trends API. More in the [API reference](https://socialtap.dev/docs/reference/pinterest/top_trends/index.md). **How much does the Pinterest Trends API cost?** A page of up to 50 top, rising and seasonal searches costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. More Pinterest ## Pinterest API. 10 endpoints, one key. - [Pinterest Pin API](https://socialtap.dev/apis/pinterest/pin/index.md) (1 credit · `GET /v1/pinterest/pin`) - [Pinterest Search API](https://socialtap.dev/apis/pinterest/search_pins/index.md) (1 credit / page · `GET /v1/pinterest/search_pins`) - [Pinterest Board Pins API](https://socialtap.dev/apis/pinterest/board_pins/index.md) (1 credit / page · `GET /v1/pinterest/board_pins`) - [Pinterest Profile Pins API](https://socialtap.dev/apis/pinterest/pins/index.md) (1 credit / page · `GET /v1/pinterest/pins`) - [Pinterest Profile API](https://socialtap.dev/apis/pinterest/profile/index.md) (1 credit · `GET /v1/pinterest/profile`) - [Pinterest Board API](https://socialtap.dev/apis/pinterest/board/index.md) (1 credit · `GET /v1/pinterest/board`) - [Pinterest Boards API](https://socialtap.dev/apis/pinterest/boards/index.md) (1 credit / page · `GET /v1/pinterest/boards`) - [Pinterest Topic API](https://socialtap.dev/apis/pinterest/topic/index.md) (1 credit · `GET /v1/pinterest/topic`) - [Pinterest URL Save Count API](https://socialtap.dev/apis/pinterest/web_page/index.md) (1 credit · `GET /v1/pinterest/web_page`) ## See what's on the list right now. Run it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/pinterest/top_trends/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)