Skip to content
Get MCP AdsGet MCP Ads, home

pinterest_get_trends

Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured…

Read Pinterest Trends: top growing/monthly/yearly/seasonal keywords by supported region, growing product categories, product-category details, featured topics, or editorial articles.

Kind
Read
Discovery
Reachable through search_tools and run_tool
Account parameter
adAccountId
Endpoint
https://mcp.getmcpads.com/pinterest-ads/mcp

ParametersLink to this section

NameTypeRequiredNotes
modestringRequiredOperation or analysis mode. Only the values declared in this schema are supported. One of: KEYWORDS, PRODUCT_CATEGORIES, PRODUCT_CATEGORY_DETAILS, FEATURED_TOPICS, EDITORIAL_ARTICLES.
regionstringOptionalProvider region selector used to localize trends. One of: US, CA, DE, FR, ES, IT, DE+AT+CH, GB+IE, IT+ES+PT+GR+MT, PL+RO+HU+SK+CZ, SE+DK+FI+NO, NL+BE+LU, AR, BR, CO, MX, MX+AR+CO+CL, AU+NZ. Default: "FR".
productRegionstringOptionalRegion used for product trend analysis. One of: US, GB+IE, CA. Default: "US".
trendTypestringOptionalProvider trend category to return. One of: growing, monthly, yearly, seasonal. Default: "growing".
limitintegerOptionalMaximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: 50.
interestsarrayOptionalNative interest categories used to filter trends.
gendersarrayOptionalNative gender categories used to filter aggregate trends.
ageBucketsarrayOptionalNative age groups used to filter aggregate trends.
includeKeywordsarrayOptionalInclude related keyword details in the trend response.
includeDemographicsbooleanOptionalInclude available aggregate demographic breakdowns.
productCategoriesarrayOptionalNative product category IDs or values used to filter trends.
verticalsarrayOptionalNative business verticals used to filter trends.
productLookbackDaysnumberOptionalProduct-trend lookback window, in days. One of: 90, 180, 365, 730. Default: 365.
productEngagementTypestringOptionalEngagement signal used for product-trend analysis. One of: ENGAGEMENT, OUTBOUND_CLICK, SAVE. Default: "ENGAGEMENT".
featuredIntereststringOptionalFeatured interest category for the trends lookup.
queryobjectOptionalAdditional documented query parameters for the selected fixed GET endpoint.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_get_trends",
    "args": {
      "mode": "KEYWORDS"
    }
  }
}
Esc

Type to search