Pinterest trends by country
Native Pinterest Trends rankings for 23 supported countries. Choose growing, seasonal, top_monthly or top_yearly; native include/exclude filters apply before the requested depth of 1–50. Ireland reads GB+IE, Australia/New Zealand read AU+NZ, and GB reads its own market. Each row preserves rank, relative 0–100 search index, fractional weekly/monthly/yearly changes, seasonality and the source data date. 100.01 is Pinterest’s capped near-zero-baseline change signal. Nonempty uncached results cost 10 credits; a confirmed empty ranking is uncharged 404, and errors/cache hits/idempotent replays are free. Exact repeats are cached six hours. Anonymous public source, without account credentials or an upstream availability guarantee.
limit accepts 1–50. include keeps terms containing a listed keyword, and exclude removes matching terms. Each accepts up to ten comma-separated keywords. These are native source filters applied before depth, not a filter over a previously truncated top-N page.
Supported countries: AR, AU, BR, CA, CO, DE, EG, ES, FR, GB, ID, IE, IN, IT, KR, MX, MY, NZ, PH, SA, TH, TR and US. Codes are case-insensitive. Ireland uses the combined GB+IE market; Australia and New Zealand use AU+NZ. Great Britain uses GB. country identifies the requested country and market identifies the actual source list.
Each term has its native rank, a relative search_index from 0–100, weekly_change, monthly_change, yearly_change, seasonality, a Trends link and as_of. A change of 0.3 means +30%; 100.01 is the source’s capped signal for a near-zero prior baseline, not an exact growth measurement. The index is normalized within this response and is not an absolute search count. The source’s weekly as_of date is preserved; it is not replaced with request time.
A nonempty uncached request costs 10 credits, independent of depth. Use X-Max-Credits: 10. Confirmed empty lists return uncharged 404; upstream failures also consume no customer credits. Exact repeats use a six-hour cache at zero credits, and successful idempotent replay is free. Cache-Control: no-cache requests a fresh source read.
The adapter uses Pinterest’s anonymous public Trends source, without Pinterest cookies or account credentials. Its shared request limit is ten source reads per minute. Source throttling or invalid responses fail without charging; this is not a Pinterest partner API or a guarantee of uninterrupted upstream availability.Authorizations
Headers
Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.
x >= 0Query Parameters
Case-insensitive ISO country. Default US. IE maps to GB+IE; AU and NZ map to AU+NZ. GB remains separate.
growing, seasonal, top_monthly, top_yearly 1 <= x <= 50One to ten comma-separated keywords, each at most 100 characters. Native matching occurs before the requested depth.
One to ten comma-separated keywords, each at most 100 characters. Native matching occurs before the requested depth.
Response
Native Pinterest Trends rankings for 23 supported countries. Choose growing, seasonal, top_monthly or top_yearly; native include/exclude filters apply before the requested depth of 1–50. Ireland reads GB+IE, Australia/New Zealand read AU+NZ, and GB reads its own market. Each row preserves rank, relative 0–100 search index, fractional weekly/monthly/yearly changes, seasonality and the source data date. 100.01 is Pinterest’s capped near-zero-baseline change signal. Nonempty uncached results cost 10 credits; a confirmed empty ranking is uncharged 404, and errors/cache hits/idempotent replays are free. Exact repeats are cached six hours. Anonymous public source, without account credentials or an upstream availability guarantee.
x >= 0The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.