Top Paid Search Keyword for a Site Section (US, Highest Traffic Share)

{
  "type": "object",
  "required": [
    "subfolder"
  ],
  "properties": {
    "database": {
      "enum": [
        "us"
      ],
      "type": "string",
      "default": "us",
      "description": "Regional search database. Only the US database is offered."
    },
    "subfolder": {
      "type": "string",
      "minLength": 1,
      "description": "The site section to look up: a domain followed by a path, without a scheme, including the trailing slash."
    },
    "display_sort": {
      "enum": [
        "tr_desc"
      ],
      "type": "string",
      "default": "tr_desc",
      "description": "Row order: by share of the subfolder's paid traffic, highest first. The only value offered."
    },
    "display_limit": {
      "enum": [
        1
      ],
      "type": "integer",
      "default": 1,
      "description": "Number of rows to return. Fixed at 1."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cpc": {
            "type": "string",
            "description": "Average cost per click for the keyword, as a string with no currency sign."
          },
          "trends": {
            "type": "string",
            "description": "The keyword's search-interest trend: 12 comma-separated relative values from 0 to 1."
          },
          "keyword": {
            "type": "string",
            "description": "The search term the subfolder's Google ad appears for."
          },
          "position": {
            "type": "string",
            "description": "The ad's current position for the keyword, as a string."
          },
          "competition": {
            "type": "string",
            "description": "Advertiser competition for the keyword, from 0 to 1, as a string."
          },
          "searchVolume": {
            "type": "string",
            "description": "Average monthly searches for the keyword, as a string."
          },
          "trafficPercent": {
            "type": "string",
            "description": "The keyword's share of the subfolder's estimated paid-search traffic, in percent, as a string."
          },
          "previousPosition": {
            "type": "string",
            "description": "The ad's previous position for the keyword, as a string."
          },
          "positionDifference": {
            "type": "string",
            "description": "Change between the previous and current position, as a string."
          },
          "trafficCostPercent": {
            "type": "string",
            "description": "The keyword's share of the subfolder's estimated paid-traffic cost, in percent, as a string."
          }
        }
      },
      "description": "At most one row."
    },
    "database": {
      "type": "string",
      "description": "The regional search database the row comes from (us)."
    }
  },
  "description": "The subfolder's top paid search keyword in the US database, as returned after shaping."
}