Tools (6)

search_arxiv_papers
get_arxiv_paper
get_arxiv_author_papers
get_arxiv_recent
list_arxiv_categories
report_feedback

search_arxiv_papers

Search scientific papers on arXiv by keyword, category, and date range.

Args:
query: Search terms (e.g. "attention mechanism transformer", "CRISPR gene editing").
Searches across title, abstract, and author fields.
category: arXiv subject category code (e.g. "cs.AI", "q-fin.TR"). Optional.
date_from: Only return papers submitted from this date onward (YYYY-MM-DD). Optional.
date_to: Only return papers submitted up to this date (YYYY-MM-DD). Optional.
max_results: Number of results to return (1–25, default 10).

Returns:
Dictionary with 'count' and 'papers' list. Each paper has arxiv_id, title,
authors, abstract, categories, primary_category, published, updated, pdf_url, doi.

Parameter	Type	Required	Description
`query`	`string`	required	Search terms (e.g. "attention mechanism transformer", "CRISPR gene editing"). Searches across title, abstract, and author fields.
`category`	`any`	optional	arXiv subject category code (e.g. "cs.AI", "q-fin.TR"). Optional.
`date_from`	`any`	optional	Only return papers submitted from this date onward (YYYY-MM-DD). Optional.
`date_to`	`any`	optional	Only return papers submitted up to this date (YYYY-MM-DD). Optional.
`max_results`	`integer`	optional	Number of results to return (1–25, default 10). (default: 10)

Request Body

{
  "query": "example"
}

get_arxiv_paper

Get full details for a specific arXiv paper by ID.

Args:
arxiv_id: arXiv ID (e.g. "2106.09685", "2106.09685v1", or
"http://arxiv.org/abs/2106.09685").

Returns:
Full paper record: arxiv_id, title, authors, abstract, categories,
primary_category, published, updated, pdf_url, doi.

Parameter	Type	Required	Description
`arxiv_id`	`string`	required	arXiv ID (e.g. "2106.09685", "2106.09685v1", or "http://arxiv.org/abs/2106.09685").

Request Body

{
  "arxiv_id": "123456789"
}

get_arxiv_author_papers

Search papers by a specific arXiv author, sorted by submission date (newest first).

Args:
author_name: Author's name as it appears on arXiv (e.g. "Yann LeCun", "Hinton").
Partial last names work; full names improve precision.
max_results: Number of results to return (1–25, default 10).

Returns:
Dictionary with 'count' and 'papers' list.

Parameter	Type	Required	Description
`author_name`	`string`	required	Author's name as it appears on arXiv (e.g. "Yann LeCun", "Hinton"). Partial last names work; full names improve precision.
`max_results`	`integer`	optional	Number of results to return (1–25, default 10). (default: 10)

Request Body

{
  "author_name": "example"
}

get_arxiv_recent

Get the most recently submitted papers in an arXiv subject category.

Args:
category: arXiv category code (e.g. "cs.LG", "q-fin.TR").
Use list_arxiv_categories() to see all supported codes.
max_results: Number of results to return (1–25, default 10).

Returns:
Dictionary with 'count' and 'papers' list.

Parameter	Type	Required	Description
`category`	`string`	required	arXiv category code (e.g. "cs.LG", "q-fin.TR"). Use list_arxiv_categories() to see all supported codes.
`max_results`	`integer`	optional	Number of results to return (1–25, default 10). (default: 10)

Request Body

{
  "category": "example"
}

list_arxiv_categories

Return all supported arXiv subject categories with descriptions.

Returns:
Dict mapping category code (e.g. "cs.AI") to description.
Use these codes in search_arxiv_papers(category=...) and get_arxiv_recent(category=...).

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/arxiv/search_arxiv_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/arxiv/search_arxiv_papers",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())