Get a full Indian stock detail record by company name: BSE and NSE prices, financials, key metrics, analyst view, shareholding and recent news.

View all Indian Stock Exchange API endpoints →

Looks up one Indian listed company by name and returns a single JSON object with its detail record. The only input is the required query parameter name, which takes a full company name, a shortened name or a common name for the stock; the documented sample request uses Reliance and the catalog default is tata steel. No ticker or BSE scrip code is needed. Observed in a live probe for name=tata steel (HTTP 200): companyName, industry, currentPrice with BSE and NSE values (returned as strings), percentChange, yearHigh and yearLow, stockTechnicalData (six rows for 5, 10, 20, 50, 100 and 300 days, each with bsePrice and nsePrice), companyProfile (companyDescription, mgIndustry, isInId, exchangeCodeBse, exchangeCodeNse, officers and peerCompanyList), financials (19 period entries with stockFinancialMap keyed CAS, BAL and INC, FiscalYear, EndDate and an Annual or Interim Type), keyMetrics (eight groups: mgmtEffectiveness, margins, financialstrength, valuation, incomeStatement, growth, persharedata, priceandVolume), analystView (rating rows from Strong Buy to Strong Sell plus a Total row, with analyst counts now and 1 week, 1, 2 and 3 months ago), recosBar (rating bands, noOfRecommendations, meanValue, tickerPercentage), riskMeter (categoryName and stdDev), shareholding (four holder categories with dated percentages), stockCorporateActionData (bonus, dividend, rights, splits, annualGeneralMeeting, boardMeetings), stockDetailsReusableData (a quote block with date, time, price, marketCap and valuation ratios), stockFinancialData and recentNews (ten articles with headline, date, summary and url). In that probe futureExpiryDates, futureOverviewData and initialStockFinancialData were null, and the refresh-status fields inside companyProfile were present but null. The documentation also shows a top-level tickerId and numeric prices, but the probe response had no top-level tickerId and its prices were strings, so treat those documented sample details as unverified. The data is an informational market snapshot, not an execution or licensed tick feed.

API Features

Company name in, full record out One required name parameter accepts a full name, a shortened name or a common name such as tata steel or Reliance, so an app does not need a ticker master table or BSE scrip lookup before it can fetch data.
BSE and NSE prices in one object currentPrice carries separate BSE and NSE values, and stockTechnicalData adds six rows for 5, 10, 20, 50, 100 and 300 days with bsePrice and nsePrice, so both exchanges can be compared without a second request.
Annual and interim financial statements The financials array held 19 period entries in the probe, each with a stockFinancialMap keyed CAS, BAL and INC, a FiscalYear, an EndDate and an Annual or Interim Type for building statement tables.
Eight key-metric groups keyMetrics splits ratios into mgmtEffectiveness, margins, financialstrength, valuation, incomeStatement, growth, persharedata and priceandVolume lists, so a screen can pick the group it needs instead of parsing a flat blob.
Analyst view with rating history analystView lists Strong Buy, Buy, Hold, Sell, Strong Sell and Total rows with analyst counts for the latest reading and 1 week, 1, 2 and 3 months ago, while recosBar adds the mean rating and number of recommendations.
Shareholding, risk meter and corporate actions The same record includes dated shareholding percentages for promoter, FII, mutual fund and other holders, a riskMeter category with stdDev, and bonus, dividend, rights, split, AGM and board meeting lists.
Recent news in the same response recentNews returned ten articles in the probe, each with headline, date, timeToRead, summary and url, so a company card can show context next to the numbers.

Live API Demo

GET /api/project/indian-stock-exchange-api/get-stock-data-by-name

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/get-stock-data-by-name?key=<API_KEY>&name=tata+steel'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What does the name parameter accept?

name is required and takes a full company name, a shortened name or a common name for the stock. The catalog default is tata steel, which returned HTTP 200 in a probe, and the documented sample request uses Reliance. Passing a ticker symbol or a BSE scrip code is not described in the documentation, so test those inputs yourself before depending on them.

What happens if the name matches nothing or several companies?

The supplied evidence does not document a not-found response or a disambiguation rule, and only the tata steel call was probed. Check the status code and the presence of companyName in your client, and consider confirming the company through the stock search endpoint when the input is user-typed free text.

Which price fields does the response include and in what format?

currentPrice has BSE and NSE members, percentChange, yearHigh and yearLow sit at the top level, and stockTechnicalData holds bsePrice and nsePrice for 5, 10, 20, 50, 100 and 300 days. In the probe these prices were strings such as decimal text, whereas the documentation sample shows numbers, so parse them defensively.

Is there a top-level tickerId in the response?

The documentation sample shows tickerId at the top level, but the probed response for tata steel did not have one. Identifiers that were present are companyProfile.exchangeCodeNse, companyProfile.exchangeCodeBse and companyProfile.isInId, and each peerCompanyList entry carries its own tickerId.

Why are futureExpiryDates and futureOverviewData null?

In the probe for tata steel, futureExpiryDates, futureOverviewData and initialStockFinancialData came back null. The documentation lists them as futures-related sections without saying when they are filled, so treat them as optional and check for null before reading them.

Is the data real time and can I trade on it?

No guarantee is documented. stockDetailsReusableData includes date and time fields for the quote block, but update frequency is not stated. Use the response as an informational market snapshot for dashboards, bots and research, not as an execution feed or a licensed tick source.

Where do I get price history or analyst estimates for the same company?

This endpoint returns a current snapshot with short price-by-days rows only. Longer price series, quarterly and yearly statistics and forward-looking estimates are served by separate endpoints in this catalog, such as historical data, historical stats and stock forecasts.

Related operations

Guides

View Subscription Plans →