Angel List
AngelList wrapper purely written in Node.js
Getting Started
Wrapper can be downloaded from npm:
npm install angel.co --save
Once installed, its easy to use it:
var angel = 'APP_ID' 'APP_SECRET';
Please follow the documentation from https://angel.co/api/
Authentication
Module includes ability to let the user authenticate from AngelList. For now, its hard coded and asks for all ther permissions but you can change sa you like ;-)
Below example has been implemented with Express.js
you may modify it.
app; app;
PS:
Your callback url must be similar to what you have configured while creating an app on AngelList.
Available Services.
You can serve this wrapper for following services:
- Users
- Startups
- Feeds
- Search
- Comments
- Follows
- Intros
- Messages
- Paths
- Press
- Reviews
- Startup Updates
- Startup Roles
- Tags
- Likes
Users
Specification for the user is available at: https://angel.co/api/spec/users
me
It returns the data of logged in user.
angelusers;
Get User
To get the user, first argument must be the userId while another would be the set for query parameters.
angelusers;
Get User Roles
Returns all the roles of user in organizations in which user is tagged in.
angelusers;
Batch Request
Helps to query multiple users at a time. First argument must be an array with the list of user ids.
angelusers;
Users Search
Search the users by slug
and/or md5
of the user's email
angelusers;
Users by Tag
Returns all the users related to the tag. Tag must be either LocationTag
or MarketTag
. First argument is the tagId, while another is the object
with k/v of query parameters.
angeluserstags'1654' include_children: true investors: 'by_residence' { if err return console; console;};
Followers
Returns the followers of the user.
angelusers;
OR
// Second argument as true will only return Ids of followersangelusers;
Following
Returns the entities that are followed by User.
angelusers;
OR
// Second argument as true will only return Ids of followersangelusers;
Startups
Specification of startup is available at https://angel.co/api/spec/startups
Get Startup
Returns the information of the given startup Id.
angelstartups;
Get Startup Comments
Retrieves all the comments of startup.
angelstartups;
Startup Roles
Returns the company's startup roles. Direction must be either Incoming
or Outgoing
.
angelstartups;
Filter Startups
Filters the startups by criteria.
angelstartups;
Get Startups by Tag
Returns companies that are tagged with the given tag or a child of the given tag. Results are paginated and ordered according to the order parameter.
angelstartupstags1654 order: "asc" { if err return console; console;};
Followers
Returns the followers of the startup.
angelstartups
OR
// Second argument as true will only return Ids of followers.angelstartups
Feeds
Specification for feeds entity is available at: https://angel.co/api/spec/activity_feeds
Consume
Returns site activity. If authenticated and the personalized parameter is passed in, only activity from the authenticated user's social graph is returned. No more than 25 items will be returned. Results are paginated and ordered by most recent story first, unless a since parameter is given.
angelfeeds;
Search
Specification regardings calls and parameters for search is available at: https://angel.co/api/spec/search
Search Entity.
Search by name for Startups, Users, MarketTags and LocationTags, optionally narrowing the results by type. Results are sorted by a mix of match and popularity.
angelsearch;
Search by Slugs
Search for entity by slug directly.
angelsearch;
Comments
Specification for the comments is available at: https://angel.co/api/spec/comments
Get Comments
Returns all the comments of entity.
angelcomments;
Create Comment
Creates a new comment against commentable item.
angelcomments;
Delete a comment
Deletes a comment.
angelcomments;
Follows
Specification of follows entity can be viewed at: tps://angel.co/api/spec/follows
Start Following
Makes the authenticated user follow the specified item. Returns the new follow on success, or an error on failure.
angelfollows;
Stop Following
Makes the authenticated user stop following the specified item. Returns the deleted follow on success, or an error on failure.
angelfollows;
Relationship
Returns the relationship between source and target.
angelfollows;
Batch
Returns the follower and followed information based on comma-separated follow ids, such as those from the activity feed.
angelfollows;
Intros
API doc is available at: https://angel.co/api/spec/intros
Create Intro
Creates an introduction between User & Startup.
angelintros;
Messages
The specification for the API is available at: https://angel.co/api/spec/messages
PS:
You require the message
permissions applied within the authentication scope first.
Get Messages - List
Returns all the messages of the given thread id.
angelmessages;
Get Messages - Thread
Returns all the messages of the given thread id.
angelmessages;
Create Message
Creates a new message within thread.
angelmessages;
Mark the Message.
Marks the messages as viewed by the user.
angelmessages;
Paths
Grab the verbose and documentation for paths from: https://angel.co/api/spec/paths
Get Path
Returns the path between You and the provided User / Starup Ids.
angelpaths;
Press
Please find the specification at: https://angel.co/api/spec/press
Get Startup Press
Returns all the presses related to the startup id.
angelpress;
Get Press By Id
Returns the press of the given press id.
angelpress;
Reviews
API specification is available at: https://angel.co/api/spec/reviews
Get Reviews for User.
Returns all the reviews of the user.
angelreviews;
Get Review
Returns a single review by id.
angelreviews;
Startup Roles
Specification can be found at: https://angel.co/api/spec/startup_roles
Get Roles
Given a user_id, returns the companies that User is tagged in. Given a startup_id, returns either the users and companies tagged in the given Startup (if direction is incoming) or the companies which the given Startup is tagged in (if direction is outgoing). If neither parameter is given, the authenticated user is used. Possible roles include founder, employee, past_investor, current_investor, advisor, incubator and referrer. Roles are paginated and ordered by most recently declared first.
angelstartup_roles;
Startup Updates
Please find the specification of the api at: https://angel.co/api/spec/status_updates
Get Updates
Return status updates from the given user or startup. If neither is specified, the authenticated user is used. Status updates are paginated and ordered by most recent first.
angelstartup_updates;
Post Updates.
Creates a new startup update.
angelstartup_updates;
Delete Update.
Trashes the startup update.
angelstartup_updates;
Tags
Please find the specification of the api at: https://angel.co/api/spec/tags
Get Tag
Returns tag with related information by Id.
angeltags;
Get Children
Returns the children of the given tag.
angeltags;
Get Parents
Returns the parents of the given tag id.
angeltags;
Get Startups
Retrieves the startups related to the tag.
angeltags;
Get Users
Retrieves the users related to the tag.
angeltags;
Likes
Please find the specification of the api at: https://angel.co/api/spec/likes
Get Likes
Returns the likes over the likable entity.
angellikes;
Create Likes
Creates a new Like action over Likable story.
angellikes;
Delete Like / Unlike
Creates a new delete / unlike action over Likable story.
angellikes;
Issues / Bugs
Please feel free to open a new issue ticket if any occures. I love pull requests so they are also welcome. Before making it out the issue, please verify the required arguments / parameters from AngelList
api source.
HotCake TODOs
These are the most important TODOs that are supposed to be done. If you can make pull request, I'd love to accept it (if it really has to).
- Create Jasmine / Mocha test cases to validate each of the service.
- Few workable examples might be there to even make it more verbose.
- Code Cleanup. I hate dirt but sometimes has to do!
- Jobs Service. (Its useless for my current scenerio but welcome pull request for it).
- You call it!
Contribution
This wrapper is solely written at Kuew Inc
by Hamza Waqas