Getting information about external links to the site
Returns examples of external links to site pages.
Request format
GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/links/external/samples
? [offset=<int32>]
& [limit=<int32>]
user-id | Type: int64. User ID. Required when calling all Yandex.Webmaster API resources. To get it, use the GET /v4/user method. |
host-id | Type: host id (string). The site ID. To get it, use the GET /v4/user/{user-id}/hosts method. |
user-id | Type: int64. User ID. Required when calling all Yandex.Webmaster API resources. To get it, use the GET /v4/user method. |
host-id | Type: host id (string). The site ID. To get it, use the GET /v4/user/{user-id}/hosts method. |
offset | Offset in the list. The minimum value is 0. Default value: 0. |
limit | Page size (1-100). Default value: 10. |
offset | Offset in the list. The minimum value is 0. Default value: 0. |
limit | Page size (1-100). Default value: 10. |
Response format
Examples
{
"count": 1,
"links": [
{
"source_url": "https://other-example.com/page/",
"destination_url": "https://example.com/page1/",
"discovery_date": "2019-01-01",
"source_last_access_date": "2019-01-01",
}, ...
]
}
<Data>
<count>1</count>
<link>
<source_url>https://other-example.com/page/</source_url>
<destination_url>https://example.com/page1/</destination_url>
<discovery_date>2019-01-01</discovery_date>
<source_last_access_date>2019-01-01</source_last_access_date>
</link>
...
</Data>
Name | Required | Type | Description |
---|---|---|---|
count | Yes | int64 | The number of example links available. |
source_url | Yes | string | The URL of the page that contains the link to the site. |
destination_url | Yes | url | The target page URL (where the link points to). |
discovery_date | Yes | Date | The date when the link was detected. |
source_last_access_date | Yes | Date | The date when the robot last visited the target page. |
Name | Required | Type | Description |
---|---|---|---|
count | Yes | int64 | The number of example links available. |
source_url | Yes | string | The URL of the page that contains the link to the site. |
destination_url | Yes | url | The target page URL (where the link points to). |
discovery_date | Yes | Date | The date when the link was detected. |
source_last_access_date | Yes | Date | The date when the robot last visited the target page. |
Response codes
To view the response structure in detail, click the reason.
Code | Reason | Description |
---|---|---|
200 | OK | |
403 | The ID of the user who issued the token differs from the one specified in the request. In the examples below, | |
404 | HOST_NOT_VERIFIED | Site management rights are not verified. |
Code | Reason | Description |
---|---|---|
200 | OK | |
403 | The ID of the user who issued the token differs from the one specified in the request. In the examples below, | |
404 | HOST_NOT_VERIFIED | Site management rights are not verified. |