angel.co

AngelList wrapper purely written in Node.js

npm install angel.co
10 downloads in the last week
24 downloads in the last month

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 = require('angel.co')('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.get('/auth/angel-list', function(req, res) {
    res.redirect(angel.getAuthorizeUrl());
});

app.get('/auth/angel-list/callback', function(req, res) {
    angel.auth.requestAccessToken(req.query.code, function(err, response) {
        if ( err )
            return console.error(err); //Something went wrong.

        // I got the Token. Ain't you?
        app.set('my_key_to_token', response.access_token); // Persist it anywhere.
        res.redirect('/'); // Go back to the homepage.
    });
});

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

Specification for the user is available at: https://angel.co/api/spec/users

me

It returns the data of logged in user.

angel.users.me('access_token_here', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Get User

To get the user, first argument must be the userId while another would be the set for query parameters.

angel.users.user('467664', {'include_details': 'investor'}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Get User Roles

Returns all the roles of user in organizations in which user is tagged in.

angel.users.roles('USER_ID', function(err, body) {
     if ( err )
        return console.log(err);

    console.log(body);
});

Batch Request

Helps to query multiple users at a time. First argument must be an array with the list of user ids.

angel.users.batch(['155', 671], function(err, body) {
     if ( err )
        return console.log(err);

    console.log(body);
});

Search the users by slug and/or md5 of the user's email

angel.users.search({'slug': "hamza-waqas"}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

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.

angel.users.tags('1654', {
    include_children: true,
    investors: 'by_residence'
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Followers

Returns the followers of the user.

angel.users.followers(671, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

OR

// Second argument as true will only return Ids of followers
angel.users.followers(671, true, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Following

Returns the entities that are followed by User.

angel.users.following(671, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

OR

// Second argument as true will only return Ids of followers
angel.users.following(671, true, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Startups

Specification of startup is available at https://angel.co/api/spec/startups

Get Startup

Returns the information of the given startup Id.

angel.startups.get(6702, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Get Startup Comments

Retrieves all the comments of startup.

angel.startups.comments(6702, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Startup Roles

Returns the company's startup roles. Direction must be either Incoming or Outgoing.

angel.startups.roles(6702, {direction: "outgoing"}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Filter Startups

Filters the startups by criteria.

angel.startups.filter({filter: "raising"}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

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.

angel.startups.tags(1654, {order: "asc"}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Followers

Returns the followers of the startup.

angel.startups.followers(6702, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Followers here.
})

OR

// Second argument as true will only return Ids of followers.
angel.startups.followers(6702, true, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Followers here.
})

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.

angel.feeds.consume({
    since: 'PRESAVED_UNIX_TIMESTAMP',
    personalized: 1,
    access_token: 'access_token_here'
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

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.

angel.search.search({
    query: "hamza-waqas",
    type: "User"
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Search by Slugs

Search for entity by slug directly.

angel.search.slugs({
    query: "hamza-waqas"
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Comments

Specification for the comments is available at: https://angel.co/api/spec/comments

Get Comments

Returns all the comments of entity.

angel.comments.comments({
    commentable_type: "Startup",
    commentable_id: 6702
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Create Comment

Creates a new comment against commentable item.

angel.comments.create('I b reviewing it now!', {
    commentable_type: "Startup",
    commentable_id: 6702
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Delete a comment

Deletes a comment.

angel.comments.trash('comment_id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

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.

angel.follows.follow({
    type: "Startup",
    id: "id_to_follow_here"
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Stop Following

Makes the authenticated user stop following the specified item. Returns the deleted follow on success, or an error on failure.

angel.follows.unfollow({
    type: "Startup",
    id: "id_to_follow_here"
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Relationship

Returns the relationship between source and target.

angel.follows.relationship({
    source_id: "source_id_here",
    target_type: "User_or_Startup",
    target_id: "relational_id"
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Batch

Returns the follower and followed information based on comma-separated follow ids, such as those from the activity feed.

angel.follows.batch([1,2,3,4,5], function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body);
});

Intros

API doc is available at: https://angel.co/api/spec/intros

Create Intro

Creates an introduction between User & Startup.

angel.intros.create({
    access_token: "of_authenticated_user",
    startup_id: 6702,
    note: "Lets make some chit chat sometime and Zuck's place?"
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Got it here!
});

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.

angel.messages.list({
    view: "inbox",
    access_token: "access_token_here"
},function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Get Messages - Thread

Returns all the messages of the given thread id.

angel.messages.message(
    'thread_id', 
    {access_token: "access_token_here"}, 
    function(err, body) {
        if ( err )
            return console.log(err);

        console.log(body); // Something with messages here.
    }
);

Create Message

Creates a new message within thread.

angel.messages.create({
    thread_id: '',
    recipient_id: '',
    body: 'So, did you got my message? Errh!'
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Mark the Message.

Marks the messages as viewed by the user.

angel.messages.mark([1,2,3,4], {
    access_token: ""
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

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.

angel.paths.path({
    access_token: "",
    user_ids: [],
    startup_ids: [],
    direction: 'following/followed'
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Press

Please find the specification at: https://angel.co/api/spec/press

Get Startup Press

Returns all the presses related to the startup id.

angel.press.startup(6702,  function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Get Press By Id

Returns the press of the given press id.

angel.press.press('press_id',  function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Reviews

API specification is available at: https://angel.co/api/spec/reviews

Get Reviews for User.

Returns all the reviews of the user.

angel.reviews.get('user_id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Get Review

Returns a single review by id.

angel.reviews.review('review_id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

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.

angel.startup_roles.get({
    user_id: '',
    startup_id: '',
    role: '',
    direction: ''
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

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.

angel.startup_updates.get({
    user_id: '',
    startup_id: ''
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Post Updates.

Creates a new startup update.

angel.startup_updates.create({
    startup_id: '',
    message: '',
    access_token: ''
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Delete Update.

Trashes the startup update.

angel.startup_updates.trash(':id', {
    access_token: ''
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Tags

Please find the specification of the api at: https://angel.co/api/spec/tags

Get Tag

Returns tag with related information by Id.

angel.tags.tag(':id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Get Children

Returns the children of the given tag.

angel.tags.children(':id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Get Parents

Returns the parents of the given tag id.

angel.tags.parents(':id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Get Startups

Retrieves the startups related to the tag.

angel.tags.startups(':id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Get Users

Retrieves the users related to the tag.

angel.tags.users(':id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Likes

Please find the specification of the api at: https://angel.co/api/spec/likes

Get Likes

Returns the likes over the likable entity.

angel.likes.likes({
    likable_type: '',
    likable_id: ''
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Create Likes

Creates a new Like action over Likable story.

angel.likes.create({
    likable_type: '',
    likable_id: ''
}, function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

Delete Like / Unlike

Creates a new delete / unlike action over Likable story.

angel.likes.trash('like_id', function(err, body) {
    if ( err )
        return console.log(err);

    console.log(body); // Something with messages here.
});

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

npm loves you