Sadati Jewellery Catalog API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 | nullFree-text source search across product records.
Example: میرو
categoryOptionalQuery · string | nullUnavailable source taxonomy filter; Sadati currently returns no category values.
Example: 1
collectionOptionalQuery · string | nullUnavailable source taxonomy filter; group is returned as a record field but is not a proven filter.
Example: 12194
materialOptionalQuery · string | nullUnavailable source taxonomy filter; brands endpoint is currently empty.
Example: gold
gemstoneOptionalQuery · string | nullUnavailable source taxonomy filter; gemstone values are nullable and no source filter is published.
Example: diamond
colorOptionalQuery · string | nullUnavailable source taxonomy filter; source color query returned 404 in a real probe.
Example: مطابق عکس
availabilityOptionalQuery · boolean | nullFilter to source-available (true) or unavailable (false) variants.
Example: true
min_priceOptionalQuery · number, min: 0 | nullUnavailable 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 | nullUnavailable effective range input for the same source-semantics reason as min_price.
Example: 200000000
sortOptionalQuery · string | nullSource sort query value, such as new or discount.
Example: new
pageOptionalQuery · integer, min: 1, default: 1One-based source page. Offsets above the observed backend cap may return an upstream 404.
Example: 1
per_pageOptionalQuery · integer, min: 1, default: 30Number of source records requested; passed through to the source without an invented local maximum.
Example: 10
Response
page?integer | nullitemsobject[]items[].sku?string | nullitems[].metal?objectitems[].metal.karat?number | integer | nullitems[].metal.details?string | nullitems[].price?number | integer | nullitems[].title?string | nullitems[].images?object[]items[].images[].id?integer | nullitems[].images[].urlstringitems[].images[].sort_order?integer | nullitems[].category?string | nullitems[].currency?string | nullitems[].gemstone?objectitems[].gemstone.kind?string | nullitems[].gemstone.type?string | nullitems[].gemstone.color?string | nullitems[].gemstone.count?number | integer | nullitems[].gemstone.weight?number | integer | nullitems[].material?string | nullitems[].variants?object[]items[].variants[].sku?string | nullitems[].variants[].size?number | integer | nullitems[].variants[].brand?string | nullitems[].variants[].color?string | nullitems[].variants[].stone?objectitems[].variants[].stone.kind?string | nullitems[].variants[].stone.type?string | nullitems[].variants[].stone.color?string | nullitems[].variants[].stone.count?number | integer | nullitems[].variants[].stone.weight?number | integer | nullitems[].variants[].title?string | nullitems[].variants[].weight?number | integer | nullitems[].variants[].barcode?string | nullitems[].variants[].available?boolean | nullitems[].variants[].variant_id?string | nullitems[].variants[].weight_unit?string | nullitems[].collection?string | nullitems[].dimensions?objectitems[].dimensions.size?number | integer | nullitems[].dimensions.weight?number | integer | nullitems[].dimensions.weight_unit?string | nullitems[].price_kind?string | nullitems[].product_id?string | nullitems[].sale_price?number | integer | nullitems[].variant_id?string | nullitems[].description?string | nullitems[].availability?boolean | nullitems[].retrieved_atstringitems[].sale_display?string | nullitems[].canonical_url?string | nullitems[].original_price?number | integer | nullitems[].discount_percent?number | integer | nullitems[].original_display?string | nullitems[].available_options?objectitems[].available_options.sizes?number | integer[]items[].available_options.colors?string[]total?integer | nullhas_more?boolean, default: falseper_page?integer | nulllast_page?integer | nullnext_page?integer | nullFields 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 · stringSadati product record ID from /v1/products.
Example: 41499
Response
sku?string | nullmetal?objectmetal.karat?number | integer | nullmetal.details?string | nullprice?number | integer | nulltitle?string | nullimages?object[]images[].id?integer | nullimages[].urlstringimages[].sort_order?integer | nullcategory?string | nullcurrency?string | nullgemstone?objectgemstone.kind?string | nullgemstone.type?string | nullgemstone.color?string | nullgemstone.count?number | integer | nullgemstone.weight?number | integer | nullmaterial?string | nullvariants?object[]variants[].sku?string | nullvariants[].size?number | integer | nullvariants[].brand?string | nullvariants[].color?string | nullvariants[].stone?objectvariants[].stone.kind?string | nullvariants[].stone.type?string | nullvariants[].stone.color?string | nullvariants[].stone.count?number | integer | nullvariants[].stone.weight?number | integer | nullvariants[].title?string | nullvariants[].weight?number | integer | nullvariants[].barcode?string | nullvariants[].available?boolean | nullvariants[].variant_id?string | nullvariants[].weight_unit?string | nullcollection?string | nulldimensions?objectdimensions.size?number | integer | nulldimensions.weight?number | integer | nulldimensions.weight_unit?string | nullprice_kind?string | nullproduct_id?string | nullsale_price?number | integer | nullvariant_id?string | nulldescription?string | nullavailability?boolean | nullretrieved_atstringsale_display?string | nullcanonical_url?string | nulloriginal_price?number | integer | nulldiscount_percent?number | integer | nulloriginal_display?string | nullavailable_options?objectavailable_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[]exhaustivebooleancollectionsstring[]sample_sizeintegersort_ordersstring[]availabilityboolean[]source_total?integer | nullFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.