Authentication

The Parsers.me API uses JSON Web Token (JWT) to authenticate requests. Each call to a API method must include a valid token that is obtained by authenticating with Parsers.me.
To get it you need to send your username and password over basic http authentication and receive a bearer token in response.

Demo access

Demo API key (Username) to get a token:

RhDWP52_cj8WBKE?kCEGfaFhJKn?vC@9bcZVvcT69-#k#D?4h?D2Zd@yyxcHEf=5+Kfvzvm!=Tve%Tufk2czUC&%K#6Ka!cERLbtDbP8@AWV+Jmdp5_^+pvEeW*s=+

No password

Demo Token:

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBlMWFhNmEwLWZiOWMtNDVlNS04NGJjLTQxZjE4MTdjYTcwMCIsImxvZ2luIjoiZGVtbyIsInJvbGUiOiJ1c2VyIiwicmVzb3VyY2VzIjoiIiwibmJmIjoxNjA1NTM2MjUwLCJleHAiOjE2MDU1Mzk4NTAsImlhdCI6MTYwNTUzNjI1MCwiaXNzIjoicGFyc2Vycy5tZSJ9.i7o5OOACN7W05h7N9EQmCJUDzpM5azCgqWCKTBx-zNVbkAOMmhSoE0x6EtPuQSRyQtvzgL2OlS6Oj8BnGe9zvUhJj_RkYzlFHWWrawKTvedLus5GqGt8q5lQtI0QZG9czUBGLMQCFORr8Vw2LLIv5QxyQjFkMM17JvU54XIwYl-RIT7lBz_Cy43zyvEFSsH-FtRPXqaURkjWTGYkoGSKYiFGm6aVAF-qDPa4qEsRMknqZ4j3NcUNga_Z6WTGJ7x0OnzGMOmh_VW-FNicdeAj6uQH3ifU3_DybOWWeJ_T0yZRxCBBXaHH5h7N1xTOFF7YZG2yjkPhBHqlW64ct1yCew

Access for the Demo group

Example: http://vcapi.parsers.me/v2/dump/demo/startups

Data dump

If you do not have the opportunity to work with the API, you can get a full dump of the database. Every day we do a full dump of the database, which you can download in the CSV or JSON format.

Example Data dump
If you are not already a licensee, you can download a sample CSV or JSON export. The example contains only part of the data for your reference.

Download demo data dump in CSV format
Demo dump of VC funds
Demo dump of Startups
Demo dump of News
Demo dump of Teams
Demo dump of Investments
Demo dump of Funding Rounds
Demo dump of Funding Round Partners

Download demo data dump in JSON format
Demo dump of VC funds
Demo dump of Startups
Demo dump of News
Demo dump of Teams
Demo dump of Investments
Demo dump of Funding Rounds
Demo dump of Funding Round Partners

Write to info@parsers.me to get a license.

Get Bearer Token

You authenticate yourself using basic authentication (username, password) when you get bearer token. The Authorization is set in the HTTP header. The type is Basic and the credentials are a base64-encoded string consisting of the username and password joined with a colon (i.e., username:password).
To get bearer token with api key, provide key as the basic auth username value. You do not need to provide a password. Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

POST https://eapi.parsers.me/v2/auth/token
Request Headers
   Authorization: Basic base64({username}:{password})

Success responce:

Status 200 OK

{
    "token": "eyJhbGciOiJSUzI1Ni...m9lG-JA"
}

Parameters

FieldRequiredDefault Value/Description
tokenYesAuthentication token to be used for all other API calls. The token must be sent in the authorization header in the format:
Authorization: Bearer <authentication-token>

Error

StatusDescription
400 BadRequestUsername and/or password is not specified
401 UnauthorizedUsername and/or password that was sent with the login request is invalid

Authorizing API calls

For your initial call, use your username and password for basic authentication. For all other secure interactions, you must use the bearer token that is returned after a successful authentication.

Usage

The tokens are sent in the authorization header of the HTTP request for many of API calls. In particular, notice in the following example that the type of authorization that is used with this token is Bearer.

HTTP-METHOD /secured-path
Request Headers
   Authorization: Bearer {your-auth-token}

For all secured paths, we validate the token. During validation, if a token is found to be expired, that token is removed from the system. Upon successful validation, the request is allowed to proceed. Requests made with an invalid token receive a 401 Unauthorized error code.