Struct UsptoPatentClient 

pub struct UsptoPatentClient { /* private fields */ }

Client for USPTO PatentsView API (PatentSearch API v2)

PatentsView provides free access to USPTO patent data with no authentication required. Uses the new PatentSearch API (ElasticSearch-based) as of May 2025. API documentation: https://search.patentsview.org/docs/

Implementations

impl UsptoPatentClient

pub fn new() -> Result<Self>

Create a new USPTO PatentsView client

No authentication required for the PatentsView API. Uses the new PatentSearch API at search.patentsview.org

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

Search patents by keyword query

Arguments

• query - Search keywords (e.g., “artificial intelligence”, “solar cell”)
• max_results - Maximum number of results to return (max 1000 per page)

Example

let client = UsptoPatentClient::new()?;
let patents = client.search_patents("quantum computing", 50).await?;

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

Search patents by assignee (company/organization name)

Arguments

• company_name - Company or organization name (e.g., “IBM”, “Google”)
• max_results - Maximum number of results to return

Example

let patents = client.search_by_assignee("Tesla Inc", 100).await?;

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

Search patents by CPC classification code

Arguments

• cpc_class - CPC classification (e.g., “Y02E” for climate tech energy, “G06N” for AI)
• max_results - Maximum number of results to return

Example - Climate Change Mitigation Technologies

let climate_patents = client.search_by_cpc("Y02", 200).await?;

Common CPC Classes

• Y02 - Climate change mitigation technologies
• Y02E - Climate tech - Energy generation/transmission/distribution
• G06N - Computing arrangements based on AI/ML/neural networks
• A61 - Medical or veterinary science
• H01 - Electric elements (batteries, solar cells, etc.)

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

Get detailed information for a specific patent

Arguments

• patent_number - USPTO patent number (e.g., “10000000”)

Example

let patent = client.get_patent("10123456").await?;

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

Get citations for a patent (both citing and cited patents)

Arguments

• patent_number - USPTO patent number

Returns

Tuple of (patents that cite this patent, patents cited by this patent)

Trait Implementations

impl Default for UsptoPatentClient

fn default() -> Self

Returns the “default value” for a type.