pinterest_get_keyword_intelligence

Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms.

Read assigned targeting keywords, Pinterest country-level keyword metrics, suggested terms, or related terms. Country metrics accept up to 2,000 keywords per request.

Source: Pinterest Ads
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

Name	Type	Required	Notes
`adAccountId`	string	Optional	Owning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
`mode`	string	Required	Operation or analysis mode. Only the values declared in this schema are supported. One of: `ASSIGNED`, `COUNTRY_METRICS`, `SUGGESTED`, `RELATED`.
`campaignId`	string	Optional	Exact campaign ID in the selected advertising account.
`adGroupId`	string	Optional	Exact ad group ID in the selected advertising account.
`adGroupIds`	array	Optional	Restrict results to these ad group IDs.
`matchTypes`	array	Optional	Keyword match types included in the lookup.
`countryCode`	string	Optional	Country code used to localize keyword or targeting results.
`keywords`	array	Optional	Keyword phrases to analyze; use the language and market of the intended audience.
`term`	string	Optional	Search term used for the keyword lookup.
`terms`	array	Optional	Search terms used for the keyword lookup.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `4`.
`pageSize`	integer	Optional	Maximum items requested per page. Follow the returned pagination information for remaining results. Default: `100`.
`bookmark`	string	Optional	Opaque Pinterest pagination bookmark returned by the previous response. Omit on the first request.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_get_keyword_intelligence",
    "args": {
      "mode": "ASSIGNED"
    }
  }
}