Struct SemanticScholarClient 

pub struct SemanticScholarClient { /* private fields */ }

Client for Semantic Scholar API

Provides methods to search for academic papers, retrieve citations and references, filter by fields of study, and convert results to SemanticVector format for RuVector analysis.

Rate Limiting

The client automatically enforces rate limits:

• Without API key: 100 requests per 5 minutes (3 seconds between requests)
• With API key: Higher limits (200ms between requests)

API Key

Set the SEMANTIC_SCHOLAR_API_KEY environment variable to use authenticated requests.

Implementations

impl SemanticScholarClient

pub fn new(api_key: Option<String>) -> Self

Create a new Semantic Scholar API client

Arguments

• api_key - Optional API key. If None, checks SEMANTIC_SCHOLAR_API_KEY env var

Example

// Without API key
let client = SemanticScholarClient::new(None);

// With API key
let client = SemanticScholarClient::new(Some("your-api-key".to_string()));

pub fn with_embedding_dim(api_key: Option<String>, embedding_dim: usize) -> Self

Create a new client with custom embedding dimension

Arguments

• api_key - Optional API key
• embedding_dim - Dimension for text embeddings (default: 384)

pub async fn search_papers( &self, query: &str, limit: usize, ) -> Result<Vec<SemanticVector>>

Search papers by keywords

Arguments

• query - Search query (keywords, title, etc.)
• limit - Maximum number of results to return (max 100 per request)

Example

let vectors = client.search_papers("deep learning transformers", 50).await?;

pub async fn get_paper(&self, paper_id: &str) -> Result<Option<SemanticVector>>

Get a single paper by Semantic Scholar paper ID

Arguments

• paper_id - Semantic Scholar paper ID (e.g., “649def34f8be52c8b66281af98ae884c09aef38b”)

Example

let paper = client.get_paper("649def34f8be52c8b66281af98ae884c09aef38b").await?;

pub async fn get_citations( &self, paper_id: &str, limit: usize, ) -> Result<Vec<SemanticVector>>

Get papers that cite this paper

Arguments

• paper_id - Semantic Scholar paper ID
• limit - Maximum number of citations to return (max 1000)

Example

let citations = client.get_citations("649def34f8be52c8b66281af98ae884c09aef38b", 50).await?;

pub async fn get_references( &self, paper_id: &str, limit: usize, ) -> Result<Vec<SemanticVector>>

Get papers this paper references

Arguments

• paper_id - Semantic Scholar paper ID
• limit - Maximum number of references to return (max 1000)

Example

let references = client.get_references("649def34f8be52c8b66281af98ae884c09aef38b", 50).await?;

pub async fn search_by_field( &self, field_of_study: &str, limit: usize, ) -> Result<Vec<SemanticVector>>

Search papers by field of study

Arguments

• field_of_study - Field name (e.g., “Computer Science”, “Medicine”, “Biology”, “Physics”, “Economics”)
• limit - Maximum number of results to return

Example

let cs_papers = client.search_by_field("Computer Science", 100).await?;
let medical_papers = client.search_by_field("Medicine", 50).await?;

pub async fn get_author(&self, author_id: &str) -> Result<Vec<SemanticVector>>

Get author details and their papers

Arguments

• author_id - Semantic Scholar author ID

Example

let author_papers = client.get_author("1741101").await?;

pub async fn search_recent( &self, query: &str, year_min: i32, ) -> Result<Vec<SemanticVector>>

Search recent papers published after a minimum year

Arguments

• query - Search query
• year_min - Minimum publication year (e.g., 2020)

Example

// Get papers about "climate change" published since 2020
let recent = client.search_recent("climate change", 2020).await?;

pub async fn build_citation_graph( &self, paper_id: &str, max_citations: usize, max_references: usize, ) -> Result<(Option<SemanticVector>, Vec<SemanticVector>, Vec<SemanticVector>)>

Build citation graph for a paper

Returns a tuple of (paper, citations, references) as SemanticVectors

Arguments

• paper_id - Semantic Scholar paper ID
• max_citations - Maximum citations to retrieve
• max_references - Maximum references to retrieve

Example

let (paper, citations, references) = client.build_citation_graph(
    "649def34f8be52c8b66281af98ae884c09aef38b",
    50,
    50
).await?;

Trait Implementations

impl Default for SemanticScholarClient

fn default() -> Self

Returns the “default value” for a type.