Authentication
- API for VC funds tracker
- Authentication
- Basics
- Data
- Fund
- Startup
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
| Field | Required | Default Value/Description |
|---|---|---|
| token | Yes | Authentication 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
| Status | Description |
|---|---|
| 400 BadRequest | Username and/or password is not specified |
| 401 Unauthorized | Username 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.