csr.gov.in APIcsr.gov.in ↗
Access India's National CSR Portal data: company expenditures, project details, state-wise and sector-wise breakdowns, and top spenders by financial year.
curl -X GET 'https://api.parse.bot/scraper/13375483-360b-446f-9741-22e73dcd9c0d/search_companies?keyword=Reliance' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for companies by name keyword. Returns matching company names and their Corporate Identity Numbers (CIN).
| Param | Type | Description |
|---|---|---|
| keywordrequired | string | Company name search keyword (minimum 3 characters) |
{
"type": "object",
"fields": {
"total": "integer count of matching companies",
"keyword": "string echoing the search keyword",
"companies": "array of objects with cin (string) and company (string)"
},
"sample": {
"data": {
"total": 155,
"keyword": "Reliance",
"companies": [
{
"cin": "U65999MH2007PTC168431",
"company": "Reliance Consolidated Holdings Privatelimited"
},
{
"cin": "U65910MH1986PLC041081",
"company": "Reliance Industrial Investments And Holdings Limited"
}
]
},
"status": "success"
}
}About the csr.gov.in API
This API exposes 7 endpoints covering India's National CSR Portal at csr.gov.in, giving programmatic access to corporate social responsibility expenditures, project-level details, and aggregate breakdowns. Use search_companies to look up any registered company by name and retrieve its CIN, then pull full project-level spending data including sector, state, district, and implementing mode via company_csr_details. Summary statistics, state-wise totals, and sector-wise allocations are also available.
Company Search and Project-Level Data
The search_companies endpoint accepts a keyword (minimum 3 characters) and returns an array of matching companies, each with a company name and cin (Corporate Identity Number). That CIN is the key input for company_csr_details, which returns a projects array where each entry includes sector, state, district, mode (implementing mode), csr_prjct (project name), and amnt_spent. The endpoint also surfaces total_projects and total_amount_spent in rupees. Both endpoints accept an optional fy parameter in the format FY YYYY-YY (e.g., FY 2023-24).
Aggregate and Ranking Data
top_companies returns the ten highest CSR spenders for a given financial year, with each entry carrying rank, company_name, cin, and amount_spent. csr_summary gives a single-object snapshot of a full year: total_companies, total_projects, total_states, total_sectors, and total_amount_spent. Both endpoints default to a recent financial year when fy is omitted.
Sector and State Breakdowns
state_wise_spending returns an array of {state, amount_spent} pairs covering all states and union territories with recorded CSR activity. sector_wise_spending returns {sector, short_name, amount_spent} for each development sector — spanning categories like education, health, environment, and rural development. Both are scoped per financial year via the same optional fy parameter.
Financial Year Coverage
The financial_years endpoint returns the complete list of available years as an array of strings in FY YYYY-YY format, with a total count. Use this before constructing queries to confirm which years have data rather than guessing valid values.
- Track year-over-year CSR spending trends for a specific company using its CIN across multiple financial years.
- Build a state-level CSR investment heatmap using
state_wise_spendingamount data. - Identify which development sectors receive the most CSR funding via
sector_wise_spending. - Benchmark a company's CSR spend against the
top_companiesleaderboard for the same financial year. - Screen companies by CSR project geography — filtering
company_csr_detailsresults bystateordistrict. - Generate annual CSR compliance reports by pulling
csr_summarytotals across consecutive financial years. - Populate a company directory with CSR metadata by resolving names to CINs via
search_companiesand enriching with project counts.
| 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 csr.gov.in have an official developer API?+
What does `company_csr_details` return at the project level?+
csr_prjct (project name), sector, state, district, mode (the implementing mode, such as direct or through an implementing agency), and amnt_spent in rupees. The endpoint also returns total_projects and total_amount_spent as summary fields for the queried company and financial year.Does the API return CSR obligation or prescribed amounts, not just amounts spent?+
amount_spent figures. Prescribed CSR obligation amounts (the 2% net-profit requirement figure) and unspent CSR amounts are not included in the response fields. You can fork this API on Parse and revise it to add endpoints that surface obligation and unspent data if those fields become available on the source portal.How do I know which financial years have data available?+
financial_years endpoint first. It returns a financial_years array of all valid year strings in FY YYYY-YY format and a total count. Pass any value from that list as the fy parameter in other endpoints. Using a year string not in that list may return empty or default results.Does the API support pagination for large company or project result sets?+
search_companies returns all matches for a keyword, and company_csr_details returns all projects for a company in a given year in a single response. For companies with large project counts, the full array is returned at once. You can fork this API on Parse and revise it to add limit/offset parameters if needed.