Prev		Next

SitesLinkingIn

Description

The Sites Linking In 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. The data is updated once every two months.

Request Parameters

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

Name	Description	Required
`Action`	Set the `Action` parameter to `SitesLinkingIn` to get a list of sites linking in to the specified site.	yes
`Url`	Any valid URL. The URL parameter specifies the URL, host or domain about which you would like to receive information.	Yes
`ResponseGroup`	`SitesLinkingIn` is the only available response group.	Yes
`Count`	Number of results (maximum) 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
`Version`	Pass in the current version number, 2005-07-11, to ensure that requests succeed even if the API changes in future versions.	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]
&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>