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
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/indian-stock-exchange-api/get-stock-data-by-name 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'
Query Result
Use Cases
- Answer a Telegram or WhatsApp message such as Reliance share price with the BSE and NSE quotes side by side, using the free-text company name the user typed.
- Generate a one-page company brief for research notes that stitches financials, key metrics, analyst view and shareholding from a single call.
- Monitor the BSE versus NSE price gap for dual-listed names by comparing currentPrice.BSE with currentPrice.NSE on a schedule.
- Build a newsletter stock-of-the-day card that pairs recentNews headlines with the riskMeter category and the yearHigh and yearLow range.
- Enrich typed-in portfolio holdings with industry, year high and low, and exchange codes without maintaining your own ticker master table.
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.