Joias Nagalli APIjoiasnagalli.com.br ↗
Access Nagalli's wholesale sterling silver 925 rings catalog via API. Retrieve product IDs, names, image URLs, and pagination across the full collection.
What is the Joias Nagalli API?
The Joias Nagalli API provides access to the wholesale sterling silver 925 rings catalog from joiasnagalli.com.br through 1 endpoint, returning up to 5 fields per ring. The list_rings endpoint retrieves product IDs, names, product URLs, and image URLs across a paginated catalog, with controls for page number, sort order, and per-page item count.
curl -X GET 'https://api.parse.bot/scraper/47935887-e116-4e47-8181-09070797e09c/list_rings?page=1&sort=default&limit=100' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace joiasnagalli-com-br-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Nagalli SDK — bounded, re-runnable; every call capped."""
from parse_apis.joiasnagalli_com_br_api import Nagalli, Sort, ParseError
client = Nagalli()
# List rings sorted by name, capped at 3 total items
for ring in client.rings.list(sort=Sort.NAME_ASC, limit=3):
print(ring.name, ring.url)
# Take the first ring from the default sort
first = client.rings.list(limit=1).first()
if first:
print(first.product_id, first.name, first.image)
# Typed error handling around a list call
try:
for ring in client.rings.list(sort=Sort.PRICE_ASC, limit=2):
print(ring.name, ring.product_id)
except ParseError as e:
print(f"error: {e}")
print("exercised: rings.list")
List all wholesale silver 925 rings from the Nagalli catalog. Results are auto-iterated across pages. Each ring includes its product ID, name, product URL, and image URL. Prices are not publicly visible (require login).
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| sort | string | Sort order for results. |
| limit | integer | Number of rings per page. Accepted values: 16, 25, 50, 75, 100. |
{
"type": "object",
"fields": {
"page": "current page number",
"limit": "items per page",
"rings": "array of ring objects with product_id, name, url, image",
"total": "total number of rings in catalog",
"total_pages": "total number of pages"
},
"sample": {
"data": {
"page": 1,
"limit": 100,
"rings": [
{
"url": "https://www.joiasnagalli.com.br/atacado/aneis-prata925-atacado/an0309-09-anel-falange-regulável-pontos-de-luz-prata925-atacado",
"name": "Anel Falange Regulável em Prata 925 Pontos de Luz",
"image": "https://www.joiasnagalli.com.br/atacado/image/cache/catalog/produtos/ANEL/an0309-capa-500x500.jpg",
"product_id": "3188"
}
],
"total": 101,
"total_pages": 2
},
"status": "success"
}
}About the Joias Nagalli API
What the API Returns
The list_rings endpoint exposes Nagalli's wholesale sterling silver 925 rings catalog. Each ring object in the response includes a product_id, name, url (linking to the product page on joiasnagalli.com.br), and image URL. The response also surfaces catalog-level metadata: total (total rings available), total_pages, page (current page), and limit (items returned per page).
Pagination and Filtering
Results are paginated using a 1-based page parameter. The limit parameter accepts discrete values — 16, 25, 50, 75, or 100 — controlling how many rings appear per response. A sort parameter is accepted to order results. Iteration across the full catalog is supported by checking total_pages and incrementing page accordingly.
Coverage Notes
This API covers the atacado (wholesale) silver 925 rings section of the Nagalli catalog. Prices are not included in responses because they require a logged-in wholesale account on the source site. The catalog scope is limited to rings; other jewelry categories such as bracelets, earrings, or necklaces are not included in this API.
The Joias Nagalli API is a managed, monitored endpoint for joiasnagalli.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when joiasnagalli.com.br changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official joiasnagalli.com.br API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a wholesale jewelry sourcing tool that displays Nagalli's silver 925 ring catalog with names and images.
- Sync Nagalli ring product IDs and names into an internal inventory or product database.
- Monitor the total ring count over time to detect catalog additions or removals.
- Generate an image gallery of available wholesale rings by collecting all
imageURLs across pages. - Cross-reference Nagalli ring product URLs with other wholesale supplier catalogs for comparison.
- Automate catalog crawling using
total_pagesto iterate through the full ring inventory programmatically.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does joiasnagalli.com.br offer an official developer API?+
What does the list_rings endpoint return for each ring?+
product_id, name, url to the product page, and an image URL. The response also includes total, total_pages, page, and limit for navigating the catalog.Why are prices not included in the response?+
Does the API cover other jewelry categories beyond silver 925 rings?+
How does pagination work, and what page sizes are supported?+
page parameter. The limit parameter accepts values of 16, 25, 50, 75, or 100 items per page. Use total_pages from any response to determine how many requests are needed to cover the full catalog.