Skip to content

Latest commit

 

History

History
169 lines (106 loc) · 4.27 KB

README.rst

File metadata and controls

169 lines (106 loc) · 4.27 KB

pycrunchbase

Documentation Status Travis-CI Build Status Coveralls coverage PyPI Package latest release

Python bindings to CrunchBase

Starting from v0.3.0, pycrunchbase has support for CrunchBase API version 3, but things are still flaky, so any kind of bug reports is greatly appreciated, for detail see notes below.

Note: I currently do not need to use this library, so it's feature-complete for me. Bug reports are welcome, and pull requests for features are still accepted.

Examples

Initialize the API using your API Key, will throw ValueError if missing

cb = CrunchBase(API_KEY)

Look up an organization by name

github = cb.organization('github')

The response contains snippets of data regarding relationships that the organization has, an example is the funding_rounds

funding_rounds_summary = github.funding_rounds

All relationships are paged, and only 8 is returned initially to get more data do this, it handles paging for you and returns a False-y value if there are no more pages

more_funding_rounds = cb.more(funding_rounds_summary)

Data in relations are just summaries, and you probably want more details For example funding_rounds returns 5 values: type, name, path created_at, updated_at.

If you actually want to know who invested, you have to get to make more API calls.

First get the uuid of the round

round_uuid = funding_rounds_summary[0].uuid

Then use the CrunchBase API to make that call

round = cb.funding_round(round_uuid)

Again, investments is a relationship on a FundingRound, so we can get the first item in that relationship

an_investor = round.investments[0]  # a Investment

And printing that gives us the name of the investor, and the amount invested in USD

print(str(an_investor))  # prints: Investment: [Organization: Name]

Installation

pip install pycrunchbase