How to scrape Yahoo Finance and extract stock market data using Python & LXML

Yahoo Finance is a good source for extracting financial data, be it – stock market data, trading prices or business-related news.

In this tutorial, we will extract the trading summary for a public company from Yahoo Finance ( like ). We’ll be extracting the following fields for this tutorial.

  1. Previous Close
  2. Open
  3. Bid
  4. Ask
  5. Day’s Range
  6. 52 Week Range
  7. Volume
  8. Average Volume
  9. Market Cap
  10. Beta
  11. PE Ratio
  12. EPS
  13. Earning’s Date
  14. Dividend & Yield
  15. Ex-Dividend Date
  16. 1yr Target EST

Below is a screenshot of what data we’ll be extracting from Yahoo Finance.

Scraping Logic

  1. Construct the URL of the search results page from Yahoo Finance. For example, here is the one for Apple-
  2. Download HTML of the search result page using Python Requests
  3. Parse the page using LXML – LXML lets you navigate the HTML Tree Structure using Xpaths. We have predefined the XPaths for the details we need in the code.
  4. Save the data to a JSON file.


Install Python 3 and Pip

Here is a guide to install Python 3 in Linux –

Mac Users can follow this guide –

Windows Users go here –


For this web scraping tutorial using Python 3, we will need some packages for downloading and parsing the HTML. Below are the package requirements:

The Code

You can download the code from the link if the embed above does not work.

If you would like the code in Python 2 check out this link

Running the Scraper

Assume the script is named If you type in the script name in command prompt or terminal with a  -h

python -h

usage: [-h] ticker

positional arguments:

optional arguments:
  -h, --help  show this help message and exit

The ticker argument is the ticker symbol or stock symbol to identify a company.

To find the stock data for Apple Inc we would put the argument like this:

 python3 aapl

This should create a JSON file called aapl-summary.json that will be in the same folder as the script.

The output file would look similar to this:

    "Previous Close": "139.52", 
    "Open": "138.92", 
    "Bid": "138.69 x 100", 
    "Ask": "139.01 x 4600", 
    "Day's Range": "138.82 - 139.80", 
    "52 Week Range": "89.47 - 140.28", 
    "Volume": "16,641,812", 
    "Avg. Volume": "28,451,631", 
    "Market Cap": "729.58B", 
    "Beta": "1.36", 
    "PE Ratio (TTM)": "16.69", 
    "EPS (TTM)": 8.33, 
    "Earnings Date": "2017-04-24 to 2017-04-28", 
    "Dividend & Yield": "2.28 (1.63%)", 
    "Ex-Dividend Date": "N/A", 
    "1y Target Est": 142.48, 
    "url": "", 
    "ticker": "aapl"

You can download the code at

Let us know in the comments how this scraper worked for you.

Known Limitations

This code should work for grabbing stock market data of most companies. However, if you want to scrape for thousands of pages and do it frequently  (say, multiple times per hour) there are some important things you should be aware of, and you can read about them at How to build and run scrapers on a large scale and How to prevent getting blacklisted while scraping.

If you need some professional help with scraping complex websites contact us by filling up the form below.

Tell us about your complex web scraping projects

Turn the Internet into meaningful, structured and usable data

Disclaimer: Any code provided in our tutorials is for illustration and learning purposes only. We are not responsible for how it is used and assume no liability for any detrimental usage of the source code. The mere presence of this code on our site does not imply that we encourage scraping or scrape the websites referenced in the code and accompanying tutorial. The tutorials only help illustrate the technique of programming web scrapers for popular internet websites. We are not obligated to provide any support for the code, however, if you add your questions in the comments section, we may periodically address them.

27 comments on “How to scrape Yahoo Finance and extract stock market data using Python & LXML


I tried running your code, but I keep getting hassled by a

SyntaxError: ‘return’ outside function

I think I have your indentation right. Is there any way to post the code somewhere so I can get it straight from the horse’s mouth?


If you don’t feel like writing a scraper I suggest looking at python’s yahoo-finance package. You can get all of the same data with a few lines of code.


Yahoo finance API is not available anymore. I have moved to MarketXLS after this change, much more reliable data.


    This is the problem with APIs – Scraping is the only option to gather such data without using an API that can restrict or get discontinued at any time.

future learn2

This code (raw_table_key = table_data.xpath(‘.//td[@class=”C(black)”]//text()’) is not working in python 2.7. So I have changed with this(raw_table_key = table_data.xpath(‘.//td[contains(@class,”C(black)”)]//text()’)). Anyway very nice code and helpful to me. Thanks.


Tried your code and I get :

Fetching data for aapl
Writing data to output file

when I go to the output file it is very limited:
“”: “172.29”,
“url”: “”,
“ticker”: “aapl”,
“1y Target Est”: 172.29,
“EPS (TTM)”: 8.808,
“Earnings Date”: “2017-10-23 to 2017-10-27”

Am I doing something wrong? I use Atom as my editor and running on a Macbook

Ira Fuchs

I am trying to use your code just to get a current price for securities. The slimmed down version looks like this:

from lxml import html
import requests
from exceptions import ValueError
from time import sleep
import json
import argparse
from collections import OrderedDict
from time import sleep

def parse(ticker):
url = “”%(ticker,ticker)
response = requests.get(url)
parser = html.fromstring(response.text)
summary_table = parser.xpath(‘//div[contains(@data-test,”summary-table”)]//tr’)
summary_data = OrderedDict()
other_details_json_link = “{0}?formatted=true&lang=en-US&region=US&modules=financialData”.format(ticker)
summary_json_response = requests.get(other_details_json_link)
json_loaded_summary = json.loads(summary_json_response.text)
return json_loaded_summary[“quoteSummary”][“result”][0][“financialData”][“currentPrice”][‘raw’]
except ValueError:
print “Failed to parse json response”
return {“error”:”Failed to parse json response”}

if __name__==”__main__”:
argparser = argparse.ArgumentParser()
argparser.add_argument(‘ticker’,help = ”)
args = argparser.parse_args()
ticker = args.ticker
print parse(ticker)

This works fine except for getting prices of ETFs (e.g. EFA, VWO).

Yahoo provides these prices but the data is slightly different. My question is how to modify your code to work with ETFs. Also, in writing this script how do you view the XML that needs to be parsed since it is dynamically created?


    I’m having the same issue. For ETFs, I get the “Failed to parse json response” error. Does anyone know how to get past this?

The Market Prophet

I’m having some trouble getting this working, getting an error on line 12:

C:\Python36\Scripts>python aapl
File “”, line 12
print “Parsing %s”%(url)
SyntaxError: invalid syntax

Any Ideas to fix this?


    The scraper is written in Python 2.7 and you are using 3.6. You can either install and run the script using python2.7.

    We’ll soon update this script to python 3

      The Market Prophet

      Wonderful, thank you! Got it going on 2.7. However, I’m having the same issue as Ahmet above, the output is limited to the following:
      “”: “189.48”,
      “url”: “”,
      “ticker”: “aapl”,
      “1y Target Est”: 189.48,
      “EPS (TTM)”: 9.21,
      “Earnings Date”: “2018-02-01”

      Additionally, I’d like to pull all data from the yahoo finance statistics page ( I tried simply swapping the URL but it didn’t do the trick so I suspect there’s more to it

      Any tips would be very appreciated!

        The Market Prophet

        Got it working with future learn2’s advice above and pulling all the data I wanted from the json link. Can’t seem to get Dividend data though – doesn’t seem to be in the json link. Any idea how to get dividend data?


          Hi there,
          Please follow the same pattern to identify the dividend field and modify the scraper to grab that or other fields.


          Actually the dividend is already extracted. In the above example
          “Dividend & Yield”: “2.28 (1.63%)“,


Is it possible to enter a list of tickers to have the program generate files for each ticker? Instead of doing it individually?


    Hi Matt,
    Sure you can enter the ticker symbols in a text file and write a python program to read that file line by line and pass the ticker to this program.
    A quick Google search for “Python read text file as input to script” can provide a lot of scripts or snippets for you.


Hi there,

I tried to run this function parse(ticker) using ticker = ‘APPL’ but when loading for this line:

other_details_json_link = ‘{0}?formatted=true&lang=en-US&region=US&modules=financialData’.format(‘APPL’)

Also tried this url:


I get: {‘quoteSummary’: {‘result’: None, ‘error’: {‘code’: ‘Not Found’, ‘description’: ‘Quote not found for ticker symbol: APPL’}}}

response is a 404 so I suspect this url doesn’t work anymore?




    Are you trying to find AAPL instead of APPL for Apple?


      Thank you very much ScrapeHero, this is perfect


      I’m curious how do you know what the modules are called that can be put into your query. Reason I ask is that for smaller stocks (ticker=’BG.VI’) I get back the following:

      {“quoteSummary”:{“result”:null,”error”:{“code”:”Not Found”,”description”:”No fundamentals data found for any of the summaryTypes=financialData,defaultKeyStatistics,summaryProfile,earnings,calendarEvents,upgradeDowngradeHistory,recommendationTrend”}}}

      If I could understand the query parameters better I might be able to tweak your code to get around this for myself.


How does one get the names of all the modules from which data can be extracted?
I am referring to the line of code setting the value of the variable “other_details_json_link”



Is the ‘print’ function the main difference between using Python 2.7 vs 3.6?

Jose Fernandes (@joseferpt)

I would like to scrap the Statistics and Analysis pages can you please share the code or indicate the changes to add in the code for the summary shared above? Thanks in advance.

Comments or Questions?

Turn the Internet into meaningful, structured and usable data