Gov APItradestat.commerce.gov.in ↗
Access India's Export Import Data Bank via 6 endpoints. Query commodity-wise, country-wise, and monthly trade stats by HS code, year, and trade type.
What is the Gov API?
This API exposes 6 endpoints covering India's Export Import Data Bank (EIDB and MEIDB), published by the Directorate General of Commercial Intelligence and Statistics. It returns commodity-wise and country-wise trade statistics, monthly bilateral trade flows, and HS code lookups. The get_commodity_wise_report endpoint, for example, delivers HS codes, trade values across two consecutive financial years, percentage share, and growth rates in a single paginated response.
curl -X GET 'https://api.parse.bot/scraper/6bc89ab4-56b1-4990-a960-086912f43fa2/get_commodity_wise_report?year=2024&values_in=US+%24+Million&trade_type=exports&commodity_level=2' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch commodity-wise trade data for a given financial year. Returns a table of commodities with HS codes, trade values for two consecutive years, percentage share, and growth rate. Paginates as a single page containing all matching rows at the requested HS-code digit level. When hs_code is provided, filters results to the single row matching that code.
| Param | Type | Description |
|---|---|---|
| year | string | Financial year starting year (e.g., '2024' for 2024-2025). Available values: 2018 through 2025. |
| hs_code | string | Optional HS code to filter results. When provided, only the row with a matching HSCode is returned. Should match the digit level specified by commodity_level (e.g., an 8-digit code when commodity_level is '8'). |
| values_in | string | Currency or unit for values. |
| trade_type | string | Type of trade. |
| commodity_level | string | HS code digit level. |
{
"type": "object",
"fields": {
"data": "array of commodity objects with keys S.No., HSCode, Commodity, prior year value, %Share, current year value, %Growth"
},
"sample": {
"data": {
"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 Gov API
Commodity and Country Trade Reports
The get_commodity_wise_report endpoint returns a ranked table of commodities filtered by commodity_level (2, 4, 6, or 8-digit HS codes), trade_type (exports or imports), year, and optional hs_code. Each row in the response includes HSCode, Commodity, prior-year value, current-year value, %Share, and %Growth. The get_country_wise_report endpoint offers the same two-year comparison but grouped by trading partner country, with an optional hs_code filter to drill into bilateral trade for a specific commodity. Both endpoints cover financial years 2018 through 2025, retrievable via get_available_years.
Monthly and FTSPCC Reports
get_meidb_report returns the Monthly EIDB report, comparing a selected month across two years plus cumulative period totals. Column headers in the response are dynamic — they reflect the selected month and year combination. The get_ftspcc_commodity_country_monthly_report endpoint targets FTSPCC (Foreign Trade Statistics) data: given a commodity code (e.g., A1 for TEA) and a numeric country code, it returns month-by-month rows covering Rs. Crores and US$ Millions values over a configurable date range from 2010 to 2026.
HS Code Search
The search_hs_code endpoint accepts a partial hs_code string or a keyword description and returns matching records with HSCODE, DESCRiption, and UNIT. This is useful for resolving commodity codes before passing them to the reporting endpoints. At least one of the two inputs should be provided for non-trivial results.
Coverage and Parameters
All monetary values can be requested in different currencies or units via the values_in parameter where supported. Financial year data uses the Indian convention (e.g., year=2024 maps to 2024-2025). The FTSPCC report uses a separate predefined commodity code scheme (A1, H8, etc.) distinct from standard HS codes used in the EIDB endpoints.
The Gov API is a managed, monitored endpoint for tradestat.commerce.gov.in — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tradestat.commerce.gov.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 tradestat.commerce.gov.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 year-over-year export growth for a specific HS code using
get_commodity_wise_reportwith%Growthfields - Identify India's top trading partners for a given commodity by combining
get_country_wise_reportwith anhs_codefilter - Build monthly trade trend charts using
get_meidb_reportacross multiple years and commodity levels - Resolve ambiguous commodity names to HS codes using
search_hs_codewith keyword descriptions - Analyze bilateral monthly trade volumes in both INR and USD for specific commodity-country pairs via
get_ftspcc_commodity_country_monthly_report - Compare India's import vs. export share for a commodity across financial years using the
%Sharefield - Identify which financial years have EIDB data available programmatically using
get_available_years
| 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 tradestat.commerce.gov.in have an official developer API?+
What does `get_country_wise_report` return when an `hs_code` is provided?+
hs_code is supplied, the endpoint filters the country-level breakdown to trade activity for that specific commodity. Each row in data represents a trading partner country with its prior-year value, current-year value, %Share, and %Growth for that commodity rather than for total trade.How does the FTSPCC commodity code differ from standard HS codes?+
get_ftspcc_commodity_country_monthly_report endpoint uses a separate principal commodity code scheme defined by FTSPCC (e.g., A1 for TEA, H8 for DRUG FORMULATIONS). These are not interchangeable with the numeric HS codes used in get_commodity_wise_report and get_meidb_report. You need to know the FTSPCC code for the commodity you want before calling this endpoint.Does the API provide port-wise or state-wise trade breakdowns?+
What is the earliest data available, and how current is it?+
get_commodity_wise_report, get_country_wise_report) cover financial years 2018 through 2025. The FTSPCC monthly report covers calendar years 2010 through 2026. Data freshness depends on when the source portal updates its published figures, which typically follows official trade release cycles.