goodreturns.in 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.
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'
Extract daily gold prices in INR for 18k, 22k, and 24k gold purity levels for India. Returns rates for 1g, 8g, 10g, and 100g weights with today's price, yesterday's price, and the daily change.
No input parameters required.
{
"type": "object",
"fields": {
"18K": "array of rate objects for 18 karat gold at different gram weights",
"22K": "array of rate objects for 22 karat gold at different gram weights",
"24K": "array of rate objects for 24 karat gold at different gram weights"
},
"sample": {
"data": {
"18K": [
{
"Gram": "1",
"Today": 11475,
"Change": "+ ₹61",
"Yesterday": 11414
}
],
"22K": [
{
"Gram": "1",
"Today": 14025,
"Change": "+ ₹80",
"Yesterday": 13945
}
],
"24K": [
{
"Gram": "1",
"Today": 15300,
"Change": "+ ₹87",
"Yesterday": 15213
}
]
},
"status": "success"
}
}About the goodreturns.in 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.
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.
- 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 | 250 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.