Struct ArxivClient 

pub struct ArxivClient { /* private fields */ }

Client for ArXiv.org preprint API

Provides methods to search for academic papers, filter by category, and convert results to SemanticVector format for RuVector analysis.

Rate Limiting

The client automatically enforces ArXiv’s rate limit of 1 request per 3 seconds. Includes retry logic for transient failures.

Implementations

impl ArxivClient

pub fn new() -> Self

Create a new ArXiv API client

Example

let client = ArxivClient::new();

pub fn with_embedding_dim(embedding_dim: usize) -> Self

Create a new ArXiv API client with custom embedding dimension

Arguments

• embedding_dim - Dimension for text embeddings (default: 384)

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

Search papers by keywords

Arguments

• query - Search query (keywords, title, author, etc.)
• max_results - Maximum number of results to return

Example

let vectors = client.search("quantum computing", 50).await?;

pub async fn search_category( &self, category: &str, max_results: usize, ) -> Result<Vec<SemanticVector>>

Search papers by ArXiv category

Arguments

• category - ArXiv category code (e.g., “cs.AI”, “physics.ao-ph”, “q-fin.ST”)
• max_results - Maximum number of results to return

Supported Categories

• cs.AI - Artificial Intelligence
• cs.LG - Machine Learning
• cs.CL - Computation and Language
• stat.ML - Statistics - Machine Learning
• q-fin.* - Quantitative Finance (ST, PM, TR, etc.)
• physics.ao-ph - Atmospheric and Oceanic Physics
• econ.* - Economics

Example

let ai_papers = client.search_category("cs.AI", 100).await?;
let climate_papers = client.search_category("physics.ao-ph", 50).await?;

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

Get a single paper by ArXiv ID

Arguments

• arxiv_id - ArXiv paper ID (e.g., “2401.12345” or “arXiv:2401.12345”)

Example

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

pub async fn search_recent( &self, category: &str, days: u64, ) -> Result<Vec<SemanticVector>>

Search recent papers in a category within the last N days

Arguments

• category - ArXiv category code
• days - Number of days to look back (default: 7)

Example

// Get ML papers from the last 3 days
let recent = client.search_recent("cs.LG", 3).await?;

pub async fn search_multiple_categories( &self, categories: &[&str], max_results_per_category: usize, ) -> Result<Vec<SemanticVector>>

Search papers across multiple categories

Arguments

• categories - List of ArXiv category codes
• max_results_per_category - Maximum results per category

Example

let categories = vec!["cs.AI", "cs.LG", "stat.ML"];
let papers = client.search_multiple_categories(&categories, 20).await?;

Trait Implementations

impl Default for ArxivClient

fn default() -> Self

Returns the “default value” for a type.