Tools (4)

search_papers
get_paper
list_academic_sources
report_feedback

search_papers

Search for academic papers across Crossref, OpenAlex, PubMed, and Semantic Scholar.

Results are deduplicated by DOI and enriched with metadata from all sources
that found a match. Sorted by citation count (most cited first).

Examples:
search_papers(query="transformer attention mechanism")
search_papers(query="CRISPR gene editing", year_from=2020, max_results=20)
search_papers(query="climate change economic impact", year_from=2018, year_to=2024)

Parameter	Type	Required	Description
`query`	`string`	required	Search query — keywords, title, topic, or author name.
`max_results`	`integer`	optional	Maximum number of results. (default: 10)
`year_from`	`any`	optional	Earliest publication year.
`year_to`	`any`	optional	Latest publication year.

Request Body

{
  "query": "example"
}

get_paper

Resolve a DOI across all four academic sources and return merged metadata.

Queries Crossref, OpenAlex, PubMed, and Semantic Scholar in parallel,
then merges the results into a single enriched paper object with the
best available data from each source.

Examples:
get_paper(doi="10.1038/nature12373")
get_paper(doi="10.1126/science.aax2342")

Parameter	Type	Required	Description
`doi`	`string`	required	Digital Object Identifier (e.g. '10.1038/nature12373').

Request Body

{
  "doi": "example"
}

list_academic_sources

List all registered academic data sources and their status.

Shows which sources are available and whether they are currently enabled.

Examples:
list_academic_sources()

Request Body

{
  "query": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/academic-research/search_papers" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/academic-research/search_papers",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())