Review Rating Distribution of Web Pages Citing a Keyword

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The keyword, phrase or brand name to find citations of."
    },
    "positive_connotation_threshold": {
      "enum": [
        0
      ],
      "type": "number",
      "default": 0,
      "description": "The minimum positive-connotation score a citation needs to count as positive; only 0, the default, is offered."
    },
    "sentiments_connotation_threshold": {
      "enum": [
        0
      ],
      "type": "number",
      "default": 0,
      "description": "The minimum emotion score a citation needs to count toward an emotion; only 0, the default, is offered."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "max": {
            "type": "number",
            "description": "The band's upper rating bound, from 0 to 1."
          },
          "min": {
            "type": "number",
            "description": "The band's lower rating bound, from 0 to 1."
          },
          "metrics": {
            "type": "object",
            "properties": {
              "top_domains": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "number",
                      "description": "How many citations in this band come from that domain."
                    },
                    "domain": {
                      "type": "string",
                      "description": "The citing website's domain."
                    }
                  }
                },
                "description": "The website domain with the most citations in this band."
              },
              "total_count": {
                "type": "number",
                "description": "How many citations of the keyword have a rating in this band."
              },
              "connotation_types": {
                "type": "object",
                "properties": {
                  "neutral": {
                    "type": "number"
                  },
                  "negative": {
                    "type": "number"
                  },
                  "positive": {
                    "type": "number"
                  }
                },
                "description": "Citations in this band with a positive, negative or neutral connotation. These need not add up to total_count."
              },
              "sentiment_connotations": {
                "type": "object",
                "properties": {
                  "fun": {
                    "type": "number"
                  },
                  "love": {
                    "type": "number"
                  },
                  "anger": {
                    "type": "number"
                  },
                  "share": {
                    "type": "number"
                  },
                  "sadness": {
                    "type": "number"
                  },
                  "happiness": {
                    "type": "number"
                  }
                },
                "description": "Citations in this band that carry each emotion."
              }
            }
          }
        }
      }
    }
  },
  "description": "The rating bands, one entry per band."
}