Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Corpcrawl EDGAR Scraper

Project Description

# About This is a python scraper for the Securities and Exchange Commission EDGAR database. It looks at the Form 10k filings that publicly held corporations are required to file with the SEC. It then attempts to extract the subsidiary relationships from the 10k exhibit 21.1.

Corpcrawl is a storage agnostic scraper, so you’ll need to implement your own storage scheme.

# Installation You can get the package from PyPi through Pip.

pip install corpcrawl

From a python console you can try

import corpcrawl

If it works, then you can get started

# How to use

## Running it First import the required pieces

from corpcrawl.crawler import CorpCrawl from corpcrawl.backend import Backend

def main()
my_backend = MyBackend() crawler = CorpCrawl(cache_path = ‘/an/absolute/path/to/some/dir’, backend = my_backend) c.crawl(years = [2011, 2012], quarters = [1, 2, 3, 4])

class MyBackend(Backend):

def get_company(self, name):
def add_company(self, comp):
print “Adding %s” % str(comp)

This is about as simple of a backend as can be. This code will crawl the filings and print out the name of each company and subsidiary that it finds for all quarters of years 2011 and 2012. Obviously you will want to hook it up to a database or something.

# Notes The SEC data is very unstructured. As such, there are a lot of errors. This is version 0.0.1, so instead of implementing your own methods to massage the data that it returns, it would be better if you could contribute so make the core parser better.

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
corpcrawl-0.0.37.tar.gz (16.6 kB) Copy SHA256 Checksum SHA256 Source Mar 14, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting