<commit_before>.. _page-api:

Dissemin API
============

Dissemin provides an API to query the availability of arbitrary papers.
Please do not assume the interface will not change in the future as it
is still being improved.

Querying by DOI
---------------

You can retrieve Dissemin's metadata for a specific paper by DOI:

http://dissem.in/api/10.1016/j.paid.2009.02.013.

Searching for papers
--------------------

The search interface is also exposed as an API. The parameters it
understands are the same as the human-readable version. Statistics about
the results are also returned as well.

http://dissem.in/search/?q=pregroup

Understanding the results
-------------------------

::

    {

        "status": "ok",
        "paper": {
            "classification": "UNK",
            "title": "Refining the Conceptualization of an Important
    Future-Oriented Self-Regulatory Behavior: Proactive Coping",
            "pdf\_url": "http://www.ncbi.nlm.nih.gov/pubmed/19578529",
            "records": [
                {
                    "splash\_url":
    "https://doi.org/10.1016/j.paid.2009.02.013",
                    "doi": "10.1016/j.paid.2009.02.013",
                    "publisher": "Elsevier BV",
                    "issue": "2",
                    "journal": "Personality and Individual Differences",
                    "issn": "0191-8869",
                    "volume": "47",
                    "source": "crossref",
                    "policy": {
                        "romeo\_id": "30",
                        "preprint": "can",
                        "postprint": "can",<commit_msg>Fix API doc. Closes #367.<commit_after>.. _page-api:

Dissemin API
============

Dissemin provides an API to query the availability of arbitrary papers.
Please do not assume the interface will not change in the future as it
is still being improved.

Querying by DOI
---------------

You can retrieve Dissemin's metadata for a specific paper by DOI:

http://dissem.in/api/10.1016/j.paid.2009.02.013.

Searching for papers
--------------------

The search interface is also exposed as an API. The parameters it
understands are the same as the human-readable version at
http://dissem.in/search . Statistics about
the results are also returned as well.

http://dissem.in/api/search/?q=pregroup

Understanding the results
-------------------------

::

    {

        "status": "ok",
        "paper": {
            "classification": "UNK",
            "title": "Refining the Conceptualization of an Important
    Future-Oriented Self-Regulatory Behavior: Proactive Coping",
            "pdf\_url": "http://www.ncbi.nlm.nih.gov/pubmed/19578529",
            "records": [
                {
                    "splash\_url":
    "https://doi.org/10.1016/j.paid.2009.02.013",
                    "doi": "10.1016/j.paid.2009.02.013",
                    "publisher": "Elsevier BV",
                    "issue": "2",
                    "journal": "Personality and Individual Differences",
                    "issn": "0191-8869",
                    "volume": "47",
                    "source": "crossref",
                    "policy": {
                        "romeo\_id": "30",
                        "preprint": "can",
                        "postprint": "can",
{'fraction_non_alphanumeric': 0.15354090354090355, 'fraction_numerical': 0.04120879120879121, 'mean_word_length': 1.6448748991121873, 'pattern_counts': {'":': 36, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6769895', 'n_tokens_mistral': 1022, 'n_tokens_neox': 861, 'n_words': 267}