API

Dissemin provides an API to query the availability of arbitrary papers.

Querying the API

Querying by DOI

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

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

Querying by Dissemin Paper ID

Dissemin stores internal numeric identifiers for its papers. These identifiers are exposed in the URLs of the paper pages, for instance. It is possible to retrieve metadata from these identifiers:

<https://dissem.in/api/p/6859902>_

Querying by Metadata Fields

When the DOI or the Dissemin ID are not known, it is possible to retrieve a paper by title, authors and publication date. This is done by posting a JSON object encoding this metadata to https://dissem.in/api/query/ , as follows:

curl -H "Content-Type: application/json" -d '{"title":"Refining the Conceptualization of an Important Future-Oriented Self-Regulatory Behavior: Proactive Coping", "date":"2009-07-01","authors":[{"first":"Stephanie Jean","last":"Sohl"},{"first":"Anne","last":"Moyer"}]}' https://dissem.in/api/query/

The date field can contain coarser dates such as 2009-07 or 2009, and authors can also be specified as plain text with {"plain":"Anne Moyer"} instead of {"first":"Anne","last":"Moyer"}.

This API method uses the internal paper deduplication strategy in Dissemin to match the bibliographic reference to a known paper in the database. This deduplication is done by computing a unique key (called fingerprint) from the title, authors and publication date. Therefore, this API method will always return at most one paper, unlike the search endpoint below which works like traditional search engines.

Searching the API

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

There are the following search keys:

authors
List of authors, separated by ,. To enforce a last name, prefix with last:.
doctypes
Filter by document types. There are the following document types available: book, book-chapter, dataset, journal-article, journal-issue, other, poster, preprint, proceedings, proceedings-article, reference-entry, report, thesis
pub_after
Published after given date. The format is YYYY, YYYY-MM, YYYY-MM-DD.
pub_before
Published before given date. The format is YYYY, YYYY-MM, YYYY-MM-DD.
q
Search for title
sort_by
The results are sorted descending by date, i.e. newest first. To revserse the order, pass pubdate.
status

The open access status as computed by Dissemin. This can be one of

oa
Available from the publisher
ok
Available from the author
couldbe
Could be shared by the authors
unk
Unknown/unclear sharing policy
closed
Publisher forbids sharing

You can pass multiple status.

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",
                    "published": "cannot"
                },
                "identifier": "oai:crossref.org:10.1016/j.paid.2009.02.013",
                "type": "journal-article",
                "pages": "139-144"
            },
            {
                "splash_url": "https://www.researchgate.net/publication/26648440_Refining_the_Conceptualization_of_an_Important_Future-Oriented_Self-Regulatory_Behavior_Proactive_Coping",
                "doi": "10.1016/j.paid.2009.02.013",
                "contributors": "",
                "abstract": "Proactive coping, directed at an upcoming as
opposed to an ongoing stressor, is a new focus in positive psychology
research. However, two differing conceptualizations of this construct
create confusion. This study compared how each operationalization of
proactive coping relates to well-being. Participants (N = 281) facing an
upcoming college examination completed the Proactive Coping Inventory
(PCI; consisting of two subscales that each assess one of the
conceptualizations), the Proactive Competence Scale (PCS; that assesses
the proactive coping process), and measures of well-being. The results
demonstrated that conceptualizing proactive coping as a
positively-focused striving for goals was predictive of well-being (the
shared variance from affect, subjective well-being and physical
symptoms), whereas conceptualizing proactive coping as focused on
preventing a negative future was not. The first conceptualization of
proactive coping's unique association with well-being was explained by
two of the proactive competencies, use of resources and realistic goal
setting, and the remaining variance in well-being was explained by the
first factor of optimism. These results demonstrated that aspiring for a
positive future is distinctly predictive of well-being and that research
should focus on accumulating resources and goal setting in designing
interventions to promote proactive coping.",
                "pdf_url": "https://www.researchgate.net/profile/Stephanie_Sohl2/publication/26648440_Refining_the_Conceptualization_of_an_Important_Future-Oriented_Self-Regulatory_Behavior_Proactive_Coping/links/55e463c008ae2fac47227a76.pdf",
                "source": "researchgate",
                "keywords": "",
                "identifier": "oai:researchgate.net:26648440",
                "type": "journal-article"
            },
            {
                "splash_url": "http://www.ncbi.nlm.nih.gov/pubmed/19578529",
                "doi": "10.1016/j.paid.2009.02.013",
                "contributors": "",
                "abstract": "Proactive coping, directed at an upcoming as
opposed to an ongoing stressor, is a new focus in positive psychology
research. However, two differing conceptualizations of this construct
create confusion. This study compared how each operationalization of
proactive coping relates to well-being. Participants (N = 281) facing an
upcoming college examination completed the Proactive Coping Inventory
(PCI; consisting of two subscales that each assess one of the
conceptualizations), the Proactive Competence Scale (PCS; that assesses
the proactive coping process), and measures of well-being. The results
demonstrated that conceptualizing proactive coping as a
positively-focused striving for goals was predictive of well-being (the
shared variance from affect, subjective well-being and physical
symptoms), whereas conceptualizing proactive coping as focused on
preventing a negative future was not. The first conceptualization of
proactive coping’s unique association with well-being was explained by
two of the proactive competencies, use of resources and realistic goal
setting, and the remaining variance in well-being was explained by the
first factor of optimism. These results demonstrated that aspiring for a
positive future is distinctly predictive of well-being and that research
should focus on accumulating resources and goal setting in designing
interventions to promote proactive coping.",
                "pdf_url": "http://www.ncbi.nlm.nih.gov/pubmed/19578529",
                "source": "base",
                "keywords": "Article",
                "identifier": "ftpubmed:oai:pubmedcentral.nih.gov:2705166",
                "type": "other"
            }
        ],
        "authors": [
            {
                "name": {
                    "last": "Sohl",
                    "first": "Stephanie Jean"
                }
            },
            {
                "name": {
                    "last": "Moyer",
                    "first": "Anne"
                }
            }
        ],
        "date": "2009-07-01",
        "type": "journal-article"
    }

}

Most fields are self-explanatory, here is a quick description of the other ones:

  • classification is the code for the self-archiving policy of the publisher “OA” (available from the publisher), “OK” (some version can be shared), “UNK” (unknown/unclear sharing policy), “NOK” (restrictive sharing policy).
  • splash_url is a URL where Dissemin thinks that the paper is described, without being necessarily available. This can be a publisher webpage (with the article available behind a paywall), a page about the paper without a copy of the full text (e.g., a HAL page like https://hal.archives-ouvertes.fr/hal-01664049), or a page from which the paper was discovered (e.g., the profile of a user on ORCID).
  • pdf_url is a URL where Dissemin thinks the full text can be accessed for free. This is rarely a direct link to an actual PDF file, i.e., it is often a link to a landing page (e.g., https://arxiv.org/abs/1708.00363). It is set to null if we could not find a free source for this paper.
  • records gives a list of the places where the full text has been made available (so: repositories, homepages or social networks). Sometimes, these repositories only contain a bibliographical record and not the full text. The pdf_url field of each record indicates our assessment of the availability of that record. If the publisher has been found in RoMEO, it also indicates the summary of its policy, using the codes drawn from the RoMEO API. This list will remain empty if no DOI is provided.

License, Usage

CAPSH claims no ownership of the metadata served via this API. It has been collected from various free sources.

The interface itself should not be abused: please do not use concurrent connections on it, and keep your requests to a slow rate (at most one per second). If you need a faster access to this data, please get in touch with us.