GoodReturns APIgoodreturns.in ↗
Get daily, historical, and city-wise gold rates in India for 18k, 22k, and 24k purity via the GoodReturns API. Returns INR prices per gram across 4 endpoints.
What is the GoodReturns API?
The GoodReturns API provides 4 endpoints covering India gold rates across 18k, 22k, and 24k purity levels in INR. The get_india_gold_rates endpoint returns today's price, yesterday's price, and daily change for four standard weights (1g, 8g, 10g, 100g). Companion endpoints cover the last 10 days of historical rates, city-wise comparisons across major Indian metros, and monthly summaries with opening, closing, high, and low rates per city.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/cdcf99d0-b178-4dda-880c-6a531cfda453/get_india_gold_rates' \ -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 goodreturns-in-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.
from parse_apis.india_gold_rates_api__goodreturns_ import GoldRates, GoldRate, HistoricalRate, CityRate, MonthlySummary, RateRow
client = GoldRates()
# Get today's gold rates across all purities and weights
for rate in client.markets.today():
print(rate.gram, rate.today_24k, rate.today_22k, rate.change_24k)
# Get last 10 days of historical rates
for day in client.markets.history():
print(day.date, day.rate_24k, day.change_24k, day.rate_22k)
# Get city-wise rates and drill into a city's history
for city_rate in client.markets.by_city():
print(city_rate.city, city_rate.rate_24k, city_rate.rate_22k, city_rate.rate_18k)
# Construct a specific city and get its monthly historical summary
mumbai = client.cityrate("Mumbai")
for summary in mumbai.historical_summary():
print(summary.month)
for row in summary.data:
print(row.label, row.rate_24k, row.change_24k)
Extract today's gold prices in INR for 18K, 22K, and 24K purity levels in India. Returns rates for 1g, 8g, 10g, and 100g weights with today's price and the daily change amount for each purity. Single-page response keyed by gram weight.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of rate objects, each containing gram weight and today's rate plus change for 24K, 22K, and 18K"
},
"sample": {
"data": {
"items": [
{
"gram": "1",
"today_18k": 11164,
"today_22k": 13645,
"today_24k": 14886,
"change_18k": "(-323)",
"change_22k": "(-395)",
"change_24k": "(-430)"
},
{
"gram": "10",
"today_18k": 111640,
"today_22k": 136450,
"today_24k": 148860,
"change_18k": "(-3,230)",
"change_22k": "(-3,950)",
"change_24k": "(-4,300)"
}
]
},
"status": "success"
}
}About the GoodReturns API
Daily and Historical Gold Rates
get_india_gold_rates returns current gold prices across three purity levels — 18K, 22K, and 24K — each as an array of rate objects segmented by gram weight (1g, 8g, 10g, 100g). Each object includes today's price, yesterday's price, and the daily change in INR. get_historical_rates extends this to the trailing 10 days, returning per-day entries with a date label (e.g. May 07, 2026) and rate plus change values for both 22K and 24K gold.
City-Wise and Monthly Summary Data
get_city_wise_rates returns per-gram gold prices for 18K, 22K, and 24K gold across major Indian cities — fields are City, 18K Today, 22K Today, and 24K Today. This makes it straightforward to compare rates between metros like Mumbai, Delhi, Chennai, and Bangalore in a single call. get_city_historical_summary accepts an optional city parameter (lowercase city name) and returns monthly summaries including opening rate, closing rate, highest and lowest rates, and price trend for 22K and 24K gold. Verified cities include bangalore, mumbai, delhi, chennai, hyderabad, kolkata, and pune.
Coverage Notes
All prices are denominated in Indian Rupees (INR). The historical endpoint covers the last 10 days at the national level; city-level history is available in monthly granularity via get_city_historical_summary. The 18K purity level is available in the daily national and city-wise endpoints but is not included in the 10-day historical endpoint, which is limited to 22K and 24K.
The GoodReturns API is a managed, monitored endpoint for goodreturns.in — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when goodreturns.in 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 goodreturns.in 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?+
- Display a real-time gold rate ticker for 22k and 24k on an Indian fintech or investment app
- Alert users when the daily gold price change from
get_india_gold_ratescrosses a set threshold - Build a city price comparison table using
get_city_wise_ratesto show where gold is cheapest across Indian metros - Plot a 10-day gold price trend chart using date and rate fields from
get_historical_rates - Generate monthly gold price reports per city using opening, closing, high, and low fields from
get_city_historical_summary - Power a gold loan or jewelry pricing calculator using per-gram rates at different purity levels and weights
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does GoodReturns have an official developer API?+
What does `get_city_historical_summary` return, and how do I select a city?+
city parameter as a lowercase string — verified values include bangalore, mumbai, delhi, chennai, hyderabad, kolkata, and pune. If omitted, the endpoint may default to a general or national summary.Does the 10-day historical endpoint include 18K gold rates?+
get_historical_rates returns data only for 22K and 24K purity levels. The 18K purity level appears in get_india_gold_rates (daily national) and get_city_wise_rates (city-wise per gram) but is not part of the historical response. You can fork this API on Parse and revise it to add an 18K historical endpoint if that data is available on the source.Is silver, platinum, or any other commodity covered?+
How granular is the city-level historical data?+
get_city_historical_summary returns data at monthly granularity — one summary row per month showing open, close, high, and low. It does not provide day-by-day city-level rates. The daily breakdown is available at the national level only via get_historical_rates. You can fork this API on Parse and revise it to extract finer-grained city historical data if it is accessible on the source site.