The Alexa Top Sites Action provides lists of web sites ordered by Alexa Traffic Rank. A global list is available, as well as lists for individual countries.
Using Alexa Top Sites Action
The following TopSites example demonstrates how to make a Query request.
http://ats.amazonaws.com? &Action=TopSites &AWSAccessKeyId=[Your AWS Access Key ID] &Signature=[signature] &Timestamp=[timestamp used in signature] &Start=[Number to start at] &Count=[Number from 1 to 100] &ResponseGroup=[Valid Response Group]
The TopSites Action takes the following parameters. Required parameters must be provided for the request to succeed.
| Name | Description | Type | Value |
|---|---|---|---|
| Action |
Use the Action parameter to specify the name of the operation you would like to call. To access the TopSites action, set the Action parameter to TopSites. |
Required | TopSites |
| CountryCode |
Valid country code (A list of country codes is available from ListCountries ResponseGroup). A global list of top sites is returned by default. |
Optional | |
| CityCode |
Valid city code (A list of city codes is available from ListCities ResponseGroup). A global list of top sites is returned by default. |
Optional | |
| Start |
Number of result at which to start. Used for paging through results. Default value is '1'. |
Optional | Number to start at |
| Count |
Number of results (maximum) per page to return. Default value is '10'. Maximum is '100'. |
Optional | Number from 1 to 100 |
| ResponseGroup |
Any valid response group. See the Response Group section for valid options. |
Required |
Comma-separated list of response groups. |
Response groups allow the user more control over what data is returned. By specifying one or more response groups when making the request, you can retrieve only the information you are interested in.
| Response Group | Description |
|---|---|
| Country |
Return a list of top sites for a given country. |
| City |
Return a list of top sites for a given city. |
| ListCountries |
Return a list of countries that have top sites. |
| ListCities |
Return a list of cities that have top sites. |