Sign In to the Console
Alexa Web Information Service
Developer Guide
AWS Documentation » Alexa Web Information Service » Developer Guide » API Reference » Actions » UrlInfo

UrlInfo

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
ResponseGroup

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

 Yes
Url

Any valid URL.

 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
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
      &ResponseGroup=[Valid Response Group]
      &Url=[Valid URL]

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>