Endpoints
1 endpoint returns trends on Pinterest.
Schema
Every endpoint above returns an array of these objects as data, with a page object. The standard meta comes with every response.
platformstringPlatform ID (pinterest, google, bluesky, …).
termstringThe 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).
urlstring uriThe 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).
rankintegernullablePosition on the requested board, 1 = top; null when the answer is not a board.
categoriesstring[]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_urlstring urinullableA 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.
platform_specificobjectFields only this platform has, under its ID (platform_specific.<platform>); each null when unknown.
ShowHide 2 child fields
googleobjectnullableA Google Trends trend's own fields.
ShowHide 8 child fields
country_codestringnullableISO 3166-1 alpha-2 country whose searches the trend counts; null for a worldwide board.
growthnumbernullableHow much the term's searches rose since it started trending, a fraction (1 = +100 %), in Google's steps; Google caps it at 10 (+1,000 %), a lower bound then (listed in approximate_fields).
started_atstring date-timenullableWhen the term started trending, RFC 3339 UTC.
ended_atstring date-timenullableWhen it stopped trending, RFC 3339 UTC; null while it is active (is_active) or when unknown.
is_activebooleannullableStill trending: Google shows it as active (ended_at is null).
related_searchesstring[]Other searches Google groups under the trend, in its order (the term itself left out); each a term of its own. [] when none.
metricsobjectGoogle's counts for the trend; null = not shown.
ShowHide 1 child field
search_countintegernullableSearches for the term in the board's window, as the lower bound of Google's volume bucket (500 for "500+"), always approximate.
historyobject[]How much the term was searched over time, oldest first, each interval relative to the series' peak (1); [] on a board, which does not read the series (listed in unknown_fields): a trend's own endpoint fills it.
ShowHide 3 child fields
start_atstring date-timeStart of the interval (a week on Pinterest), RFC 3339 UTC.
end_atstring date-timeEnd of the interval, exclusive (the next interval's start_at), RFC 3339 UTC.
popularitynumberSearches in the interval relative to the series' peak, 0 to 1 (1 = the peak), as the platform scales them.
pinterestobjectnullableA Pinterest Trends trend's own fields.
ShowHide 9 child fields
country_codestringnullableISO 3166-1 alpha-2 country whose searches the figures count (Pinterest counts some countries together: the endpoint's notes say which).
market_country_codesstring[]Every country whose searches the figures count together, as ISO 3166-1 alpha-2 codes: ["US"] for a country Pinterest publishes a board for on its own, its group's (["GB", "IE"] for IE) for one Pinterest counts with others. [] when unknown.
search_indexintegernullableHow much the term is searched in the table's period, relative to the table's most searched term (100).
weekly_changenumbernullableChange in the term's searches over the past week, a fraction (0.3 = +30 %, -0.5 = -50 %), rounded by Pinterest to one or two significant digits (always listed in approximate_fields); capped at 100 (+10,000 %), a lower bound then.
monthly_changenumbernullableChange over the past month, a fraction like weekly_change, rounded by Pinterest the same way (always listed in approximate_fields); capped at 100, a lower bound then.
yearly_changenumbernullableChange against the same time last year, a fraction like weekly_change, rounded by Pinterest the same way (always listed in approximate_fields); capped at 100, a lower bound then.
seasonalitynumbernullableHow seasonal the term is, 0 to 1 (1 = searched at the same time every year), as Pinterest scores it.
period_end_atstring date-timenullableEnd of the period Pinterest's figures count, exclusive (midnight UTC after its weekly data's last day), RFC 3339 UTC: Pinterest publishes weekly, a few days behind.
historyobject[]How much the term was searched each week, oldest first, relative to the series' peak (1); [] on a board that does not request the series (listed in unknown_fields).
ShowHide 3 child fields
start_atstring date-timeStart of the interval (a week on Pinterest), RFC 3339 UTC.
end_atstring date-timeEnd of the interval, exclusive (the next interval's start_at), RFC 3339 UTC.
popularitynumberSearches in the interval relative to the series' peak, 0 to 1 (1 = the peak), as the platform scales them.
approximate_fieldsstring[]JSON paths of values rounded, bucketed or capped by the platform (Google's search volume bucket, Pinterest's rounded changes). [] when all exact.
unknown_fieldsstring[]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.