Инструменты · key

`poiskzerkal` Зеркала домена и их коды ответа

Находит зеркала домена — по редиректам с самого сайта и по внешним базам — и проверяет код ответа сервера у каждого. Метод синхронный: ответ приходит, когда все зеркала проверены. Тот же инструмент в интерфейсе — Поиск зеркал сайта.

Стоимость: лимиты не списываются, но на аккаунте должен быть хотя бы 1 лимит
Режим: синхронный
Зеркал в ответе: до 50
Кэш: 21 день

Поиск зеркал

GET /api/poiskzerkal

Домен приводится к основному: протокол, путь и www. отбрасываются, поддомены — тоже, то есть для shop.example.ru ищутся зеркала example.ru. Кириллические домены можно передавать как есть.

Параметры query

key string обязательный

Ключ API из настроек аккаунта.
domain string обязательный

Домен или адрес сайта.

Ответ

Зеркала приходят дважды: под числовыми ключами "0", "1"… в корне объекта и тем же списком в mirrors — читайте mirrors. Если зеркал не нашлось, в mirrors приходит null.

mirrors array

Найденные зеркала.
Вложенные поля
- url string
  
  Зеркало без протокола и завершающего слэша.
- code int
  
  HTTP-код ответа зеркала; 0 или 500 — сайт не ответил.
- input_url, length, redirect mixed
  
  Только при свежей проверке, не из кэша: проверенный адрес, размер ответа в КБ, адрес редиректа.
user_domain string

Домен, для которого шёл поиск, — после приведения.
limitExceeded bool

true — зеркал больше, чем вошло в ответ (больше 50 или источник отдал не все).

GET /api/poiskzerkal

curl -G 'https://tools.pixelplus.ru/api/poiskzerkal' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'domain=example.ru'

<?php
$url = 'https://tools.pixelplus.ru/api/poiskzerkal?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'domain' => 'example.ru',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/poiskzerkal",
    params={
        "key": "ВАШ_КЛЮЧ",
        "domain": "example.ru",
    },
    timeout=60,
)
print(response.json())

domain обязательный Домен или адрес сайта

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "0": {
        "url": "example.com",
        "code": "301"
    },
    "1": {
        "url": "www.example.ru",
        "code": "200"
    },
    "mirrors": [
        {
            "url": "example.com",
            "code": "301"
        },
        {
            "url": "www.example.ru",
            "code": "200"
        }
    ],
    "user_domain": "example.ru",
    "limitExceeded": "0"
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `domain`.
`-68`	`Not enough daily limits`	На аккаунте не осталось лимитов. Для тарифов с ограничением по периодам — также `-80` (час), `-81` (неделя), `-82` (месяц), `-83` (год).
`-1`	`Access denied`	Не передан `key`. HTTP-код 404.
`-2`	`Access denied`	Ключ не найден. HTTP-код 403.

Ответ с ошибкой

{
    "domain": "Not set",
    "code": "-50"
}

Пример выше — ответ из кэша. Результат с найденными зеркалами кэшируется на 21 день: повторный запрос по тому же домену отдаётся из кэша, коды ответа в нём — на момент первой проверки. Из кэша code и limitExceeded приходят строками ("301", "0"/"1").