Skip to content

Scripting API

Integrations

from ArtisanPlugin.Scripting import NivodaApi as nivoda

A bridge beyond the document: certified-diamond sourcing. (Searching your own design library is File Search; the natural-language summary of the design itself lives on Document.)

Nivoda

Certified-diamond search (NivodaApi) through your configured Nivoda integration, using your saved filter (colors, clarity, cut, availability):

stones = nivoda.Search("ROUND", 1.0, labGrown = False)
for s in stones:
    print(s.Price / 100.0, s.NivodaDiamond.Certificate.Color)   # Price is in cents
nivoda.ClearCache()      # results are cached ~30 minutes; force a live query

Each result carries price, discount, availability, image/video URLs and the full certificate (lab, cut, clarity, color, polish, symmetry, measurements).