Catalog / Sadati Jewellery Catalog

Sadati Jewellery Catalog API

sadatijewellery.com

Live, read-only access to Sadati Jewellery's public JSON catalog. Effective source filters are text, availability, source sort, and offset pagination. Category, collection, material, gemstone, color, and API-compatible price-range filters are retained as documented inputs but rejected when supplied because the public source currently returns empty taxonomy endpoints, 404s for guessed filters, or a price query with different computed semantics from published per_buy_price. The JSON source does not publish canonical permalinks or currency/display/original-sale strings; those fields remain null.

  • shopping
  • jewellery
  • catalog
  • products
3 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Sadati Jewellery Catalog API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Queries Sadati's observed GET /api/products/filter endpoint. Pagination is offset-based at the source (page and per_page are translated to skip and take). Product IDs returned here can be passed to the detail route.

Optional parameters 12

Free-text source search across product records.

Unavailable source taxonomy filter; Sadati currently returns no category values.

Unavailable source taxonomy filter; group is returned as a record field but is not a proven filter.

Unavailable source taxonomy filter; brands endpoint is currently empty.

Unavailable source taxonomy filter; gemstone values are nullable and no source filter is published.

Unavailable source taxonomy filter; source color query returned 404 in a real probe.

Filter to source-available (true) or unavailable (false) variants.

Unavailable effective range input: Sadati's price query uses a different computed storefront value than the published per_buy_price, so the API does not claim a compatible range.

Unavailable effective range input for the same source-semantics reason as min_price.

Source sort query value, such as new or discount.

One-based source page. Offsets above the observed backend cap may return an upstream 404.

Number of source records requested; passed through to the source without an invented local maximum.

View call pricing
cURL · Products
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/2dac43b5-3bb1-4a88-bfdc-527508df47eb/v1/products' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETProducts/v1/products

Queries Sadati's observed GET /api/products/filter endpoint. Pagination is offset-based at the source (page and per_page are translated to skip and take). Product IDs returned here can be passed to the detail route.

Input

qOptionalQuery · string | null

Free-text source search across product records.

Example: میرو

categoryOptionalQuery · string | null

Unavailable source taxonomy filter; Sadati currently returns no category values.

Example: 1

collectionOptionalQuery · string | null

Unavailable source taxonomy filter; group is returned as a record field but is not a proven filter.

Example: 12194

materialOptionalQuery · string | null

Unavailable source taxonomy filter; brands endpoint is currently empty.

Example: gold

gemstoneOptionalQuery · string | null

Unavailable source taxonomy filter; gemstone values are nullable and no source filter is published.

Example: diamond

colorOptionalQuery · string | null

Unavailable source taxonomy filter; source color query returned 404 in a real probe.

Example: مطابق عکس

availabilityOptionalQuery · boolean | null

Filter to source-available (true) or unavailable (false) variants.

Example: true

min_priceOptionalQuery · number, min: 0 | null

Unavailable effective range input: Sadati's price query uses a different computed storefront value than the published per_buy_price, so the API does not claim a compatible range.

Example: 100000000

max_priceOptionalQuery · number, min: 0 | null

Unavailable effective range input for the same source-semantics reason as min_price.

Example: 200000000

sortOptionalQuery · string | null

Source sort query value, such as new or discount.

Example: new

pageOptionalQuery · integer, min: 1, default: 1

One-based source page. Offsets above the observed backend cap may return an upstream 404.

Example: 1

per_pageOptionalQuery · integer, min: 1, default: 30

Number of source records requested; passed through to the source without an invented local maximum.

Example: 10

Response

page?integer | null
itemsobject[]
items[].sku?string | null
items[].metal?object
items[].metal.karat?number | integer | null
items[].metal.details?string | null
items[].price?number | integer | null
items[].title?string | null
items[].images?object[]
items[].images[].id?integer | null
items[].images[].urlstring
items[].images[].sort_order?integer | null
items[].category?string | null
items[].currency?string | null
items[].gemstone?object
items[].gemstone.kind?string | null
items[].gemstone.type?string | null
items[].gemstone.color?string | null
items[].gemstone.count?number | integer | null
items[].gemstone.weight?number | integer | null
items[].material?string | null
items[].variants?object[]
items[].variants[].sku?string | null
items[].variants[].size?number | integer | null
items[].variants[].brand?string | null
items[].variants[].color?string | null
items[].variants[].stone?object
items[].variants[].stone.kind?string | null
items[].variants[].stone.type?string | null
items[].variants[].stone.color?string | null
items[].variants[].stone.count?number | integer | null
items[].variants[].stone.weight?number | integer | null
items[].variants[].title?string | null
items[].variants[].weight?number | integer | null
items[].variants[].barcode?string | null
items[].variants[].available?boolean | null
items[].variants[].variant_id?string | null
items[].variants[].weight_unit?string | null
items[].collection?string | null
items[].dimensions?object
items[].dimensions.size?number | integer | null
items[].dimensions.weight?number | integer | null
items[].dimensions.weight_unit?string | null
items[].price_kind?string | null
items[].product_id?string | null
items[].sale_price?number | integer | null
items[].variant_id?string | null
items[].description?string | null
items[].availability?boolean | null
items[].retrieved_atstring
items[].sale_display?string | null
items[].canonical_url?string | null
items[].original_price?number | integer | null
items[].discount_percent?number | integer | null
items[].original_display?string | null
items[].available_options?object
items[].available_options.sizes?number | integer[]
items[].available_options.colors?string[]
total?integer | null
has_more?boolean, default: false
per_page?integer | null
last_page?integer | null
next_page?integer | null

Fields marked ? are optional.

GETProducts by product id/v1/products/{product_id}

Retrieves one product from Sadati's observed GET /api/products/{id} JSON endpoint. The ID is the catalog record ID returned by the listing route.

Input

product_idRequiredPath · string

Sadati product record ID from /v1/products.

Example: 41499

Response

sku?string | null
metal?object
metal.karat?number | integer | null
metal.details?string | null
price?number | integer | null
title?string | null
images?object[]
images[].id?integer | null
images[].urlstring
images[].sort_order?integer | null
category?string | null
currency?string | null
gemstone?object
gemstone.kind?string | null
gemstone.type?string | null
gemstone.color?string | null
gemstone.count?number | integer | null
gemstone.weight?number | integer | null
material?string | null
variants?object[]
variants[].sku?string | null
variants[].size?number | integer | null
variants[].brand?string | null
variants[].color?string | null
variants[].stone?object
variants[].stone.kind?string | null
variants[].stone.type?string | null
variants[].stone.color?string | null
variants[].stone.count?number | integer | null
variants[].stone.weight?number | integer | null
variants[].title?string | null
variants[].weight?number | integer | null
variants[].barcode?string | null
variants[].available?boolean | null
variants[].variant_id?string | null
variants[].weight_unit?string | null
collection?string | null
dimensions?object
dimensions.size?number | integer | null
dimensions.weight?number | integer | null
dimensions.weight_unit?string | null
price_kind?string | null
product_id?string | null
sale_price?number | integer | null
variant_id?string | null
description?string | null
availability?boolean | null
retrieved_atstring
sale_display?string | null
canonical_url?string | null
original_price?number | integer | null
discount_percent?number | integer | null
original_display?string | null
available_options?object
available_options.sizes?number | integer[]
available_options.colors?string[]

Fields marked ? are optional.

GETFacets/v1/facets

Returns source category/brand endpoint results and a clearly marked non-exhaustive sample of facet-like values from the first 100 live records. The upstream reports 3,836 records but offsets above roughly 3,000 have returned 404, so exhaustive facet enumeration is not claimed.

Input

No input parameters.

Response

notesstring[]
colorsstring[]
gemstonesstring[]
materialsstring[]
categoriesstring[]
exhaustiveboolean
collectionsstring[]
sample_sizeinteger
sort_ordersstring[]
availabilityboolean[]
source_total?integer | null

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.