Catalog

Search fine jewelry

Returns a page of fine jewelry (wedding bands, earrings, necklaces, bracelets, fashion rings) filtered by category, type, diamond shape, and price. priceFrom and priceMax bound the configurable price range in US dollars; every piece is set with lab grown diamonds.

get/api/v1/jewelry

Request

  • Base URL: https://www.adadiamonds.com
  • URL: https://www.adadiamonds.com/api/v1/jewelry
  • Auth: one of:
    • none
    • API key in header X-Ada-Api-Key
    • OAuth 2 (authorization code, authorization URL https://www.adadiamonds.com/oauth/authorize, token URL https://www.adadiamonds.com/api/oauth/token; client credentials, token URL https://www.adadiamonds.com/api/oauth/token, scopes: catalog:read)

Query parameters

categorystring

Top-level category, e.g. Bridal, Fashion.

typestring

Piece type, e.g. Wedding Bands, Earrings, Necklaces.

shapestring

Diamond shape used in the piece.

min_pricenumber

Minimum price in US dollars (inclusive).

max_pricenumber

Maximum price in US dollars (inclusive).

qstring

Free-text match against the piece name.

limitinteger

Results per page (1–200).

offsetinteger

Zero-based offset into the result set.

Response

A page of jewelry.

object'list' required
currency'USD' required

Example response

{
  "data": [
    {
      "images": [
        {
          "metal": "white"
        }
      ]
    }
  ]
}

Changes

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