Pricing - Comps

List Comps

Return individual comp listings with images, sorted by recency.

Requires image_url IS NOT NULL — rows without a thumbnail are filtered out. Each axis filter is canonical-OR-legacy (see module docstring).

get/api/v1/pricing/v2/comps

Request

  • Base URL: https://api.gemstoneaiapp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemstoneaiapp.com/api/v1/pricing/v2/comps
  • Auth: none declared

Query parameters

speciesstring required

Gem species (e.g. Emerald, Ruby)

caratnumber nullable
carat_windownumber

±fraction around carat

colorstring nullable

Canonical or free-text color

color_gradestring nullable

Canonical color grade

claritystring nullable
cutstring nullable
originstring nullable
treatmentstring nullable
categorystring nullable

loose | ring | necklace | pendant | earring | bracelet | brooch

page_sizeinteger
offsetinteger

Response

Successful Response

totalinteger required
page_sizeinteger required
offsetinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.