API Documentation

Introduction

The API of StartupGenome is setup to enable the development community to access, update, and contribute new data to the ecosystem via their own applications; mobile, web, or otherwise. The API is accessible via the REST format.

REST is the simplest request format to use - it's a simple HTTP GET or POST action.

The REST Endpoint URL is http://www.startupgenome.com/api/.

All responses will be returned as a JSON string.

Authentication

Authentication is required to access the API's services. Currently, only curators have access to an API key, but eventually the API will be more broadly available to anyone with a StartupGenome account.

To access your API key, simply visit your public profile - this information is provided at the top of the page.

To authenticate to the web service, an HTTP header labled "AUTH-CODE" must be included with each request and it's value must be set with your unique API key.

Methods

Users - Get Your Account Info

Method: /login/{auth_code}

When hitting the API with the above method, if a valid auth_code is passed it will return a JSON string of your StartupGenome account's data.

Organizations - Get

To get a list of organizations at a specific location, the following API methods are available:

• startupgenome.com/api/organizations/city/[slugged-city] (e.g. "omaha-ne", this matches the format on the main website)
• startupgenome.com/api/organizations/state/[slugged-state] (e.g. "ne-us")
• startupgenome.com/api/organizations/country/[slugged-country] (e.g. "chile")

Organizations - Insert(Put)/Update (Post)

The API offers the ability to both insert new organizational data and to update existing organizational data. The methods are as follows:

• startupgenome.com/api/organization (create)
• startupgenome.com/api/organization/:id (update)

The following fields are currently required when creating or updating an organization:

• title (string)
• address (string of full address, e.g. "123 First Street, New York, New York")
• type (pre-defined string, one of the following):
  • startup
  • investor
  • venture_capital
  • angel_group
  • seed_fund
  • corporate_fund
  • accelerator
  • incubator
  • community_enabler
  • coworking_space
  • hackerspace
  • media_press
  • non_profit
  • association
  • foundation
  • academic
  • government
  • club
  • online_community
  • other
  • event
  • service_provider

Example PHP Code

<?php
// auth code
$auth_code = '[your-auth-code-here]';
$headers = array("AUTH-CODE: {$auth_code}");

// Get cURL resource
$curl = curl_init();

// Set some options
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLINFO_HEADER_OUT, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_URL, 'http://startupgenome.com/api/organizations/city/boulder-co');

// Send the request & save response to $resp
$resp = curl_exec($curl);

// Close request to clear up some resources
curl_close($curl);

// output $resp (response from API)
echo "<pre>";
echo print_r(json_decode($resp,1));
exit();
?>