API Documentation

 

The CrunchBase API provides JSON representations of the data found on CrunchBase. The API currently supports three actions: "show", "search", and "list", which are each described below. The v/1/ components of the URLs below refer to the current version of the API, which is 1.

For an interactive interface to the API, try using the IO Docs, which lets you make live calls to various API endpoints.

Show Entity

To retrieve information about a specific entity on CrunchBase, use a URL of the form:

http://api.crunchbase.com/v/1/<namespace>/<permalink>.js

The available namespaces are:

  • company
  • person
  • financial-organization
  • product
  • service-provider

<permalink> referrers to an entity's permalink as seen in the URL for its regular CrunchBase page.

Also, you can append a callback query param to have the result passed to a callback method of your choice.

Examples

api.crunchbase.com/v/1/company/facebook.js
api.crunchbase.com/v/1/person/brad-fitzpatrick.js
api.crunchbase.com/v/1/financial-organization/accel-partners.js?callback=callme

Search Queries

To retrieve a list entities that match a given search query, use URLs of the form:

http://api.crunchbase.com/v/1/search.js?query=<keyword(s)>
You can search for the keyword within specific fields in the entity. To do this, you'd need to add two more query parameters:
  • entity
  • field
These will allow you to search specific fields within entities -- e.g., 'name' within 'companies'.

  • entity: needs to be one of the following types: 'company', 'product', 'financial_org', 'person', 'provider'
  • field: an attribute on the profile. The supported attributes are: name, overview, homepage_url, tag_list
If you provide a field, entity is required but entity may be specified without a field.
For instance, you should be able to do something like this:
http://api.crunchbase.com/v/1/search.js?query=instagram&entity=company&field=homepage_url&api_key=<yourapikey>
The result is a hash containing the first 10 results
{"total": 1,
	 "page": 1,
	 "results":
	  [{"name": "Speckly",
	    "permalink": "speckly",
	    "namespace": "company",
	    "overview": "Speckly's mission is to make the process of finding media delivered through [BitTorrent](http://www.crunchbase.com/company/bittorrent) easy for everyone. Part of that equation is making BitTorrent searches relevant, fast, and easy to understand. ",
	    "image":
	     {"available_sizes":
	       [[[150,
	          61],
	         "assets/images/resized/0002/2217/22217v1-max-150x150.png"],
	        [[156,
	          64],
	         "assets/images/resized/0002/2217/22217v1-max-250x250.png"],
	        [[156,
	          64],
	         "assets/images/resized/0002/2217/22217v1-max-450x450.png"]],
	      "attribution": null}}]}

Note the total and page attributes of the hash. Total refers to the total number of results available for the given query.

To retrieve more than the first 10 results append the page parameter to your query. This request will retrieve results 11-20 for the query 'iphone':

http://api.crunchbase.com/v/1/search.js?query=iphone&page=2

Also, you can append a callback query parameter to have the result passed to a callback method of you choice.

Note that this action may be useful if you want to "search by domain", as the search engine considers the entity homepage URLs when generating results.

Examples

api.crunchbase.com/v/1/search.js?query=techcrunch
api.crunchbase.com/v/1/search.js?query=google.com&page=3
api.crunchbase.com/v/1/search.js?query=reddit&callback=callme

List Entities

To retrieve a paginated list of all of the entities in a certain namespace on CrunchBase, use a URL of the form:

http://api.crunchbase.com/v/1/<plural-namespace>.js

The plural available namespaces are:

  • companies
  • people
  • financial-organizations
  • products
  • service-providers

This action does not support JavaScript callbacks.

Examples

api.crunchbase.com/v/1/companies.js?page=4
api.crunchbase.com/v/1/financial-organizations.js?page=25

Permalink Entity

Ever needed to find a corresponding CrunchBase page for a particular Company/Person/Financial Org name? Well, we now have an API for that which is easier to use than our Search API.

Syntax

For all entities except people:

http://api.crunchbase.com/v/1/<plural entity namespace>/permalink?name=<entity name>

For people:

http://api.crunchbase.com/v/1/people/permalink?first_name=<person first name>&last_name=<person last name>

Examples

http://api.crunchbase.com/v/1/companies/permalink?name=Google
http://api.crunchbase.com/v/1/financial-organizations/permalink?name=Sequoia%20Capital
http://api.crunchbase.com/v/1/products/permalink?name=iPhone
http://api.crunchbase.com/v/1/people/permalink?first_name=Ron&last_name=Conway

Returns

If the permalink is found, JSON will be returned in the following format (this one for companies):

{"name": "Google", "crunchbase_url": "http://www.crunchbase.com/company/google", "permalink": "google"}

If a permalink is not found, the HTTP status code will be 404 and the JSON return will be (note that this is a 404 for companies):

{"error": "Unknown company. Please see www.crunchbase.com/help/api for help."}

Notes

The entity name (or for people, first and last name) is case-insensitive. Replace any spaces in the entity name with %20.

TechCrunch Posts API

Want data on how many times a particular company has been written about on TechCrunch? Well, you can do that now as well. The syntax is very similar to the Permalink API, above. You start with an entity name.

Syntax

For all entities except people:

http://api.crunchbase.com/v/1/<plural entity namespace>/posts?name=<entity name>

For people:

http://api.crunchbase.com/v/1/people/posts?first_name=<person first name>&last_name=<person last name>

Examples:

http://api.crunchbase.com/v/1/companies/posts?name=Google
http://api.crunchbase.com/v/1/financial-organizations/posts?name=Sequoia%20Capital
http://api.crunchbase.com/v/1/products/posts?name=iPhone
http://api.crunchbase.com/v/1/people/posts?first_name=Ron&last_name=Conway

If any posts are found, JSON will be returned in the following format (this one for companies):

{"posts_url": "http://www.crunchbase.com/company/google/posts", 
	 "num_posts": 1174, 
	 "name": "Google", 
	 "crunchbase_url": "http://www.crunchbase.com/company/google", 
	 "permalink": "google"}

If no posts are found, the HTTP status code will be 404 and the JSON return will be (note that this is a 404 for companies):

{"error": "Unknown company. Please see www.crunchbase.com/help/api for help."}

Notes

The entity name (or for people, first and last name) is case-insensitive. Replace any spaces in the entity name with %20.

        

Docs Navigation