BetaList API Info

betalist_api_info.md

BetaList API

Usage

Authenticate all requests with ?access_token=YOUR_TOKEN_HERE

Request your API token here: https://marc.typeform.com/to/KOdlOu

Startups

List

http://api.betalist.com/v1/startups

Parameters

• per_page sets number of objects returned (optional, max 100)
• page defines which page (optional, currently there are 39 pages if you set per_page to 100)
• region_id filters startups by Region (optional, see below)
• market_id filters startups by Market (optional, see below)

Examples

• http://api.betalist.com/v1/startups?per_page=100
• http://api.betalist.com/v1/startups?per_page=100&page=5
• http://api.betalist.com/v1/startups?per_page=100&page=39
• http://api.betalist.com/v1/startups?region_id=470 (startups from the Netherlands)
• http://api.betalist.com/v1/startups?market_id=500 (all "Messaging" startups)
• http://api.betalist.com/v1/startups?market_id=500&region_id=470 (all "Messaging" startups from the Netherlands)

Details

http://api.betalist.com/v1/startups/7503

Regions

List

http://api.betalist.com/v1/regions

Parameters

• per_page sets number of objects returned (optional, max 500)
• page defines which page (optional)

Examples

• http://api.betalist.com/v1/regions

Details

http://api.betalist.com/v1/region/470 currently doesn't show any extras

Markets

Note that markets use a Directed Acyclic Graph, so they can have multiple children (e.g. "Mobile Health" as a child of "Mobile") and multiple parents (e.g. "Mobile" and "Health" are both parents for "Mobile Health").

List

http://api.betalist.com/v1/markets

Parameters

• per_page sets number of objects returned (optional, max 500)
• page defines which page (optional)

Examples

• http://api.betalist.com/v1/markets

Feedback / Bugs / Comments

• For a quick and fast response message me on Twitter: @marckohlbrugge
• For in depth questions/feedback email me at marc@betalist.com
• Let me know what functionality you'd like to see included.

Do's & Don'ts

• Please include a link to http://betalist.com/ when displaying content received through the API. If you link to our startup posts ( http://betalist.com/startups/example ) instead of the startups' homepages ( http://example.com ) that's fine too.
• If your project will be made publicly available please let us know beforehand ( marc@betalist.com ) so we can confirm everything is in order.
• If you need beta testers, reach out to us and we might promote your project to our audience.
• Please send us feedback on the API (feature requests are more than welcome!)
• Do use caching where possible
• Don't make our content available in bulk (CSV/XML download, API, etc)
• Don't use our content to make a competing 'startup discovery' platform without prior explicit approval
• Don't scrape our website to get additional content (e.g. product description) without prior explicit approval

We might change/remove API functionality at any time. We will email you before we make big changes.

TODO

• include pagination info in JSON response (or headers?)
• show children markets when calling /markets/:id
• consider including startup 'descriptions' (currently not included due to SEO / duplicate content concerns)
• consider making (parts of) the API public (i.e. don't require access token)
• expand terms