Skip to main content

citations_count_lib PyPI - Version

Overview

citations-count is a Python library designed to fetch citation counts for academic publications from multiple sources, including CrossRef, OpenCitations, and Google Scholar.

This library provides a unified interface to retrieve citation counts using DOIs (Digital Object Identifiers).

Features

  • Fetch citation counts from CrossRef, OpenCitations, and Google Scholar.
  • Support for verbose logging to aid in debugging.
  • Handles rate limiting by introducing delays between API calls.

Installation

To install the library, clone the repository and install the dependencies:

git clone https://github.com/ezefranca/citations_count_lib.git
cd citations_count_lib
pip install -r requirements.txt

Usage

from citations_count.core import fetch_multiple_citations

dois = [
    "10.1109/SeGAH.2017.7939283",
    "10.1109/SeGAH.2011.6165447",
    "10.3390/info16030246",
    "10.1038/s41586-020-2649-2"
]
results = fetch_multiple_citations(dois, delay=1.0, verbose=True)
for result in results:
    print(result)

Example output:

[
    {
        "doi": "10.1109/SeGAH.2017.7939283",
        "citations_crossref": 62,
        "citations_opencitations": 64,
        "citations_google_scholar": 160
    },
    {
        "doi": "10.1109/SeGAH.2011.6165447",
        "citations_crossref": 48,
        "citations_opencitations": 48,
        "citations_google_scholar": 116
    },
    {
        "doi": "10.3390/info16030246",
        "citations_crossref": 0,
        "citations_opencitations": 0,
        "citations_google_scholar": 0
    },
    {
        "doi": "10.1038/s41586-020-2649-2",
        "citations_crossref": 14710,
        "citations_opencitations": None,
        "citations_google_scholar": 22393
    }
]

Logging

Verbose logging can be enabled by setting the verbose parameter to True. This will print detailed logs for debugging purposes.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Metadata

Release files for citations-count 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for citations-count 1.0.0
File Size Uploaded
citations_count-1.0.0.tar.gz 6.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for citations-count 1.0.0
File Interpreter ABI Platform
citations_count-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.3 kB

Release files / citations_count-1.0.0.tar.gz

Download URL citations_count-1.0.0.tar.gz
Size 6.6 kB
Tags Source
SHA-256 checksum
How to use checksums
1a33f2222885eee2051b6064a3346ea1e652e958e95283df80e5c341cd988eb1
BLAKE2b-256 checksum
How to use checksums
ce776604749f0d8444b9324b4ba80436e6c91326362be4747a5a0218589bedfa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.8

Release files / citations_count-1.0.0-py3-none-any.whl

Download URL citations_count-1.0.0-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3d5150e4219340903633bdc4f372a32a433a5138714d9a040e5624c3de621776
BLAKE2b-256 checksum
How to use checksums
d7f11cd08a89441c9aa3da6ee777108cefe6ea5eece7933c615e7050c015bed1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.8

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page