UrlInfo Operation

Description

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

Sample Request | Parameters

Sample Request

Using URL Information Operation

The following UrlInfo example demonstrates how to make a REST request.

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

For more information on making signed requests, see AWS Request Authentication

Request Parameters

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

Name Description Type Value
Operation

Use the Operation parameter to specify the name of the operation you would like to call. To access the UrlInfo operation, set the Operation parameter to UrlInfo.

Required UrlInfo
Url

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

Required

Any valid URL

ResponseGroup

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

Required

Comma-separated list of response groups.

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
RelatedLinks

Returns up to 11 related links for the specified URL.

Categories

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

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'

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 location of users who visit the site.

UsageStats

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

TrafficData

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

ContactInfo

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

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 URL

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.

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.'