Prev

UrlInfo

Description

The URL Information Action provides information about websites. Examples of this information may include data on how popular a site is, sites that are related, and contact information for the owner of a site.

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.

NameDescriptionRequired
Action

Set the Action parameter to UrlInfo to get information about the specified URL.

Yes
Url

Any valid URL. The URL parameter specifies the URL, host or domain about which you would like to receive information.

Yes
ResponseGroup

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

Yes
Version Pass in the current version number, 2005-07-11, to ensure that requests succeed even if the API changes in future versions.No

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 GroupDescription
RelatedLinks

Returns up to 11 related links for the specified site or web page.

Categories

Returns up to 3 DMOZ (Open Directory) categories for the specified site.

Rank

Returns the Alexa three month average traffic rank for the given site.

RankByCountry

Shows percentage of viewers, page views, and traffic rank based on the country of users who visit the site.

RankByCity

Shows percentage of viewers, page views, and traffic rank based on the city of users who visit the site.

UsageStats

Returns Usage Statistics, such as Reach and PageView information) for the given site

ContactInfo

Returns information about the site owner or registrar of the given site.

AdultContent

Returns 'no' if the site is unlikely to contain adult content and 'yes' if it is likely to contain adult content.

Speed

Returns the median load time and percent of known sites that are slower.

Language

Returns content language code and character-encoding for the given website. 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 on the site.

Keywords

Returns a list of keywords that identify concepts or content on this site.

OwnedDomains

Returns a list of other domain names that are owned by the same owner as this site.

LinksInCount

Return a count of links pointing in to this site.

SiteData

Returns the Title, Description, and the date created for this site.

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

Response GroupDescription
Related

Returns up to 11 related links and up to 3 DMOZ categories. This is a meta-group, the equivalent of using response groups 'RelatedLinks,Categories'

TrafficData

Returns Traffic Rank and Usage Statistics for the given site. This is a meta-group, the equivalent of using response groups 'Rank,UsageStats.'

ContentData

Returns information specific to a site's page content of a given URL. This is a meta-group, the equivalent of using response groups 'SiteData,AdultContent,Popups,Speed,Language.'

Sample Request

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

http://awis.amazonaws.com?
Action=UrlInfo
&AWSAccessKeyId=[Your AWS Access Key ID]
&Signature=[signature]
&Timestamp=[timestamp used in signature]
&Url=[Valid URL]
&ResponseGroup=[Valid Response Group]

<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:Keywords>
      <aws:Keyword>On the Web</aws:Keyword>
    </aws:Keywords>
    <aws:OwnedDomains>
      <aws:OwnedDomain>
        <aws:Domain>yahooligans.com</aws:Domain>
        <aws:Title>yahooligans.com</aws:Title>
      </aws:OwnedDomain>
    </aws:OwnedDomains>
  </aws:ContentData>
  
  <aws:Related>
    <aws:DataUrl type="canonical">yahoo.com/</aws:DataUrl>
    <aws:Asin>B00006D2TC</aws:Asin>
    <aws:RelatedLinks>
      <aws:RelatedLink>
        <aws:DataUrl type="canonical">aol.com/</aws:DataUrl>
        <aws:NavigableUrl>http://aol.com/</aws:NavigableUrl>
        <aws:Asin>B00006ARD3</aws:Asin>
        <aws:Relevance>301</aws:Relevance>
      </aws:RelatedLink>
    </aws:RelatedLinks>
    <aws:Categories>
      <aws:CategoryData>
        <aws:Title>On the Web/Web Portals</aws:Title>
        <aws:AbsolutePath>Top/Computers/Internet/On_the_Web/Web_Portals</aws:AbsolutePath>
      </aws:CategoryData>
    </aws:Categories>
  </aws:Related>        
        
  <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>
Prev Copyright Information