https://github.com/kirillzhosul/hhru
HH.ru API library for Python.
https://github.com/kirillzhosul/hhru
api api-wrapper hhru library sdk vacancies
Last synced: 9 months ago
JSON representation
HH.ru API library for Python.
- Host: GitHub
- URL: https://github.com/kirillzhosul/hhru
- Owner: kirillzhosul
- License: mit
- Created: 2022-09-21T16:51:04.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-28T03:59:39.000Z (almost 2 years ago)
- Last Synced: 2025-09-18T04:49:33.025Z (9 months ago)
- Topics: api, api-wrapper, hhru, library, sdk, vacancies
- Language: Python
- Homepage: https://pypi.org/project/hhru
- Size: 75.2 KB
- Stars: 8
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hhru
[HH.ru](https://hh.ru/) wrapper library for Python.
There is providers for API and Web (Currently, not implemented) \
For authentication, there is `Anonymous` mode, along with other authentications (currently, also not implemented)
### Features
- Anonymous vacancies searches via API
(There is currently boilerplates / not finished features for using authentication / web provider)
### How to install
```
pip install hhru
```
### Example usage
```python
import hhru
# Default client, with `Anonymous` auth and `API` provider
client = hhru.Client()
```
```python
# List first page of Python remote vacancies, sorted by new.
# You can use strings as params or look into `consts` module
vacancies = client.search_vacancies_over_pages(
text="Python",
search_field="name",
order_by="publication_time",
schedule="remote",
)
```
### Using web provider or custom authentication
```python
# Client with web provider and given authentication data
# TODO: Currently, that will behave like API provider (no implementations for web)
client = hhru.Client(
backend=hhru.BackendWebProvider(
auth=DirectAuthProvider(
login="login",
password="password"
)
)
)
```
### References
- API repo: https://github.com/hhru/api
- API docs: https://api.hh.ru/openapi/redoc