Menu
Alexa Web Information Service
Developer Guide

The UrlInfo action provides information about a website.

To learn more about Alexa traffic data please see this explanation on the Alexa website

Request Parameters

The UrlInfo Action takes the following parameters. Required parameters must be provided for the request to succeed.

Name Description Required
Action

UrlInfo

Yes
Url

Any valid URL.

Yes
ResponseGroup

Any valid response group. See the Response Groups section below for valid options.

Yes

Response Groups

By specifying one or more response groups when making the request, you can retrieve only the information you are interested in.

Response Group Data Returned
Categories

Up to 3 categories the site belongs to

Rank

The Alexa three month average traffic rank

RankByCountry

Percentage of viewers, page views, and traffic rank broken out by country

UsageStats

Usage statistics such as reach and page views

AdultContent

Whether the site is likely to contain adult content ('yes' or 'no')

Speed

Median load time and percent of known sites that are slower

Language

Content language code and character-encoding (note that this may not match the language or character encoding of any given page on the website because the languange and character set returned are those of the majority of pages)

OwnedDomains

Other domains owned by the same owner as this site

LinksInCount

A count of links pointing in to this site

SiteData

Title, description, and date the site was created

Meta-Response Groups

For convenience, the following meta-response groups are also available, which group together several similar response groups from the table above:

Response Group Data Returned
TrafficData

Traffic rank and usage statistics (equivalent to ResponseGroup=Rank,UsageStats)

ContentData

Information about the site's content (equivalent to ResponseGroup=SiteData,AdultContent,Popups,Speed,Language)

Sample Request

The following example shows a query-style request and response.

Request

https://awis.amazonaws.com/api?
      Action=UrlInfo
      &Url=[Valid URL]
      &ResponseGroup=[Valid Response Group]
  

Headers

Authorization: AWS4-HMAC-SHA256 Credential=<IAM_ACCESS_KEY>/20171114/us-west-1/awis/aws4_request, SignedHeaders=host;x-amz-date, Signature=<GENERATED_AUTH_V4_SIGNATURE>
Content-Type: application/xml
X-Amz-Date: 20171114T190104Z
Accept: application/xml
  

Response

<aws:UrlInfoResponse xmlns:aws="http://alexa.amazonaws.com/doc/2005-10-05/">
<aws:Response xmlns:aws="http://awis.amazonaws.com/doc/2005-07-11">
<aws:OperationRequest>
<aws:RequestId>5486794a-0d03-4d47-a45b-e95764c3f0ee</aws:RequestId><
/aws:OperationRequest>
<aws:UrlInfoResult>
<aws:Alexa>

<aws:ContentData>
<aws:DataUrl type="canonical">yahoo.com/</aws:DataUrl>
<aws:Asin>B00006D2TC</aws:Asin>
<aws:SiteData>
<aws:Title>Yahoo!</aws:Title>
<aws:Description>Personalized content and search options. Chatrooms, free e-mail, clubs, and pager.</aws:Description>
<aws:OnlineSince>18-Jan-1995</aws:OnlineSince>
</aws:SiteData>
<aws:Speed>
<aws:MedianLoadTime>2242</aws:MedianLoadTime>
<aws:Percentile>51</aws:Percentile>
</aws:Speed>
<aws:AdultContent>no</aws:AdultContent>
<aws:Language>
<aws:Locale>en</aws:Locale>
</aws:Language>
<aws:LinksInCount>76894</aws:LinksInCount>
<aws:OwnedDomains>
<aws:OwnedDomain>
  <aws:Domain>yahooligans.com</aws:Domain>
  <aws:Title>yahooligans.com</aws:Title>
</aws:OwnedDomain>
</aws:OwnedDomains>
</aws:ContentData>

<aws:TrafficData>
<aws:DataUrl type="canonical">yahoo.com/</aws:DataUrl>
<aws:Asin>B00006D2TC</aws:Asin>
<aws:Rank>1</aws:Rank>
<aws:UsageStatistics>

<aws:UsageStatistic>
  <aws:TimeRange>
    <aws:Days>1</aws:Days>
  </aws:TimeRange>
  <aws:Rank>
    <aws:Value>1</aws:Value>
    <aws:Delta>+0</aws:Delta>
  </aws:Rank>
  <aws:Reach>
    <aws:Rank>
      <aws:Value>2</aws:Value>
      <aws:Delta>+0</aws:Delta>
    </aws:Rank>
    <aws:PerMillion>
      <aws:Value>252,500</aws:Value>
      <aws:Delta>-1%</aws:Delta>
    </aws:PerMillion>
  </aws:Reach>
  <aws:PageViews>
    <aws:PerMillion>
      <aws:Value>51,400</aws:Value>
      <aws:Delta>-1%</aws:Delta>
    </aws:PerMillion>
    <aws:Rank>
      <aws:Value>1</aws:Value>
      <aws:Delta>+0</aws:Delta>
    </aws:Rank>
    <aws:PerUser>
      <aws:Value>13.7</aws:Value>
      <aws:Delta>-1%</aws:Delta>
    </aws:PerUser>
  </aws:PageViews>
</aws:UsageStatistic>

</aws:UsageStatistics>
</aws:TrafficData>

</aws:Alexa>
</aws:UrlInfoResult>
<aws:ResponseStatus xmlns:aws="http://alexa.amazonaws.com/doc/2005-10-05/">
<aws:StatusCode>Success</aws:StatusCode>
</aws:ResponseStatus>
</aws:Response>
</aws:UrlInfoResponse>