Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to Digg

SitesLinkingIn

Description

The SitesLinkingIn action returns a list of web sites linking to a given web site. Within each domain linking into the web site, only a single link - the one with the highest page-level traffic - is returned.

Request Parameters

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

NameDescriptionRequired
Action

SitesLinkingIn

Yes
Url

Any valid URL.

Yes
ResponseGroup

SitesLinkingIn is the only available response group.

Yes
Count

Maximum number of results per page to return. Note that the response document may contain fewer results than this maximum. Default value is '10' (maximum 20).

No
Start

Number of result at which to start. Used for paging through results. Default value is '0.'

No

Sample Request

The following example shows a query-style request and response

Request

http://awis.amazonaws.com/?
            Action=SitesLinkingIn
            &AWSAccessKeyId=[Your AWS Access Key ID]
            &Signature=[signature calculated from request]
            &SignatureMethod=[HmacSha1 or HmacSha256]
            &SignatureVersion=2
            &Timestamp=[timestamp used in signature]
            &Url=[Valid URL]
            &ResponseGroup=SitesLinkingIn
            &Count=[maximum number of results]
            &Start=[number to start]
            

Response

One aws:Site element is returned for each site linking in. The title and url are for the page on that site with the highest page-level traffic.

<aws:SitesLinkingInResponse 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>ca282ec6-2d08-4341-9f1d-50f8c1e3652b
      </aws:RequestId>
   </aws:OperationRequest>
<aws:SitesLinkingInResult>
<aws:Alexa>
  <aws:SitesLinkingIn>
    <aws:Site>
      <aws:Title>Google</aws:Title>
      <aws:Url>http://www.google.com:80/Top/Computers/Internet/On_the_Web/Web_Portals/</aws:Url>
    </aws:Site>
    <aws:Site>
      <aws:Title>www.fotolog.com:80/TsR_BkR_TsR</aws:Title>
      <aws:Url>http://www.fotolog.com:80/TsR_BkR_TsR</aws:Url>
    </aws:Site>
  </aws:SitesLinkingIn>
</aws:Alexa>
</aws:SitesLinkingInResult>
<aws:ResponseStatus xmlns:aws="http://alexa.amazonaws.com/doc/2005-10-05/">
   <aws:StatusCode>Success</aws:StatusCode>
</aws:ResponseStatus>
</aws:Response>
</aws:SitesLinkingInResponse>