LiveMint API

The LiveMint API provides detailed financial data for companies listed on the BSE and NSE. This API allows users to retrieve company profiles, stock prices, technical data, financials, key metrics, analyst views, shareholding patterns, corporate actions, and recent news.

The LiveMint API provides detailed financial data for companies listed on the Bombay Stock Exchange (BSE) and National Stock Exchange (NSE), empowering users with comprehensive insights into the dynamic Indian stock market. This powerful API allows investors, financial analysts, and developers to access a wealth of information essential for making informed investment decisions and conducting thorough research.

Unlock the potential of the Indian stock market with LiveMint API's extensive features, including:

Company Profiles: Dive deep into the profiles of Indian companies, gaining valuable insights into their background, history, and industry presence.
Stock Prices: Stay up-to-date with real-time stock prices for both BSE and NSE listings, ensuring you never miss a market movement.
Technical Data: Access detailed technical analysis data for Indian stocks, enabling you to assess performance and trends with precision.
Financials: Explore financial statements and data for Indian companies, including income statements, balance sheets, and cash flow statements.
Key Metrics: Evaluate key financial ratios and metrics specific to the Indian stock market, such as profitability, liquidity, and solvency.
Analyst Views: Stay informed with expert analyst views and recommendations tailored to Indian stocks, helping you understand market sentiment and investment opportunities.
Shareholding Patterns: Gain insights into shareholding patterns of Indian companies, including institutional holdings, promoter holdings, and public shareholding structures.
Corporate Actions: Track corporate actions such as dividends, stock splits, mergers, and acquisitions in the Indian market, staying informed about events that may impact stock prices.
Recent News: Access the latest news articles related to Indian companies, industries, and market developments, ensuring you're always in the know.

API Documentation

Endpoints

Get Company Data by Name

Endpoint: `/stock`

Method: GET

Description: Retrieve detailed financial data for a specific company using its name. The API supports full names, shortened names or any search terms that livemint search supports.

Parameters:

name (required, string): The name, shortened name, or any search term livemint allows.

Sample Request

GET /company?name=Reliance

Sample Response


{
"tickerId": "S0003018",
"companyName": "Reliance Industries Limited",
"industry": "Oil & Gas Operations",
"companyProfile": {
// ... detailed company profile data
},
"currentPrice": {
"BSE": 2200.50,
"NSE": 2195.75
},
"stockTechnicalData": {
// ... technical data
},
"percentChange": 1.25,
"yearHigh": 2400.00,
"yearLow": 1800.00,
"financials": {
// ... financial data
},
"keyMetrics": {
// ... key metrics
},
"futureExpiryDates": [
"2024-06-28",
"2024-07-26",
// ... more dates
],
"futureOverviewData": {
// ... future overview data
},
"initialStockFinancialData": {
// ... initial financial data
},
"analystView": {
// ... analyst views
},
"recosBar": {
// ... recommendations bar data
},
"riskMeter": {
// ... risk meter data
},
"shareholding": {
// ... shareholding data
},
"stockCorporateActionData": {
// ... corporate action data
},
"stockDetailsReusableData": {
// ... reusable stock details data
},
"recentNews": [
// ... news articles
]
}

Detailed Description of Structured Data

tickerId: The unique identifier for the stock (e.g., "RELIANCE").
companyName: The full name of the company.
industry: The industry in which the company operates.
companyProfile: Detailed information about the company.
currentPrice: Current stock prices for BSE and NSE.

BSE: Current price on BSE.
NSE: Current price on NSE.

stockTechnicalData: Technical analysis data of the stock.
percentChange: Percentage change in stock price.
yearHigh: Highest price of the stock in the past year.
yearLow: Lowest price of the stock in the past year.
financials: Financial statements and data of the company.
keyMetrics: Key financial ratios and metrics.
futureExpiryDates: Dates of future contract expiries.
futureOverviewData: Overview data of futures contracts.
initialStockFinancialData: Initial financial data of the stock.
analystView: Analyst recommendations and views.
recosBar: Data showing analyst recommendations.
riskMeter: Risk assessment data.
shareholding: Shareholding patterns.
stockCorporateActionData: Information on corporate actions.
stockDetailsReusableData: Reusable data details for the stock.
recentNews: Recent news articles related to the company.

                                                                            
GET https://zylalabs.com/api/4204/livemint+api/5100/get+company+data+by+name

Get Company Data by Name - Endpoint Features

Object	Description
`name`	[Required] The name, shortened name, or any search term livemint allows.

Test Endpoint

API EXAMPLE RESPONSE

       
                                                                                                        
                                                                                                                                                                                                                            {
    "tickerId": "RELIANCE",
    "companyName": "Reliance Industries Limited",
    "industry": "Conglomerate",
    "companyProfile": {
        "tickerId": "S0003018",
        "companyName": "Reliance Industries",
        "industry": "Oil & Gas Operations"
    },
    "currentPrice": {
        "BSE": 2200.50,
        "NSE": 2195.75
    },
    "stockTechnicalData": {
    },
    "percentChange": 1.25,
    "yearHigh": 2400.00,
    "yearLow": 1800.00,
    "financials": {
    },
    "keyMetrics": {
    },
    "futureExpiryDates": [
        "2024-06-28",
        "2024-07-26"
    ],
    "futureOverviewData": {
    },
    "initialStockFinancialData": {
    },
    "analystView": {
    },
    "recosBar": {
    },
    "riskMeter": {
    },
    "shareholding": {
    },
    "stockCorporateActionData": {
    },
    "stockDetailsReusableData": {
    },
    "recentNews": [
    ]
}

Get Company Data by Name - CODE SNIPPETS


curl --location --request GET 'https://zylalabs.com/api/4204/livemint+api/5100/get+company+data+by+name?name=Required' --header 'Authorization: Bearer YOUR_API_KEY'

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the LiveMint API REST API, simply include your bearer token in the Authorization header.

Headers

Header	Description
`Authorization`	[Required] Should be `Bearer access_key`. See "Your API Access Key" above when you are subscribed.

Simple Transparent Pricing

No long term commitments. One click upgrade/downgrade or cancellation. No questions asked.

Monthly Annually

(Save 2 months with annual billing 🎉)