Подписаться на новости Be1.ru
vk_logo
Be1 Вконтакте
1251 подписчиков
fb_logo
Be1 Facebook
1567 подписчиков
Новости

API инструментов

Сообщить о проблеме

Be1 предоставляет API-интерфейс для автоматического использования своих инструментов. API инструментов позволяет добавлять данные на проверку и получать результаты этих проверок. Для использования API нужен API-ключ, который можно сгенерировать у себя в профиле.

Внимание!
API работает в beta-режиме. Не стесняйтесь обращаться
в поддержку если у Вас возникнут какие либо вопросы.

Добавить задачу на проверку можно отправив POST запрос на адрес:

https://be1.ru/api/tools/add-task?apikey=YOUR_API_KEY

С параметрами:

tool - название инструмента (соответсвует url адресу инструмента)

params - параметры, передаваемые инструменту на проверку

Список всех доступных инструментов и их параметров указан ниже.

В ответ будет возвращен идентификатор задачи (slug) с помощью которого можно будет получить результат проверки, когда тот будет готов. Например:

{
    "status": 1,
    "slug": "jdui4nrg04og7shf",
    "params": {...}
}

В случае же какой либо ошибки, ответ будет следующим:

{
    "status": 0,
    "message": "error message..."
}

Получить результат проверки можно сделав GET запрос по адресу:

https://be1.ru/api/tools/get-result?apikey=YOUR_API_KEY&tool=TOOL&slug=SLUG

Если результат готов, ответ будет следующим:

{
    "status": 1,
    "result": {...} // или [...]
}

Если результат еще не готов, будет возвращена его позиция в очереди:

{
    "status": 1,
    "result": null,
    "position": 1
}

В случае же какой либо ошибки, либо если инструменту не удалось выполнить задачу, будет возвращена ошибка:

{
    "status": 0,
    "message": "error message..."
}


Внимание!
Примеры реализации и готовый код можно найти в соответствующем
репозитории на github.

Перечень инструментов с API доступом

параметры:
domains список сайтов, которые нужно проверить
пример:
параметры:
domains = ["be1.ru", "google.com", "yandex.ru"]

результат:
[
    {
        "domain1": "be1.ru",
        "domain2": "google.com",
        "error": false,
        "affiliat": false
    },
    {
        "domain1": "be1.ru",
        "domain2": "yandex.ru",
        "error": false,
        "affiliat": false
    },
    {
        "domain1": "google.com",
        "domain2": "yandex.ru",
        "error": false,
        "affiliat": false
    }
]
стоимость проверки:
0.3 руб за 1 домен
Перейти к инструменту
параметры:
text текст, уникальность которого нужно проверить
exclude_url URL адрес страницы, которую не нужно учитывать (не обязательно)
exclude_domain Сайт, который не нужно учитывать (не обязательно)
пример:
параметры:
text = "какой-то текст..."

результат:
{
    "uniqueness": 86,
    "shingles": [
        {
            "id": 0,
            "paragraph_id": 0,
            "checkable": true,
            "unique": false,
            "text": "какя-то часть текста",
            "words": [
                "какая-то",
                "часть",
                "текста"
            ],
            "links": [
                {
                    "domain": "be1.ru",
                    "url": "https://be1.ru/some-page/"
                }
            ]
        }
    ],
    "vfacen": {
        "percent": 9.3,
        "words": [
            {
                "academic": 5.6,
                "classic": 1.7,
                "count": 3,
                "base": "СЛОВО",
                "words": {
                    "СЛОВА": 2,
                    "СЛОВ": 1
                }
            }
        ]
    },
    "grammar": [
        {
            "word": "масква",
            "s": [
                "москва"
            ]
        }
    ],
    "water": {
        "percent": 32,
        "words": {
            "если": 3,
            "можно": 8
        }
    }
}
стоимость проверки:
1 руб
Перейти к инструменту
параметры:
domains список сайтов, которые нужно проверить
пример:
параметры:
domains = ["hi-news.ru"]

результат:
[
    {
        "domain": "hi-news.ru",
        "info": {
            "cms": [
                {
                    "name": "WordPress",
                    "site": "https://wordpress.org/",
                    "icon": "wordpress.ico",
                    "service_url": "/services/razrabotka/cms/wordpress-org"
                }
            ],
            "js": [
                {
                    "name": "JQuery",
                    "site": "https://jquery.com/",
                    "icon": "jquery.png"
                }
            ],
            "backend": [],
            "webdatastats": "-"
        },
        "webdatastats": "-"
    }
]
стоимость проверки:
1 руб за 1 домен
Перейти к инструменту
параметры:
queries список запросов, которые нужно групировать
region регион поиска
пример:
параметры:
queries = ["антиплагиат", "анализ сайта", "проверка уникальности текста"]
region = 225

результат:
{
    "2": [
        [
            "антиплагиат",
            "проверка уникальности текста"
        ],
        [
            "анализ сайта"
        ]
    ],
    "3": [
        [
            "антиплагиат",
            "проверка уникальности текста"
        ],
        [
            "анализ сайта"
        ]
    ],
    "4": [
        [
            "антиплагиат",
            "проверка уникальности текста"
        ],
        [
            "анализ сайта"
        ]
    ],
    "5": [
        [
            "антиплагиат",
            "проверка уникальности текста"
        ],
        [
            "анализ сайта"
        ]
    ],
    "6": [
        [
            "антиплагиат",
            "проверка уникальности текста"
        ],
        [
            "анализ сайта"
        ]
    ],
    "7": [
        [
            "антиплагиат"
        ],
        [
            "анализ сайта"
        ],
        [
            "проверка уникальности текста"
        ]
    ],
    "8": [
        [
            "антиплагиат"
        ],
        [
            "анализ сайта"
        ],
        [
            "проверка уникальности текста"
        ]
    ],
    "9": [
        [
            "антиплагиат"
        ],
        [
            "анализ сайта"
        ],
        [
            "проверка уникальности текста"
        ]
    ],
    "10": [
        [
            "антиплагиат"
        ],
        [
            "анализ сайта"
        ],
        [
            "проверка уникальности текста"
        ]
    ]
}
стоимость проверки:
0,01 руб за каждый запрос
Перейти к инструменту
параметры:
url адрес сайта (например: "be1.ru")
пример:
параметры:
url = "be1.ru"

результат:
{
    "domain": "be1.ru",
    "prices": {
        "backlinks_ip": "220500",
        "eff_volume": "686007",
        "day": "20241",
        "yaca": "0",
        "total": 926748
    }
}
стоимость проверки:
2 руб
Перейти к инструменту
параметры:
domain адрес сайта
competitors список конкурентов сайта
пример:
параметры:
domain = "google.com"
competitors = ["yandex.ru", "bing.com"]

результат:
{
    "domain": "be1.ru",
    "competitors": [
        "yandex.ru",
        "bing.com"
    ],
    "missedQueries": [
        {
            "word": "поиск",
            "volume": 100500,
            "competitors": [
                {
                    "id": 1,
                    "path": "/search"
                }
            ]
        }
    ]
}
стоимость проверки:
5 руб
Перейти к инструменту
параметры:
url адрес сайта (например: "be1.ru")
пример:
параметры:
url = "be1.ru"

результат:
{
    "domain": "be1.ru",
    "regions": [
        {
            "id": 166,
            "parent_id": 0,
            "name": "СНГ (исключая Россию)",
            "google_canonical_name": ""
        }
    ]
}
стоимость проверки:
3 руб
Перейти к инструменту
параметры:
links список страниц, которые нужно проверить (например: "https://be1.ru/")
пример:
параметры:
links = ["https://be1.ru"]

результат:
[
    {
        "date": "12 лет 222 дня",
        "days": 4605,
        "url": "https://be1.ru"
    }
]
стоимость проверки:
0.2 руб за 1 страницу
Перейти к инструменту
параметры:
domain адрес сайта (например: "be1.ru")
пример:
параметры:
domain = "be1.ru"

результат:
{
    "domain": "be1.ru",
    "subdomains": [
        "m.be1.ru",
        "old.be1.ru",
        "partner.be1.ru",
        "stat.be1.ru",
        "tools.be1.ru"
    ]
}
стоимость проверки:
0.5 руб
Перейти к инструменту
параметры:
domain адрес сайта (например: "be1.ru")
пример:
параметры:
domain = "be1.ru"

результат:
{
    "domain": "be1.ru",
    "whois": {
        "general": {
            "Владелец домена": "Private Person",
            "Дата регистрации домена": "2001-05-03",
            "Домен зарегестрирован до": "2020-06-05",
            "IP адрес": "89.108.117.128"
        },
        "lines": {
            "domain": "BE1.RU",
            "nserver": [
                "ns1.altweb.ru.",
                "ns2.altweb.ru."
            ],
            "state": "REGISTERED, DELEGATED, VERIFIED",
            "person": "Private Person",
            "registrar": "RU-CENTER-RU",
            "admin-contact": "https://www.nic.ru/whois",
            "created": "2001-05-03T20:00:00Z",
            "paid-till": "2020-05-04T21:00:00Z",
            "free-date": "2020-06-05",
            "source": "TCI"
        },
        "raw": "% By submitting a query to RIPN's Whois Service\n% you agree to abide by the following terms of use:\n% http://www.ripn.net/about/servpol.html#3.2 (in Russian) \n% http://www.ripn.net/about/en/servpol.html#3.2 (in English).\n\ndomain:        BE1.RU\nnserver:       ns1.altweb.ru.\nnserver:       ns2.altweb.ru.\nstate:         REGISTERED, DELEGATED, VERIFIED\nperson:        Private Person\nregistrar:     RU-CENTER-RU\nadmin-contact: https://www.nic.ru/whois\ncreated:       2001-05-03T20:00:00Z\npaid-till:     2020-05-04T21:00:00Z\nfree-date:     2020-06-05\nsource:        TCI\n\nLast updated on 2019-11-06T08:11:33Z",
        "ip": "89.108.117.128\n"
    }
}
стоимость проверки:
0.2 руб
Перейти к инструменту
параметры:
domains список сайтов, которые нужно проверить (например: "be1.ru")
пример:
параметры:
domains = ["be1.ru", "google.com"]

результат:
[
    {
        "domain": "be1.ru",
        "virus": false
    },
    {
        "domain": "google.com",
        "virus": false
    }
]
стоимость проверки:
0.5 руб за 1 домен
Перейти к инструменту
параметры:
domain сайт, который нужно проверить (например: "be1.ru")
query поисковый запрос
region регион поиска
пример:
параметры:
domain = "be1.ru"
query = "анализ сайта"
region = 225

результат:
{
    "filter": false,
    "message": "Поздравляем, фильтра на документе нет."
}
стоимость проверки:
0,3 руб
Перейти к инструменту
параметры:
domains список сайтов, которые нужно проверить
пример:
параметры:
domains = ["be1.ru", "google.com"]

результат:
[
    {
        "domain": "be1.ru",
        "category": "",
        "kley": "",
        "kley_domain": "",
        "tcy": 0
    },
    {
        "domain": "google.com",
        "category": "",
        "kley": "",
        "kley_domain": "",
        "tcy": 0
    }
]
стоимость проверки:
0.2 руб за 1 домен
Перейти к инструменту
параметры:
text текст, тошнотность которого нужно проверить
пример:
параметры:
text = "какой-то текст..."

результат:
{
    "percent": 5.3,
    "words": [
        {
            "base": "ТЕКСТ",
            "count": 6,
            "academic": 5.3,
            "classic": 2.4,
            "words": {
                "ТЕКСТ": 1,
                "ТЕКСТА": 3,
                "ТЕКСТОМ": 2
            }
        }
    ]
}
стоимость проверки:
0,3 руб за проверку
Перейти к инструменту
параметры:
queries список запросов, которые нужно проверить
region регион поиска
пример:
параметры:
queries = ["купить iphone"]

результат:
{
    "queries": [
        {
            "text": "купить iphone",
            "wordstat": {
                "base": {
                    "text": "купить iphone",
                    "value": 305445
                },
                "strict": {
                    "text": "\"купить iphone\"",
                    "value": 5260
                },
                "strict2": {
                    "text": "\"!купить !iphone\"",
                    "value": 5239
                }
            }
        }
    ],
    "region": 225
}
стоимость проверки:
0,2 руб за запрос
Перейти к инструменту
параметры:
domains список сайтов, которые нужно проверить
пример:
параметры:
domains = ["be1.ru"]

результат:
[
    {
        "domain": "be1.ru",
        "iks": 2100,
        "history": [
            [
                "2019-08-27",
                2150
            ],
            [
                "2019-09-27",
                2140
            ]
        ]
    }
]
стоимость проверки:
0,2 руб за 1 домен
Перейти к инструменту