Документация API

Ниже представлены доступные эндпоинты для получения данных из поисковых систем и Вордстата.

Содержание

Аутентификация

Все JSON методы API используют единый способ аутентификации.

Bearer Token аутентификация:

Токен должен быть передан в заголовке запроса.

Authorization: Bearer YOUR_API_TOKEN

/yandex

Получение поисковой выдачи из Яндекс.

Метод:

GET https://jsonseo.ru/api/yandex

Параметры запроса:

Стоимость запроса:

0.01₽ × количество страниц

Указывается максимальное количество страниц, которое нужно получить. Если поиск вернёт меньше страниц, чем вы запросили, списание произойдёт только за фактически полученные страницы.

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


{
    "pages": 1,
    "query": "купить ноутбук",
    "rawQuery": "купть ноутбук",
    "results": [
        {
            "url": "https://www.VZON.ru/category/noutbuki-15692/",
            "domain": "www.vzon.ru",
            "title": "Ноутбуки – купить ноутбук на VZON по низкой цене",
            "passage": "Ноутбуки – покупайте на VZON по выгодным ценам, быстрая и бесплатная доставка...",
            "breadcrumbs": "vzon.ru›Электроника›Ноутбуки, планшеты и электронные книги"
        }
    ]
}

/yandex/xml

Получение поисковой выдачи Яндекса в формате XML.

Этот эндпоинт предназначен для интеграции в приложения и может использоваться вместо сервисов XMLRiver, XMLStock, XMLProxy, XMLSeo. Готовый URL для запросов доступен в личном кабинете.

Метод:

GET https://jsonseo.ru/api/yandex/xml

Параметры запроса:

При использовании параметра page учитывайте, что количество результатов на каждой странице соответствует значению groupby. Рекомендуется вместо пагинации увеличивать groupby, чтобы получить выдачу в рамках одной сессии.

Стоимость запроса:

0.01₽ × количество страниц

Количество страниц = (количество позиций ÷ 10). Например: 100 позиций = 10 страниц = 0.1₽.

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

<?xml version="1.0" encoding="utf-8"?>
<yandexsearch version="1.0">
    <response date="20260504T120000">
        <found priority="all">128929</found>
        <found-human>128929</found-human>
        <results>
            <grouping>
                <page>0</page>
                <group id="1">
                    <doc>
                        <url>https://www.example.com/category/noutbuki/</url>
                        <domain>www.example.com</domain>
                        <title>Ноутбуки – купить ноутбук по низкой цене</title>
                        <breadcrumbs/>
                        <passages>
                            <passage>Ноутбуки – покупайте по выгодным ценам, быстрая и бесплатная доставка...</passage>
                        </passages>
                        <contenttype>organic</contenttype>
                    </doc>
                </group>
            </grouping>
        </results>
    </response>
</yandexsearch>

/google

Получение поисковой выдачи из Google (мобильная выдача google.com).

Метод:

GET https://jsonseo.ru/api/google

Параметры запроса:

Стоимость запроса:

0.01₽ × количество страниц

Указывается максимальное количество страниц, которое нужно получить. Если поиск вернёт меньше страниц, чем вы запросили, списание произойдёт только за фактически полученные страницы.

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


{
    "pages": 1,
    "query": "купить ноутбук",
    "rawQuery": "купть ноутбук",
    "region": "Москва, Россия",
    "url": "https://www.google.com/search?q=...",
    "results": [
        {
            "url": "https://www.example.com/category/noutbuki/",
            "domain": "www.example.com",
            "title": "Ноутбуки – купить ноутбук по низкой цене",
            "passage": "Ноутбуки – покупайте по выгодным ценам, быстрая и бесплатная доставка...",
            "breadcrumbs": "example.com › Электроника › Ноутбуки"
        }
    ]
}

/bing

Получение поисковой выдачи из Bing (bing.com). Каждая страница — 10 результатов.

Метод:

GET https://jsonseo.ru/api/bing

Параметры запроса:

Локация: при нескольких параметрах Bing берёт верхний, остальные игнорирует. Без них — выдача по России (mkt=ru-RU).

Стоимость запроса:

0.01₽ × количество страниц

Указывается максимальное количество страниц, которое нужно получить. Если поиск вернёт меньше страниц, чем вы запросили, списание произойдёт только за фактически полученные страницы.

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


{
    "pages": 1,
    "query": "пицца",
    "rawQuery": "пицца",
    "region": "Москва, Москва",
    "url": "https://www.bing.com/search?q=...",
    "results": [
        {
            "url": "https://lolo-pizza.ru/",
            "domain": "lolo-pizza.ru",
            "title": "Лоло Пицца — кушай и ржи",
            "passage": "Заказать горячую и ржачную пиццу с доставкой за 30 минут...",
            "breadcrumbs": "https://lolo-pizza.ru"
        }
    ]
}

/wordstat

Получение данных по частотности запросов из Яндекс Вордстата.

Метод:

GET https://jsonseo.ru/api/wordstat

Параметры запроса:

Стоимость запроса:

0.01₽ × количество страниц

Указывается максимальное количество страниц, которое нужно получить. Если Вордстат вернёт меньше страниц, чем вы запросили, списание произойдёт только за фактически полученные страницы.

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


{
    "text": "ремонт айфона",
    "pages": 5,
    "results": {
        "totalValue": 128929,
        "popular": [
            {
                "text": "ремонт айфонов",
                "value": 128927
            },
            {
                "text": "сколько ремонт айфона",
                "value": 8365
            }
        ],
        "associations": [
            {
                "text": "починить телефон",
                "value": 30546
            }
        ]
    }
}