habanero

What it is and what it does

habanero wraps Crossref's HTTP search API into a Python client, letting you query bibliographic metadata—article titles, authors, publication dates, DOIs—without building HTTP requests by hand. It's designed as a low-level interface, meaning it stays close to the API's structure rather than adding high-level abstractions; you work directly with the data Crossref returns.

The package depends on httpx2 for HTTP transport, urllib3 as a fallback, tqdm for progress indication in bulk operations, and packaging for version handling. It supports Python 3.10 through 3.14 and has been in active development since 2015. An optional bibtexparser dependency (version 2.0.0b7 or later) is available for fixing bibtex-formatted citations via content negotiation, installed separately with the [bibtex] extra.

Use it for:

• Search Crossref's publication database by title, author, or DOI to retrieve structured metadata for research tools or literature review automation.
• Build a bibliographic index or reference management system that pulls live data from Crossref rather than maintaining a static database.
• Integrate publication metadata into a research workflow, such as fetching article details to populate a knowledge base or citation graph.
• Retrieve DOI metadata programmatically to validate or enrich citation data in academic publishing platforms.
• Batch-query Crossref for metadata on multiple publications, using tqdm progress tracking for long-running operations.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

habanero is a low-level Python client for the Crossref search API, enabling programmatic access to bibliographic metadata and publication data from Crossref's database.

Yes. habanero is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively under MIT. It's the natural choice if you need direct, low-level access to Crossref's search API from Python. Install it if you're building tools that query bibliographic data; skip it only if you need a higher-level abstraction or don't need Crossref's specific data.

Install

habanero on PyPI

pip install habanero

uv add habanero

poetry add habanero

Installing habanero

Before you install

Low friction installation with a pure-Python wheel. Actively maintained with a recent release; last commit 2026-07-31 and status marked active. Depends on four common libraries: httpx2, packaging, tqdm, and urllib3.

License in practice

MIT license (permissive). You can use, modify, and distribute habanero freely in commercial and private projects, with no warranty and minimal attribution requirements.

Quickstart

pip install habanero

from habanero import Crossref

cr = Crossref()
results = cr.works(query='python')

Requires Python 3.10 or later. API access requires an internet connection; consider including a mailto parameter in requests to join Crossref's polite pool for better rate limits.

Verify before relying

• Whether rate limiting behavior differs meaningfully between requests with and without a mailto parameter in practice.
• Performance characteristics when handling large result sets or concurrent requests.
• Whether the optional bibtexparser dependency is commonly needed or rarely used.

Package facts

Evidence: habanero-2.9.2-py3-none-any.whl

Tags

More Bio-Informatics packages