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

`indexeddomains` Поиск поддоменов сайта, проиндексированных Яндексом

Собирает поддомены домена, которые есть в индексе Яндекса, — по операторам url: и rhost: поисковой выдачи. Метод синхронный: список приходит в ответе на тот же запрос. То же в интерфейсе — Поиск проиндексированных поддоменов.

Режим: синхронный, ответ до нескольких минут
Регион: Россия (lr=225), не меняется
Лимиты: нужен положительный остаток; за вызов не списываются

Список поддоменов

GET /api/indexeddomains

Домен можно передать с протоколом и путём — берётся только имя хоста без www.. Ищутся поддомены именно этого хоста: для pixelplus.ru — все *.pixelplus.ru, для tools.pixelplus.ru — только *.tools.pixelplus.ru.

Параметры query

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

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

Домен, для которого ищем поддомены. Можно передать в query или в теле POST.

Ответ

domain string

Домен, по которому шёл поиск, в нижнем регистре.
domains object

Найденные хосты со схемой: "https://spb.pixelplus.ru". Отсортированы по алфавиту; ключи — порядковые номера, но идут не подряд, поэтому это объект, а не массив. Кириллические домены — в читаемом виде, не punycode.
count int

Сколько хостов найдено.
not_in_index bool

Есть, только если Яндекс ничего не нашёл по самому домену — true.

GET /api/indexeddomains

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

<?php
$url = 'https://tools.pixelplus.ru/api/indexeddomains?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'domain' => 'pixelplus.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/indexeddomains",
    params={
        "key": "ВАШ_КЛЮЧ",
        "domain": "pixelplus.ru",
    },
    timeout=60,
)
print(response.json())

domain обязательный Домен, для которого ищем поддомены

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

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

{
    "domain": "pixelplus.ru",
    "domains": {
        "3": "https://ekb.pixelplus.ru",
        "0": "https://pixelplus.ru",
        "2": "https://spb.pixelplus.ru",
        "1": "https://tools.pixelplus.ru"
    },
    "count": 4
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `domain`. Имя параметра приходит ключом ответа, HTTP-код `200`.
`-1`	`Access denied`	Не передан `key`. HTTP `404`.
`-2`	`Access denied`	Ключ не найден. HTTP `403`.
`-68, -80…-83`	`Not enough … limits`	Лимиты исчерпаны: дневные (`-68`), часовые (`-80`), недельные (`-81`), месячные (`-82`), годовые (`-83`). В ответе также `available` и `need`.

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

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

Яндекс отдаёт не больше 100 результатов на страницу, поэтому метод делает несколько десятков запросов к выдаче и ждёт их параллельно — ответ может идти до нескольких минут. Ставьте таймаут HTTP-клиента с запасом, не меньше 5 минут.