tradestat.commerce.gov.in APItradestat.commerce.gov.in ↗
Access India's Export Import Data Bank via 5 endpoints. Query commodity-wise, country-wise, and monthly trade stats by HS code, year, and currency.
curl -X GET 'https://api.parse.bot/scraper/6bc89ab4-56b1-4990-a960-086912f43fa2/get_commodity_wise_report' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch commodity-wise trade data for a given year. Returns a table of commodities with HS codes, trade values for two consecutive years, percentage share, and growth rate.
| Param | Type | Description |
|---|---|---|
| year | string | Financial year starting year (e.g., '2024' for 2024-2025). Available years: 2018 through 2024. |
| values_in | string | Currency or unit for values. Accepted values: 'US $ Million', '₹ Crore', 'Quantity'. |
| trade_type | string | Type of trade. Accepted values: 'exports', 'imports'. |
| commodity_level | string | HS code digit level. Accepted values: '2', '4', '6', '8'. |
{
"type": "object",
"fields": {
"data": "array of commodity objects with keys S.No., HSCode, Commodity, prior year value, %Share, current year value, %Growth"
},
"sample": {
"data": [
{
"S.No.": "1",
"%Share": "0.0045",
"HSCode": "01",
"%Growth": "59.17",
"Commodity": "LIVE ANIMALS.",
"2023 - 2024": "12.37",
"2024 - 2025": "19.70"
}
],
"status": "success"
}
}About the tradestat.commerce.gov.in API
This API provides structured access to India's Export Import Data Bank (EIDB and MEIDB) through 5 endpoints covering commodity-wise reports, country-wise summaries, HS code lookup, and monthly trade statistics. The get_commodity_wise_report endpoint alone returns HS codes at 2-, 4-, 6-, or 8-digit granularity alongside trade values, percentage share, and year-over-year growth for financial years 2018 through 2024.
Commodity and Country Trade Reports
The get_commodity_wise_report endpoint returns a ranked table of commodities identified by HS code and description, with trade values for two consecutive financial years, percentage share of total trade, and growth rate. You can filter by trade_type (exports or imports), commodity_level (HS digits: 2, 4, 6, or 8), and express values in US dollars (millions), Indian rupees (crore), or raw quantity. The get_country_wise_report endpoint mirrors this structure at the country level, adding a total_trade option for trade_type and returning Country/Region, prior and current year values, %Share, and %Growth per row.
Monthly Data and HS Code Search
The get_meidb_report endpoint targets the Monthly EIDB, letting you pin a specific month (1–12) and year and choose between Financial Year or Calendar Year framing. Response rows carry the same HS code and commodity columns as the annual report, plus monthly values for the prior and current year, a % Growth column, and cumulative-to-date figures. The search_hs_code endpoint accepts a partial numeric code (e.g., 10) or a plain-text keyword (e.g., rice) and returns matching HSCODE, DESCRiption, and UNIT fields — useful for resolving codes before passing them to the report endpoints.
Year Coverage and Metadata
The get_available_years endpoint returns the full list of supported financial years as value (e.g., '2024') and text (e.g., '2024-2025') pairs, so you can programmatically stay in sync with whatever years the EIDB currently publishes rather than hard-coding a range. All report endpoints accept the starting year of the financial year window as their year parameter.
- Track year-over-year export growth for a specific HS-8 commodity between India and all trading partners
- Compare India's import share by country for a given financial year using get_country_wise_report
- Resolve ambiguous commodity descriptions to exact HS codes before querying trade reports via search_hs_code
- Build a monthly trade dashboard showing cumulative export values across financial year months with get_meidb_report
- Identify the top commodities by percentage share of total exports at the HS-2 chapter level
- Convert trade values between USD millions and INR crore for domestic vs. international reporting pipelines
- Enumerate all available reporting years dynamically using get_available_years to keep queries current
| 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.