v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

keywords

Get country's keyword metrics

See keyword metrics for a specified country, aggregated across all of Pinterest. (Definitions are available from the "Get delivery metrics definitions" API endpoint).

get/ad_accounts/{ad_account_id}/keywords/metrics

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Query parameters

country_codestring required

Two letter country code (ISO 3166-1 alpha-2)

keywordsstring[] required

Comma-separated keywords

Response

The request has succeeded.

Example response

{
  "data": [
    {
      "keyword": "animals",
      "metrics": {
        "keyword_query_volume": "5M+"
      }
    }
  ]
}