# findRelatedArticles

**Identifier:** `pubmed_findRelatedArticles`

**Provider:** [PubMed](https://kirha.com/providers/pubmed.md)

Find related or linked articles in PubMed using ELink. Can find similar articles, references cited by an article, or articles that cite it. Returns article summaries with title, authors, journal, and publication date.

## Run it with the CLI

```bash
kirha tools run pubmed_findRelatedArticles \
  --input '{
    "pmid": "<pmid>"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "pubmed_findRelatedArticles",
  "input": {
    "pmid": "<pmid>"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    },
    "pmid": {
      "description": "Source PubMed ID",
      "type": "string"
    },
    "relationshipType": {
      "default": "similar",
      "description": "Type of relationship to find (similar, references, citedBy)",
      "enum": [
        "similar",
        "references",
        "citedBy"
      ],
      "type": "string"
    }
  },
  "required": [
    "pmid"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "pmids": {
      "description": "PMIDs of related articles for composition with fetchPubmedArticles",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "relatedArticles": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "authors": {
            "type": "string"
          },
          "doi": {
            "type": "string"
          },
          "pmid": {
            "type": "string"
          },
          "pubDate": {
            "type": "string"
          },
          "score": {
            "type": "number"
          },
          "source": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "pmid",
          "title",
          "authors",
          "source",
          "pubDate"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "relationshipType": {
      "type": "string"
    },
    "sourcePmid": {
      "type": "string"
    },
    "totalFound": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "sourcePmid",
    "relationshipType",
    "relatedArticles",
    "totalFound",
    "pmids"
  ],
  "type": "object"
}
```

## Related tools

Other PubMed tools that this tool refers to, or that refer to it.

- [`fetchPubmedArticles`](https://kirha.com/providers/pubmed/fetchPubmedArticles.md)

-----

[All PubMed tools](https://kirha.com/providers/pubmed.md) · [< Back to tools list](https://kirha.com/tools.md)