Menu
Alexa Web Information Service
Developer Guide

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.

Name Description Required
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

https://awis.amazonaws.com/api?
            Action=SitesLinkingIn
            &Url=[Valid URL]
            &ResponseGroup=SitesLinkingIn
            &Count=[maximum number of results]
            &Start=[number to start]
            

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

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>