=== 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: ``_ 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: `_ 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 ``_), 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.