Scraping for Journalists (2nd edition)
Scraping for Journalists (2nd edition)
How to grab information from hundreds of sources, put it in data you can interrogate - and still hit deadlines
About the Book
Scraping - getting a computer to capture information from online sources - is one of the most powerful techniques for data-savvy journalists who want to get to the story first, or find exclusives that no one else has spotted. Faster than FOI and more detailed than advanced search techniques, scraping also allows you to grab data that organisations would rather you didn’t have - and put it into a form that allows you to get answers.
Scraping for Journalists introduces you to a range of scraping techniques - from very simple scraping techniques which are no more complicated than a spreadsheet formula, to more complex challenges such as scraping databases or hundreds of documents. At every stage you'll see results - but you'll also be building towards more ambitious and powerful tools.
You’ll be scraping within 5 minutes of reading the first chapter - but more importantly you'll be learning key principles and techniques for dealing with scraping problems.
Unlike general books about programming languages, everything in this book has a direct application for journalism, and each principle of programming is related to their application in scraping for newsgathering. And unlike standalone guides and blog posts that cover particular tools or techniques, this book aims to give you skills that you can apply in new situations and with new tools.
Bundles that include this book
Table of Contents
-
1. Introduction
- Your own robot
- A book about not reading books
- I’m not a programmer
- PS: This isn’t a book
-
2. Scraper #1: Start scraping in 5 minutes
- How it works: functions and parameters
- What are the parameters? Strings and indexes
- Tables and lists?
- Recap
- Tests
-
3. Scraper #2: What happens when the data isn’t in a table?
- Strong structure: XML
- Scraping XML
- Recap
- Tests
-
4. Scraper #3: Looking for structure in HTML
- Detour: Introduction to HTML and the LIFO rule
- Attributes and values
- Classifying sections of content: div, span, classes and ids
- Back to Scraper #3: Scraping a <div> in a HTML webpage
- Recap
- Tests
-
5. Scraper #4: Finding more structure in webpages: Xpath
- Recap
- Tests
-
6. Scraper #5: Scraping multiple pages with Google Drive
- Recap
- Tests
-
7. Scraper #6: Structure in URLs - using Open Refine
- Looking for structure in URLs
- Assembling the ingredients
- Grabbing ID codes or URLs from a website
- Using Open Refine as a scraper
- Grabbing the HTML for each page
-
Extracting data from the raw HTML with
parseHTML
- Using CSS selectors in scraping
- Understanding the results
- Recap
- Tests
-
8. Scraper #7: Scraping multiple pages with ‘next’ links using Outwit Hub
- Creating a basic scraper in OutWit Hub
- Scraping a series of pages
- Customised scrapers in OutWit
- Trying it out on a search for questions about health
- Recap
- Tests
-
9. Scraper #8: Poorly formatted webpages - solving problems with OutWit
- Identifying what structure there is
- Repeating a heading or other piece of data for each part within it
- Splitting a larger piece of data into bits: using separators
- Recap
- Tests
-
10. Scraper #9: Scraping uglier HTML and ‘regular expressions’ in an OutWit scraper
- Introducing Regex
- Using regex to specify a range of possible matches
- Catching the regular expression too
- I want any character: the wildcard and quantifiers
- Matching zero, one or more characters - quantifiers
- 3 questions: What characters, how many, where?
- Using regex on an ugly page
- What’s the pattern?
- Matching non-textual characters
- What if my data contains full stops, forward slashes or other special characters?
- ‘Anything but that!’ - negative matches
- This or that - looking for more than one regular expression at the same time
- Only here - specifying location
- Back to the scraper: grabbing the rest of the data
- Which dash? Negative matches in practice.
- Recap
- Tests
-
11. Scrapers #10 and #11: Scraping hidden and ‘invisible’ data on a webpage: icons and ‘reveals’
- Scraping accessibility data on Olympic venues
- Hidden HTML
- Recap
- Tests
-
12. Scraper #12: An introduction to Python: adapting scraper code
- Python - you already know some of it
- The ScraperWiki Classic Archive
- Forking a scraper
- Introducing Morph.io
- Finding a scraper to clone
- How to copy a scraper into Morph.io
- Adapting the code
- Recap
- Tests
-
13. Scraper #13: Tracing the code - libraries and functions, and documentation in Scraperwiki
- Parent/child relationships
- Parameters (again)
- Detour: Variables
- Back to Scraper #9
- Recap
- Tests
-
14. Scraper #13 continued: Scraperwiki’s tutorial scraper 2
- What are those variables?
- Detour: loops (for and while)
- Back to scraper #13: Storing the data
- Detour: Unique keys, primary keys, and databases
- A unique key can’t be empty: fixing the error
- Summing up the scraper
- Recap
- Tests
-
15. Scraper #14: Adapting the code to scrape a different webpage
- Dealing with errors
- Recap
- Tests
-
16. Scraper #15: Scraping multiple cells and pages
-
Creating your own functions:
def
- If statements - asking a question
- Numbers in square brackets? Indexes again!
- Attributes
- Recap
- Tests
-
Creating your own functions:
-
17. Scraper #16: Adapting your third scraper: creating more than one column of data
- Recap
- Tests
-
18. Scraper #17: Scraping a list of pages
- Iterating
-
Tip: creating a list of items using the
JOIN
function in a spreadsheet - Recap
- Tests
-
19. Scraper #18: Scraping a page - and the pages linked (badly) from it
- Using ranges to avoid errors
-
Using
len
to test lists - Other workarounds
- Recap
- Scraper tip: a checklist for understanding someone else’s code
-
20. Scraper #19: Scraping scattered data from multiple websites that share the same CMS
- Finding websites using the same content management system (CMS)
- Writing the scraper: looking at HTML structure
- Recap
- Tests
-
21. Scraper #20: Automating database searches (forms)
- Understanding URLs: queries and parameters
- When the URL doesn’t change
- Solving the cookie problem: Mechanize
- Recap
- Tests
-
22. Scraper #21: Storing the results of a search
- Recap
-
Scraper tip: using
print
to monitor progress - Tests
-
23. Scraper #22: Scraping PDFs part 1
- Detour: indexes and slicing shortcuts
- Back to the scraper
- Detour: operators
- Back to the scraper (again)
- Detour: the % sign explained
- Back to the scraper (again) (again)
- Running the code on a working URL
- Borrowing some code
- The first test run
- Fixing a unicode error
- Where’s the ‘view source’ on a PDF?
- Recap
- Tests
-
24. Scraper 23: Scraping PDFs part 2
- Scraping speed camera PDFs - welcome back to XPath
- Ifs and buts: measuring and matching data
- Recap
- Tests
-
25. Scraper 24: Scraping multiple PDFs
- The code
- Tasks 1 and 2: Find a pattern in the HTML and grab the links within
- XPath contains…
- The code: scraping more than one PDF
- The wrong kind of data: calculations with strings
- Putting square pegs in square holes: saving data based on properties
- Recap
- Tests
-
26. Scraper 25: Text, not tables, in PDFs - regex
- Starting the code: importing a regex library
- Scraping each PDF
- The UnicodeDecodeError and the AttributeError
- Storing the first pieces of information
- Why it’s a good idea to store line numbers
-
Re
: Python’s regex library -
Other functions from the
re
library - Back to the code
- Joining lists of items into a single string
- Finding all the links to PDF reports on a particular webpage
- Finding the PDF link on a page
- Detour: global variables and local variables
- The code in full
- Recap
- Tests
-
27. Scraper 26: Scraping CSV files
- The CSV library
- Process of elimination 1: putting blind spots in the code
- Process of elimination 2: amending the source data
- Encoding, decoding, extracting
- Removing the header row
- Ready to scrape multiple sheets
- Combining CSV files on your computer
- Recap
- Tests
-
28. Scraper 27: Scraping Excel spreadsheets part 1
- A library for scraping spreadsheets
- What can you learn from a broken scraper?
- Applying the scraper to a different spreadsheet
- But what is the scraper doing?
- Recap
- Tests
-
29. Scraper 28: Scraping Excel spreadsheets part 2: scraping one sheet
- Testing on one sheet of a spreadsheet
- Recap
- Tests
-
30. Scraper 28 continued: Scraping Excel spreadsheets part 3: scraping multiple sheets
- One dataset, or multiple ones
- Using header row values as keys
- Recap
- Tests
-
31. Scraper 28 continued: Scraping Excel spreadsheets part 4: Dealing with dates in spreadsheets
- Scraping multiple spreadsheets
- Loops within loops
- Scraper tip: creating a sandbox
- Recap
- Tests
-
32. Scraper 29: writing scrapers for JSON and APIs
- If you’re API and you know it
- Dealing with JSON
- Adding our own code
- Storing the results
- Querying your own API
- Recap
- Tests
-
33. The final chapter: where do you go from here?
- The map is not the territory
- Recommended reading and viewing
- End != End
- 34. Acknowledgements
- 35. Glossary
Other books by this author
Authors have earned$10,095,386writing, publishing and selling on Leanpub, earning 80% royalties while saving up to 25 million pounds of CO2 and up to 46,000 trees.
Learn more about writing on Leanpub
The Leanpub 45-day 100% Happiness Guarantee
Within 45 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms
Free Updates. DRM Free.
If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).
Most Leanpub books are available in PDF (for computers), EPUB (for phones and tablets) and MOBI (for Kindle). The formats that a book includes are shown at the top right corner of this page.
Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.
Learn more about Leanpub's ebook formats and where to read them
Top Books
C++20
Rainer GrimmC++20 is the next big C++ standard after C++11. As C++11 did it, C++20 changes the way we program modern C++. This change is, in particular, due to the big four of C++20: ranges, coroutines, concepts, and modules.
The book is almost daily updated. These incremental updates ease my interaction with the proofreaders.
A Guide to Artificial Intelligence in Healthcare
Dr. Bertalan MeskoCan we stay human in the age of A.I.? To go even further, can we grow in humanity, can we shape a more humane, more equitable and sustainable healthcare? This e-book aims to prepare healthcare and medical professionals for the era of human-machine collaboration. Read our guide to understanding, anticipating and controlling artificial intelligence.
Atomic Kotlin
Bruce Eckel and Svetlana IsakovaFor both beginning and experienced programmers! From the author of the multi-award-winning Thinking in C++ and Thinking in Java together with a member of the Kotlin language team comes a book that breaks the concepts into small, easy-to-digest "atoms," along with exercises supported by hints and solutions directly inside IntelliJ IDEA!
C++ Best Practices
Jason TurnerLevel up your C++, get the tools working for you, eliminate common problems, and move on to more exciting things!
Introducing EventStorming
Alberto BrandoliniThe deepest tutorial and explanation about EventStorming, straight from the inventor.
Ansible for DevOps
Jeff GeerlingAnsible is a simple, but powerful, server and configuration management tool. Learn to use Ansible effectively, whether you manage one server—or thousands.
Everyday Rails - RSpecによるRailsテスト入門
Junichi Ito (伊藤淳一), AKIMOTO Toshiharu, 魚振江, and Aaron SumnerRSpecを使ってRailsアプリケーションに信頼性の高いテストを書く実践的なアドバイスを提供します。詳細で丁寧な説明は本書のオリジナルコンテンツです。また、説明には実際に動かせるサンプルアプリケーションも使用します。本書は2017年版にアップデートされ、RSpec 3.6やRails 5.1といった新しい環境に対応しています!さあ、自信をもってテストできるようになりましょう!
R Programming for Data Science
Roger D. PengThis book brings the fundamentals of R programming to you, using the same material developed as part of the industry-leading Johns Hopkins Data Science Specialization. The skills taught in this book will lay the foundation for you to begin your journey learning data science. Printed copies of this book are available through Lulu.
The Hundred-Page Machine Learning Book
Andriy BurkovEverything you really need to know in Machine Learning in a hundred pages.
Continuous Delivery Pipelines
Dave FarleyThis practical handbook provides a step-by-step guide for you to get the best continuous delivery pipeline for your software.
Top Bundles
- #1
Software Architecture for Developers: Volumes 1 & 2 - Technical leadership and communication
2 Books
"Software Architecture for Developers" is a practical and pragmatic guide to modern, lightweight software architecture, specifically aimed at developers. You'll learn:The essence of software architecture.Why the software architecture role should include coding, coaching and collaboration.The things that you really need to think about before... - #2
All the Books of The Medical Futurist
6 Books
We put together the most popular books from The Medical Futurist to provide a clear picture about the major trends shaping the future of medicine and healthcare. Digital health technologies, artificial intelligence, the future of 20 medical specialties, big pharma, data privacy, digital health investments and how technology giants such as Amazon... - #3
PowerShell
3 Books
Buy every PowerShell book from Adam Bertram at a 20% discount! - #4
Cisco CCNA 200-301 Complet
4 Books
Ce lot comprend les quatre volumes du guide préparation à l'examen de certification Cisco CCNA 200-301. - #5
Software Architecture and Beautiful APIs
2 Books
There is no better way to learn how to design good APIs than to look at many existing examples, complementing the Software Architecture theory on API design. - #6
Linux Administration Complet
4 Books
Ce lot comprend les quatre volumes du Guide Linux Administration :Linux Administration, Volume 1, Administration fondamentale : Guide pratique de préparation aux examens de certification LPIC 1, Linux Essentials, RHCSA et LFCS. Administration fondamentale. Introduction à Linux. Le Shell. Traitement du texte. Arborescence de fichiers. Sécurité... - #7
Learn Git, Bash, and Terraform the Hard Way
3 Books
Learn Git, Bash and Terraform using the Hard Way method.These technologies are essential tools in the DevOps armoury. These books walk you through their features and subtleties in a simple, gradual way that reinforces learning rather than baffling you with theory. - #8
9 Books-Bundle: Shut Up and Code!
9 Books
"Shut up and code." Laughter in the audience. The hacker had just plugged in his notebook and started sharing his screen to present his super-smart Python script. "Shut up and code" The letters written in a white literal coding font on black background was the hackers' home screen background mantra. At the time, I was a first-year computer... - #9
Mastering Containers
2 Books
Docker and Kubernetes are taking the world by storm! These books will get you up-to-speed fast! Docker Deep Dive is over 400 pages long, and covers all objectives on the Docker Certified Associate exam.The Kubernetes Book includes everything you need to get up and running with Kubernetes! - #10
CCDE Practical Studies (All labs)
3 Books
CCDE lab