Skip to main content

Python wrapper for the Bullhorn REST API

Project description

bullhorn

bullhorn is an unofficial REST API wrapper for the Bullhorn CRM, implemented in Python.

Features

  • Seamless interaction with the Bullhorn REST API.
  • Simplified access to candidates, jobs, placements and other entity types.
  • Error handling, including retries, and proper API response validation.

Installation

You can install bullhorn using pip:

pip install bullhorn

Getting Started

bullhorn requires you to have a session token and REST URL from Bullhorn.

Authentication from earlier in the pipeline will be added in a later release.

import os

from bullhorn.client import BullhornClient

# Get credentials
session_token = os.environ.get("BULLHORN_SESSION_TOKEN")
rest_url = os.environ.get("BULLHORN_REST_URL")

# Initialise Bullhorn client with credentials
bc = BullhornClient(
    token=session_token,
    rest_url=rest_url,
)

# Get list of candidates
candidates = bc.get_candidates(
    query="dateLastModified:{2023/01/01 TO *}",
    fields="id,firstName,lastName",
)
print("Success: %r" % (candidates))

Contribution

Contributions to bullhorn are welcome! If you encounter any issues or have suggestions for improvements, please feel free to create an issue or submit a pull request on the GitHub repository at https://github.com/recruithub/bullhorn.

License

bullhorn is released under the MIT License. See LICENSE for more information.

Disclaimer

This package is not officially affiliated with or endorsed by Bullhorn. Use it at your own risk, and make sure to comply with the Bullhorn API usage terms and conditions.

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

bullhorn-0.0.10.tar.gz (19.0 kB view hashes)

Uploaded Source

Built Distribution

bullhorn-0.0.10-py3-none-any.whl (27.5 kB view hashes)

Uploaded Python 3

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