ra.nivoda

Nivoda certified-diamond search.

import rhinoartisan as ra

Wraps ArtisanPlugin.Scripting.NivodaApi.

Functions

Function
clear_cache()	Drops the service’s in-memory query cache so the next Search hits the live API (results are otherwise cached for ~30 minutes).
search()	Searches certified diamonds matching shape (GemShape name, e.g.

ra.nivoda.clear_cache()

ra.nivoda.clear_cache()

Drops the service’s in-memory query cache so the next Search hits the live API (results are otherwise cached for ~30 minutes).

ra.nivoda.search()

ra.nivoda.search(shape: str, carats: float, lab_grown=None) -> List[Any]

Searches certified diamonds matching shape (GemShape name, e.g. “ROUND”) and carats (the service queries the range [carats-0.01, carats+0.1]). Returns the best matches (the service caps how many items each query fetches). Each item has: Price (in CENTS — divide by 100, same as DiamondCertified does), Discount, and NivodaDiamond.{ImageUrl, VideoUrl, Availability, SupplierStockId, Certificate with Lab/Shape/CertNumber/Cut/ Carats/Clarity/Color/Polish/Symmetry/measurements}.

Parameter	Type
shape	str	required
carats	float	required
lab_grown	bool	optional — None = the tool default