# Scite

> Look up how research papers are cited. Scite reads the scientific literature and tells you whether each citation supports, contrasts or merely mentions the paper it cites. Get papers and their citation tallies by DOI, see where in citing papers a paper is cited, search the literature, check a journal's retractions and Scite Index, and look up authors. Papers and tallies work without an account; search, journals, authors and recommendations need a Scite API key (Scite Pro).

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/scite

## Actions

### Find DOI from PubMed ID

Turn a PubMed ID (PMID) into the paper's DOI. Works without an API key.

**Inputs**

- PubMed ID (`pmid`, text, required): The PubMed ID, digits only.

**Outputs**

- `doi` (text): The paper's DOI
- `pmid` (text): The PubMed ID asked about

**Example output**

```json
{
  "doi": "10.1016/j.biopsych.2005.08.012",
  "pmid": "16376857"
}
```

### Get author statistics

Get an author's totals: how many papers they have, and how many supporting, contrasting and mentioning statements their papers have received and given. Needs an API key.

**Inputs**

- Author slug (`author_slug`, text, required): The author's Scite slug, such as d-hirsch-gLmJld. 'Search papers' returns it as 'authorSlug' on each author.

**Outputs**

- `stats` (object): The author's statistics

**Example output**

```json
{
  "stats": {
    "author": {
      "displayName": "K. Luan Phan",
      "id": 1,
      "nameSlug": "k-luan-phan-jz0xRV"
    },
    "citingTally": {
      "contrasting": 200,
      "mentioning": 20000,
      "numCitedPublications": 5000,
      "supporting": 3000,
      "total": 23200
    },
    "tally": {
      "citingPublications": 8000,
      "contrasting": 60,
      "mentioning": 9000,
      "supporting": 400,
      "total": 9460
    },
    "totalPapers": 250
  }
}
```

### Get citation tally

Count the citation statements that support, contrast or only mention a paper, and how many papers cite it. Works without an API key.

**Inputs**

- DOI (`doi`, text, required): The paper's DOI. A doi.org link works too.

**Outputs**

- `tally` (object): The paper's tally

**Example output**

```json
{
  "tally": {
    "citingPublications": 436,
    "contradicting": 6,
    "doi": "10.1016/j.biopsych.2005.08.012",
    "mentioning": 308,
    "supporting": 27,
    "total": 347,
    "unclassified": 6
  }
}
```

### Get citations by section

Count how many times a paper is cited in the introduction, methods, results, discussion and other sections of the papers that cite it. Works without an API key.

**Inputs**

- DOI (`doi`, text, required): The paper's DOI. A doi.org link works too.

**Outputs**

- `tally` (object): Citations by section

**Example output**

```json
{
  "tally": {
    "discussion": 98,
    "doi": "10.1016/j.biopsych.2005.08.012",
    "introduction": 93,
    "methods": 13,
    "other": 135,
    "results": 8,
    "total": 347
  }
}
```

### Get combined tally for a reading list

Add up the citation tallies of up to 100 papers into one: how much a whole reading list or bibliography is supported, contrasted or mentioned. Works without an API key.

**Inputs**

- DOIs (`dois`, text, required): The papers to add up. One DOI per line, up to 100. A list from an earlier step works too.

**Outputs**

- `doi_count` (number): How many DOIs were added up
- `tally` (object): The combined tally

**Example output**

```json
{
  "doi_count": 2,
  "tally": {
    "citingPublications": 436,
    "contradicting": 6,
    "mentioning": 308,
    "supporting": 27,
    "total": 347,
    "unclassified": 6
  }
}
```

### Get journal citation tally

Count the citation statements that support, contrast or mention the papers a journal has published. Needs an API key.

**Inputs**

- Journal ISSN (`issn`, text, required): The journal's ISSN, such as 0006-3223 (print or online).

**Outputs**

- `tally` (object): The journal's tally

**Example output**

```json
{
  "tally": {
    "issns": [
      "0006-3223"
    ],
    "title": "Biological Psychiatry",
    "totalCites": 1200,
    "totalContrastingCites": 12,
    "totalMentioningCites": 1050,
    "totalSupportingCites": 90,
    "totalUnclassifiedCites": 48
  }
}
```

### Get journal retractions and corrections

Count the retractions, expressions of concern, withdrawals, errata and corrections for up to 500 journals at once. Needs an API key.

**Inputs**

- Journal ISSNs (`issns`, text, required): The journals' ISSNs, one per line or separated by commas.

**Outputs**

- `count` (number): How many are in the list
- `journals` (list): One row per journal

**Example output**

```json
{
  "count": 1,
  "journals": [
    {
      "issn": "0006-3223",
      "notices": {
        "totalCorrections": 0,
        "totalErrata": 77,
        "totalExpressionOfConcerns": 0,
        "totalRetractions": 15,
        "totalWithdrawals": 3
      }
    }
  ]
}
```

### Get journal Scite Index by year

Get a journal's Scite Index for each year: the share of its citation statements that support rather than contrast. Needs an API key.

**Inputs**

- Journal ISSN (`issn`, text, required): The journal's ISSN, such as 0006-3223 (print or online).
- Years (`years`, text): Only these years, separated by commas, such as 2020, 2021. Leave empty for every year.

**Outputs**

- `count` (number): How many are in the list
- `issn` (text): The journal's ISSN
- `years` (list): One row per year

**Example output**

```json
{
  "count": 1,
  "issn": "0006-3223",
  "years": [
    {
      "issns": [
        "0006-3223"
      ],
      "relativeYear": "2021",
      "siAllYears": 0.87,
      "siFiveYears": 0.9,
      "siTwoYears": 0.91
    }
  ]
}
```

### Get many citation tallies

Get the citation tally of up to 500 papers at once, in the order given. DOIs Scite does not know are listed in 'not_found'. Works without an API key.

**Inputs**

- DOIs (`dois`, text, required): The papers to count. One DOI per line, up to 500. A list from an earlier step works too.

**Outputs**

- `count` (number): How many are in the list
- `not_found` (list): DOIs Scite has no record of
- `tallies` (list): One tally per paper

**Example output**

```json
{
  "count": 1,
  "not_found": [],
  "tallies": [
    {
      "citingPublications": 436,
      "contradicting": 6,
      "doi": "10.1016/j.biopsych.2005.08.012",
      "mentioning": 308,
      "supporting": 27,
      "total": 347,
      "unclassified": 6
    }
  ]
}
```

### Get many citations by section

Citations by section for up to 500 papers at once, in the order given. DOIs Scite does not know are listed in 'not_found'. Works without an API key.

**Inputs**

- DOIs (`dois`, text, required): The papers to count. One DOI per line, up to 500. A list from an earlier step works too.

**Outputs**

- `count` (number): How many are in the list
- `not_found` (list): DOIs Scite has no record of
- `tallies` (list): One tally per paper

**Example output**

```json
{
  "count": 1,
  "not_found": [],
  "tallies": [
    {
      "discussion": 98,
      "doi": "10.1016/j.biopsych.2005.08.012",
      "introduction": 93,
      "methods": 13,
      "other": 135,
      "results": 8,
      "total": 347
    }
  ]
}
```

### Get many papers

Get the details of up to 500 papers at once, in the order given. DOIs Scite does not know are listed in 'not_found'. Works without an API key.

**Inputs**

- DOIs (`dois`, text, required): The papers to get. One DOI per line, up to 500. A list from an earlier step works too.

**Outputs**

- `count` (number): How many are in the list
- `not_found` (list): DOIs Scite has no record of
- `papers` (list): The papers found

**Example output**

```json
{
  "count": 1,
  "not_found": [],
  "papers": [
    {
      "abstract": "Amygdala activity to harsh faces was compared in people with social anxiety.",
      "authors": [
        {
          "affiliation": "University of Chicago",
          "authorName": "K. Luan Phan",
          "authorSequenceNumber": 1,
          "authorSlug": "k-luan-phan-jz0xRV",
          "family": "Phan",
          "given": "K. Luan"
        }
      ],
      "doi": "10.1016/j.biopsych.2005.08.012",
      "editorialNotices": [],
      "issns": [
        "0006-3223"
      ],
      "issue": "5",
      "journal": "Biological Psychiatry",
      "page": "424-429",
      "publisher": "Elsevier BV",
      "retracted": false,
      "shortJournal": "Biological Psychiatry",
      "slug": "association-between-amygdala-hyperactivity-to-gVamGz",
      "title": "Association between Amygdala Hyperactivity to Harsh Faces and Severity of Social Anxiety in Generalized Social Phobia",
      "type": "journal-article",
      "volume": "59",
      "year": 2006
    }
  ]
}
```

### Get paper

Get one paper by DOI: title, abstract details, authors, journal, year and any retraction or correction notices. Works without an API key.

**Inputs**

- DOI (`doi`, text, required): The paper's DOI. A doi.org link works too.

**Outputs**

- `paper` (object): The paper

**Example output**

```json
{
  "paper": {
    "abstract": "Amygdala activity to harsh faces was compared in people with social anxiety.",
    "authors": [
      {
        "affiliation": "University of Chicago",
        "authorName": "K. Luan Phan",
        "authorSequenceNumber": 1,
        "authorSlug": "k-luan-phan-jz0xRV",
        "family": "Phan",
        "given": "K. Luan"
      }
    ],
    "doi": "10.1016/j.biopsych.2005.08.012",
    "editorialNotices": [],
    "issns": [
      "0006-3223"
    ],
    "issue": "5",
    "journal": "Biological Psychiatry",
    "page": "424-429",
    "publisher": "Elsevier BV",
    "retracted": false,
    "shortJournal": "Biological Psychiatry",
    "slug": "association-between-amygdala-hyperactivity-to-gVamGz",
    "title": "Association between Amygdala Hyperactivity to Harsh Faces and Severity of Social Anxiety in Generalized Social Phobia",
    "type": "journal-article",
    "volume": "59",
    "year": 2006
  }
}
```

### Get recommended papers

Get papers Scite suggests reading alongside a paper, most relevant first. Needs an API key.

**Inputs**

- DOI (`doi`, text, required): The paper's DOI. A doi.org link works too.

**Outputs**

- `count` (number): How many are in the list
- `papers` (list): The suggested papers

**Example output**

```json
{
  "count": 1,
  "papers": [
    {
      "abstract": "Amygdala activity to harsh faces was compared in people with social anxiety.",
      "authors": [
        {
          "affiliation": "University of Chicago",
          "authorName": "K. Luan Phan",
          "authorSequenceNumber": 1,
          "authorSlug": "k-luan-phan-jz0xRV",
          "family": "Phan",
          "given": "K. Luan"
        }
      ],
      "doi": "10.1016/j.biopsych.2005.08.012",
      "editorialNotices": [],
      "issns": [
        "0006-3223"
      ],
      "issue": "5",
      "journal": "Biological Psychiatry",
      "page": "424-429",
      "publisher": "Elsevier BV",
      "retracted": false,
      "score": 0.82,
      "shortJournal": "Biological Psychiatry",
      "slug": "association-between-amygdala-hyperactivity-to-gVamGz",
      "title": "Association between Amygdala Hyperactivity to Harsh Faces and Severity of Social Anxiety in Generalized Social Phobia",
      "type": "journal-article",
      "volume": "59",
      "year": 2006
    }
  ]
}
```

### List an author's papers

List the papers an author has written, 50 at a time. Pass 'next_offset' as 'Skip' for the next page. Needs an API key.

**Inputs**

- Author slug (`author_slug`, text, required): The author's Scite slug, such as d-hirsch-gLmJld. 'Search papers' returns it as 'authorSlug' on each author.
- Page size (`limit`, number): How many papers to return, 1 to 50. Defaults to 50. From 1 to 50.
- Skip (`offset`, number): How many papers to skip. Use 'next_offset' from the previous page. At least 0.

**Outputs**

- `author` (object): The author
- `count` (number): How many papers are on this page
- `next_offset` (number): The 'Skip' for the next page, empty on the last
- `papers` (list): This page of papers
- `total_papers` (number): How many papers the author has in all

**Example output**

```json
{
  "author": {
    "displayName": "K. Luan Phan",
    "id": 1,
    "nameSlug": "k-luan-phan-jz0xRV"
  },
  "count": 1,
  "next_offset": null,
  "papers": [
    {
      "abstract": "Amygdala activity to harsh faces was compared in people with social anxiety.",
      "authors": [
        {
          "affiliation": "University of Chicago",
          "authorName": "K. Luan Phan",
          "authorSequenceNumber": 1,
          "authorSlug": "k-luan-phan-jz0xRV",
          "family": "Phan",
          "given": "K. Luan"
        }
      ],
      "doi": "10.1016/j.biopsych.2005.08.012",
      "editorialNotices": [],
      "issns": [
        "0006-3223"
      ],
      "issue": "5",
      "journal": "Biological Psychiatry",
      "page": "424-429",
      "publisher": "Elsevier BV",
      "retracted": false,
      "shortJournal": "Biological Psychiatry",
      "slug": "association-between-amygdala-hyperactivity-to-gVamGz",
      "title": "Association between Amygdala Hyperactivity to Harsh Faces and Severity of Social Anxiety in Generalized Social Phobia",
      "type": "journal-article",
      "volume": "59",
      "year": 2006
    }
  ],
  "total_papers": 1
}
```

### List papers citing a paper

List the papers that cite a paper, with their details. Works without an API key. Returns the first 100 unless you ask for more (up to 1,000); 'total' says how many cite it in all.

**Inputs**

- DOI (`doi`, text, required): The paper's DOI. A doi.org link works too.
- Most papers to return (`limit`, number): 1 to 1,000. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many papers are in the list
- `doi` (text): The paper that is cited
- `papers` (list): The citing papers
- `total` (number): How many papers cite this one in all

**Example output**

```json
{
  "count": 1,
  "doi": "10.1016/j.biopsych.2005.08.012",
  "papers": [
    {
      "abstract": "Amygdala activity to harsh faces was compared in people with social anxiety.",
      "authors": [
        {
          "affiliation": "University of Chicago",
          "authorName": "K. Luan Phan",
          "authorSequenceNumber": 1,
          "authorSlug": "k-luan-phan-jz0xRV",
          "family": "Phan",
          "given": "K. Luan"
        }
      ],
      "doi": "10.1016/j.biopsych.2005.08.012",
      "editorialNotices": [],
      "issns": [
        "0006-3223"
      ],
      "issue": "5",
      "journal": "Biological Psychiatry",
      "page": "424-429",
      "publisher": "Elsevier BV",
      "retracted": false,
      "shortJournal": "Biological Psychiatry",
      "slug": "association-between-amygdala-hyperactivity-to-gVamGz",
      "title": "Association between Amygdala Hyperactivity to Harsh Faces and Severity of Social Anxiety in Generalized Social Phobia",
      "type": "journal-article",
      "volume": "59",
      "year": 2006
    }
  ],
  "total": 436
}
```

### Search papers

Search Scite for papers, or for the citation statements inside them, by words, title, author, journal, topic, publication dates, statement type or retraction. Gets one page; to see more, run it again with the next page it gives. Needs an API key.

**Inputs**

- Search term (`term`, text): Words to search for. Quotes match a phrase ("machine learning") and AND, OR and NOT combine terms.
- Search in (`mode`, text): What to find. Defaults to papers. One of: `papers` (Papers (default)), `citations` (Citation statements), `all` (Papers and citation statements).
- Title contains (`title`, text): Only papers whose title contains these words.
- Author (`author`, text): Only papers by this author, by name.
- Journal (`journal`, text): Only papers in this journal, by name.
- Topic (`topic`, text): Only papers on this topic.
- Published on or after (`date_from`, date): Only papers published on or after this date.
- Published on or before (`date_to`, date): Only papers published on or before this date.
- Statement types (`citation_types`, list): Only papers with citation statements of these kinds. One or more of: `supporting`, `contrasting`, `mentioning`.
- Retracted papers only (`has_retraction`, true/false): Turn on to find only papers that have been retracted.
- Sort by (`sort`, text): How to order the results. Defaults to relevance. One of: `relevance` (Relevance (default)), `date` (Publication date), `total_cited` (Most citation statements), `total_supported` (Most supporting statements), `total_contrasted` (Most contrasting statements), `total_mentioned` (Most mentioning statements), `total_citing_publications` (Most citing papers).
- Order (`sort_order`, text): Ignored when sorting by relevance. One of: `desc` (Highest or newest first (default)), `asc` (Lowest or oldest first).
- Page size (`limit`, number): How many results to return, 1 to 100. Defaults to 10. From 1 to 100.
- Skip (`offset`, number): How many results to skip. Use 'next_offset' from the previous page. At least 0.

**Outputs**

- `count` (number): How many results match in all
- `hits` (list): The results
- `next_offset` (number): The 'Skip' for the next page, empty on the last
- `returned` (number): How many results are on this page
- `suggested_term` (text): A corrected search term Scite suggests, if any

**Example output**

```json
{
  "count": 1,
  "hits": [
    {
      "abstract": "Amygdala activity to harsh faces was compared in people with social anxiety.",
      "authors": [
        {
          "affiliation": "University of Chicago",
          "authorName": "K. Luan Phan",
          "authorSequenceNumber": 1,
          "authorSlug": "k-luan-phan-jz0xRV",
          "family": "Phan",
          "given": "K. Luan"
        }
      ],
      "citations": [],
      "date": "2006-03-01",
      "doi": "10.1016/j.biopsych.2005.08.012",
      "editorialNotices": [],
      "journal": "Biological Psychiatry",
      "publisher": "Elsevier BV",
      "slug": "association-between-amygdala-hyperactivity-to-gVamGz",
      "tally": {
        "citingPublications": 436,
        "contradicting": 6,
        "mentioning": 308,
        "supporting": 27,
        "total": 347,
        "unclassified": 6
      },
      "title": "Association between <strong class=\"highlight\">Amygdala</strong> Hyperactivity to Harsh Faces",
      "year": 2006
    }
  ],
  "next_offset": null,
  "returned": 1,
  "suggested_term": ""
}
```
