Skip to main content

Пакет для работы с поисковой выдачей Google и Yandex по API через сервис XMLRiver / Package for working with Google and Yandex search results via API via XMLRiver service.

Project description

Пакет для работы с поисковыми системами Google, Yandex через сервис xmlriver.com

English description below

Привет! Добро пожаловать на страницу пакета xmlriver, который позволяет взаимодействовать по API с сервисом xmlriver.com и получать результаты выдачи из поисковых систем Яндекс и Google.

Установка

pip install xmlriver

Использование

import xmlriver
user = 000 #Ваш user_id со страницы https://xmlriver.com/queries/
key = '' #Ваш ключ со страницы https://xmlriver.com/queries/
google = xmlriver.Google(user, key)
query = 'Ваш запрос'
if google.request(query):
    print(google.results)

Дополнительные параметры

Вы можете передавать дополнительные параметры, которые представлены на странице https://xmlriver.com/apidoc/api-about/ (для Google) и https://xmlriver.com/apiydoc/apiy-about/ (для Яндекс)

Можно доработать по примерам https://xmlriver.com/apidoc/api-organic/

Пример передачи параметров:

google = xmlriver.Google(user, key, country=10, device='desktop')

Или прямо в запросе:

google.query(query, country=10, device='desktop')

Доступные методы и атрибуты

  1. google.get_balance() - Получить информацию о балансе
  2. google.get_cost() - Получить стоимость за 1 000 запросов
  3. google.request(query, **kwargs) - Отправить запрос к Google
  4. google.pages - Число, количество найденных результатов
  5. google.results - Список найденных документов
  6. google.get_urls() - Список найденных URL
  7. google.get_titles() - Список заголовков результатов поисковой выдачи
  8. google.get_results_with_domain(domain, **kwargs) - Аналог запроса "domain" -site:domain. Выводит количество результатов
  9. google.is_trust_domain(domain, **kwargs) - Простая проверка домена на траст. True / False
  10. google.is_url_pessimised(url, **kwargs) - Проверка url на наличие фильтра - True / False. Перед этим проверьте, что URL проиндексирован
  11. google.is_url_indexed(url, **kwargs) - Проверка url на индексацию
  12. google.get_onebox_documents(query, types, **kwargs) - получить OneBox документы. Смотри https://xmlriver.com/apidoc/api-organic/#onebox

Поддержка

xmlriver использует пакеты requests и xmltodict и должен работать везде, где работает Python.

Автор

Иван Шарков Мой блог https://0pl.ru Моя организация: https://kurshub.ru

Package for working with search engines Google, Yandex via xmlriver.com service

Hi! Welcome to the xmlriver package page, which allows you to interact via API with xmlriver.com service and get results from Yandex and Google search engines.

Install

pip install xmlriver

Usage

import xmlriver
user = 000 #Your user_id from the page https://xmlriver.com/queries/
key = '' #Your key from page https://xmlriver.com/queries/
google = xmlriver.Google(user, key)
query = 'Your query'
if google.request(query):
    print(google.results)

Additional parameters

You can pass additional parameters, which can be found at https://xmlriver.com/apidoc/api-about/ (for Google) and https://xmlriver.com/apiydoc/apiy-about/ (for Yandex).

Example of passing parameters:

google = xmlriver.Google(user, key, country=10, device='desktop')

Or directly in the query:

google.query(query, country=10, device='desktop')

Available methods and attributes

  1. google.get_balance() - Get balance information
  2. google.get_cost() - Get cost per 1,000 queries
  3. google.request(query, **kwargs) - Send a query to Google
  4. google.pages - Number, number of results found
  5. google.results - List of documents found
  6. google.get_urls() - List of URLs found
  7. google.get_titles() - List of titles of search results
  8. google.get_results_with_domain(domain, **kwargs) - Analogous to the query "domain"-site:domain. Outputs the number of results
  9. google.is_trust_domain(domain, **kwargs) - Simple domain trust check. True / False
  10. google.is_url_pessimized(url, **kwargs) - Check url for filter - True / False. Before doing this, check that the url is indexed
  11. google.is_url_indexed(url, **kwargs) - Check url for indexing
  12. google.get_onebox_documents(query, types, **kwargs) - get OneBox documents. See https://xmlriver.com/apidoc/api-organic/#onebox

Support

xmlriver uses the requests and xmltodict packages and should work wherever Python is running.

Author

Ivan Sharkov My blog: https://0pl.ru My organization: https://kurshub.ru

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xmlriver-0.14.tar.gz (20.8 kB view details)

Uploaded Source

Built Distribution

xmlriver-0.14-py3-none-any.whl (20.2 kB view details)

Uploaded Python 3

File details

Details for the file xmlriver-0.14.tar.gz.

File metadata

  • Download URL: xmlriver-0.14.tar.gz
  • Upload date:
  • Size: 20.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.10

File hashes

Hashes for xmlriver-0.14.tar.gz
Algorithm Hash digest
SHA256 20c24438a50fbeadb3bba98ac59be9494d4fb23ab65fd6f438c24d8d089022af
MD5 3f6262a8102a7a8661d0af0e758a780d
BLAKE2b-256 a4fd689071d480917acf1fa92872acbc1f7354ee64df7b45a46e07a5ce125947

See more details on using hashes here.

File details

Details for the file xmlriver-0.14-py3-none-any.whl.

File metadata

  • Download URL: xmlriver-0.14-py3-none-any.whl
  • Upload date:
  • Size: 20.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.10

File hashes

Hashes for xmlriver-0.14-py3-none-any.whl
Algorithm Hash digest
SHA256 5a11542791ac2c00afef957aac77c4bb70bb298ffa3fb98c1d150135f52d799c
MD5 c8356bb9f962812733dc0f5d0aa4ffc2
BLAKE2b-256 d7c041a7dbf3a0c5548ffbac97f632601ff209fd68ec3e94c074a897810f4381

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page