GoodReturns APIgoodreturns.in ↗
Get daily, historical, and city-wise gold and silver prices in INR for India. Covers 18K, 22K, 24K purity across 10+ cities via 8 endpoints.
What is the GoodReturns API?
The GoodReturns.in API exposes 8 endpoints for retrieving gold and silver prices in India, denominated in INR. It covers today's rates, a 10-day price history, and city-wise comparisons across 10+ major Indian cities. The get_india_precious_metals_summary endpoint returns a flat, automation-friendly JSON object with gold prices at multiple gram weights and purity levels, plus a natural-English market summary sentence — no array parsing required.
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 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
Gold Rate Endpoints
get_india_gold_rates returns today's gold price in INR for 1g, 8g, 10g, and 100g weights across 18K, 22K, and 24K purity levels, along with the daily change amount for each. get_historical_rates provides the last 10 days of 22K and 24K rates with per-day change values, useful for short-term trend detection. get_city_wise_rates delivers current per-gram rates across 10+ cities — including Chennai, Mumbai, Delhi, Kolkata, Bangalore, and Hyderabad — for all three purity levels in a single call.
City-Specific and Combined Endpoints
get_city_historical_summary accepts an optional city parameter (lowercase, e.g. bangalore, pune) and returns 6–7 months of monthly summaries per city, including opening rate, closing rate, highest and lowest rates with dates, and a trend percentage for both 22K and 24K. get_city_precious_metals_rates requires a city parameter and returns both gold (1g, 8g, 10g, 100g at all purity levels) and silver (1g, 10g, 100g, 1kg) for that city in one response.
Silver and Combined Metal Endpoints
get_india_silver_rates returns today's national silver price for four weight tiers (1g, 10g, 100g, 1kg) with daily change amounts. get_india_precious_metals_rates combines gold and silver into one response and includes a UTC last_updated ISO 8601 timestamp and a source attribution string. get_india_precious_metals_summary goes further by flattening all gold and silver data into a single JSON object keyed by gram weight and purity — fields like gold.gram_10.price_22k and silver.kilogram.price — alongside a market_summary string describing daily movement in plain English.
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?+
- Track daily 22K and 24K gold price movements across a 10-day window using
get_historical_ratesfor trend alerting. - Compare current gold rates across Chennai, Mumbai, Delhi, and other cities to identify regional price differentials.
- Feed a flat JSON object of all precious metal prices into a spreadsheet or database using
get_india_precious_metals_summary. - Display city-specific gold and silver prices in a local finance app using
get_city_precious_metals_rateswith acityparameter. - Generate monthly gold price reports per city (open, close, high, low, trend) using
get_city_historical_summary. - Monitor sovereign gold bond (8g) pricing changes by reading the
gram_8fields from the summary endpoint. - Power a precious metals portfolio tracker with multi-purity INR valuations for both gold and silver.
| 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 GoodReturns.in have an official developer API?+
What does `get_india_precious_metals_summary` return that the other endpoints don't?+
get_india_precious_metals_summary returns all gold and silver data as a single flat JSON object rather than arrays. Gold fields are keyed like gold.gram_10.price_22k and gold.gram_10.change_22k; silver fields follow the same pattern with price and change integers. It also includes a market_summary string — a natural-English sentence describing the day's price movement for 22K gold, 24K gold, and silver per gram — and a date field in YYYY-MM-DD format.How far back does the historical data go?+
get_historical_rates covers the last 10 days of national 22K and 24K rates. get_city_historical_summary provides monthly summaries for approximately 6–7 recent months per city. Neither endpoint supports arbitrary date ranges or pagination beyond these windows.