Struct CrossRefClient 

pub struct CrossRefClient { /* private fields */ }

Client for CrossRef.org scholarly publication API

Provides methods to search for publications, filter by various criteria, and convert results to SemanticVector format for RuVector analysis.

Rate Limiting

The client automatically enforces conservative rate limits (1 request/second). Includes polite pool support via email configuration for better rate limits. Includes retry logic for transient failures.

Implementations

impl CrossRefClient

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

Create a new CrossRef API client

Arguments

• polite_email - Email for polite pool access (optional but recommended for better rate limits)

Example

let client = CrossRefClient::new(Some("researcher@university.edu".to_string()));

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

Create a new CrossRef API client with custom embedding dimension

Arguments

• polite_email - Email for polite pool access
• embedding_dim - Dimension for text embeddings (default: 384)

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

Search publications by keywords

Arguments

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

Example

let vectors = client.search_works("climate change machine learning", 50).await?;

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

Get a single work by DOI

Arguments

• doi - Digital Object Identifier (e.g., “10.1038/nature12373”)

Example

let work = client.get_work("10.1038/nature12373").await?;

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

Search publications funded by a specific organization

Arguments

• funder_id - Funder DOI (e.g., “10.13039/100000001” for NSF)
• limit - Maximum number of results

Example

// Search NSF-funded research
let nsf_works = client.search_by_funder("10.13039/100000001", 20).await?;

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

Search publications by subject area

Arguments

• subject - Subject area or field
• limit - Maximum number of results

Example

let biology_works = client.search_by_subject("molecular biology", 30).await?;

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

Get publications that cite a specific DOI

Arguments

• doi - DOI of the work to find citations for
• limit - Maximum number of results

Example

let citing_works = client.get_citations("10.1038/nature12373", 15).await?;

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

Search recent publications since a specific date

Arguments

• query - Search query
• from_date - Start date in YYYY-MM-DD format
• limit - Maximum number of results

Example

let recent = client.search_recent("artificial intelligence", "2024-01-01", 25).await?;

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

Search publications by type

Arguments

• work_type - Type of publication (e.g., “journal-article”, “book-chapter”, “proceedings-article”, “dataset”)
• query - Optional search query
• limit - Maximum number of results

Supported Types

• journal-article - Journal articles
• book-chapter - Book chapters
• proceedings-article - Conference proceedings
• dataset - Research datasets
• monograph - Monographs
• report - Technical reports

Example

let datasets = client.search_by_type("dataset", Some("climate"), 10).await?;
let articles = client.search_by_type("journal-article", None, 20).await?;

Trait Implementations

impl Default for CrossRefClient

fn default() -> Self

Returns the “default value” for a type.