Move topSites API out of experimental

chrome/common/extensions/api/history.json

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 [
   {
     "namespace": "history",
     "types": [
       {
         "id": "HistoryItem",
@@ skipping 16 matching lines @@
           "id": {"type": "string", "minimum": 0, "description": "The unique identifier for the item."},
           "visitId": {"type": "string", "description": "The unique identifier for this visit."},
           "visitTime": {"type": "number", "optional": true, "description": "When this visit occurred, represented in milliseconds since the epoch."},
           "referringVisitId": {"type": "string", "description": "The visit ID of the referrer."},
           "transition": {
             "type": "string",
             "enum": ["link", "typed", "auto_bookmark", "auto_subframe", "manual_subframe", "generated", "start_page", "form_submit", "reload", "keyword", "keyword_generated"],
             "description": "The <a href='#transition_types'>transition type</a> for this visit from its referrer."
           }
         }
+      },
+      {
+        "id": "MostVisitedURL",
+        "type": "object",
+        "description": "An object encapsulating a most visited URL, such as the URLs on the new tab page.",
+        "properties": {
+          "url": {"type": "string", "description": "The most visited URL."},
+          "title": {"type": "string", "description": "The title of the page"},
+          "redirects": {"type": "array", "items": { "type": "string" }, "description": "The redirect history of the URL."}
+        }
       }
     ],
     "functions": [
       {
         "name": "search",
         "type": "function",
         "description": "Searches the history for the last visit time of each page matching the query.",
         "parameters": [
           {
             "name": "query",
@@ skipping 29 matching lines @@
           {
             "name": "callback",
             "type": "function",
             "parameters": [
               { "name": "results", "type": "array", "items": { "$ref": "VisitItem"} }
             ]
           }
         ]
       },
       {
+        "name": "getMostVisited",
+        "type": "function",
+        "description": "Retrieves the N most visited history items.",
+        "parameters": [
+          {
+            "name": "details",
+            "type": "object",
+            "properties": {
+              "maxResults": {
+                "type": "integer",
+                "description": "An integer representing the number of entries you want to retreive."
+              }
+            }
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "parameters": [
+              { "name": "results", "type": "array", "items": { "$ref": "MostVisitedURL"} }
+            ]
+          }
+        ]
+      },
+      {
         "name": "addUrl",
         "type": "function",
         "description": "Adds a URL to the history at the current time with a <a href='#transition_types'>transition type</a> of \"link\".",
         "parameters": [
           {
             "name": "details",
             "type": "object",
             "properties": {
               "url": {"type": "string", "description": "The URL to add."}
             }
@@ skipping 63 matching lines @@
             "properties": {
               "allHistory": { "type": "boolean", "description": "True if all history was removed.  If true, then urls will be empty." },
               "urls": { "type": "array", "items": { "type": "string" }, "optional": true}
             }
           }
         ]
       }
     ]
   }
 ]