1.0.0 • Published 5 years ago

forbes-list v1.0.0

Weekly downloads
2
License
MIT
Repository
github
Last release
5 years ago

forbes-list

Npm package that interfaces with the forbes400 api and returns a list of the world richest people

npm.io

npm.io

Installing

npm install forbes-list --save

Documentation

Install and require the library to begin

const forbes = require('forbes-list')
forbes.list(options)
OptionsTypeValue(s)DefaultDescription
{null}nullnullRetrieves and returns a lis of all billionaires
limit{Number} or {String}Any valid integer2153Limits the length of the returning array
filter{String}youngest, oldest, women or female, men or male, real-timenullFilters down the list based on the parameters passed down
filter{Object}Any valid american state i.e state: 'texas'nullAny valid state in the usa
filter{Object}Any valid industry i.e industry: 'technology', valid indusries: technology, fashion, finance, investments etc..nullValid industries include technology, fashion, finance, investments etc..

Usage examples

Payload Sample

[{ position: 1,
    rank: 1,
    name: 'Jeff Bezos',
    lastName: 'Bezos',
    uri: 'jeff-bezos',
    imageUri: 'jeff-bezos',
    worth: 131000,
    worthChange: 1342.991,
    age: 55,
    source: 'Amazon',
    industry: 'Technology',
    gender: 'M',
    country: 'United States',
    title: 'CEO and Founder, Amazon',
    timestamp: 1552490101279,
    headquarters: 'WA',
    state: 'Washington',
    realTimeWorth: 139428.694,
    realTimeRank: 1,
    realTimePosition: 1,
    government: false,
    squareImage: '//specials-images.forbesimg.com/imageserve/5bb22ae84bbe6f67d2e82e05/416x416.jpg?background=000000&cropX1=904&cropX2=1403&cropY1=262&cropY2=761' }]

Retrieves all billionaires

const forbes = require('forbes-list')

forbes.list().then(response => {
    console.log(response)
})

Limits the length of the returning array

const forbes = require('forbes-list')

forbes.list({ limit: 5 }).then(response => {
    console.log(response)
})

Limits the length of the returning array

Valid parameters for filter -> youngest, oldest, women or female, men or male, real-time

const forbes = require('forbes-list')

forbes.list({ limit: 5, filter: 'real-time' }).then(response => {
    console.log(response)
})

Limits the length of the returning array

Any valid state in the usa

const forbes = require('forbes-list')

forbes.list({ limit: 5, filter: { state: 'texas' } }).then(response => {
    console.log(response)
})

Limits the length of the returning array

Valid industries include -> technology, fashion, finance, investments etc..

const forbes = require('forbes-list')

forbes.list({ limit: 5, filter: { industry: 'fashion' } }).then(response => {
    console.log(response)
})

Built With

  • axios - Promise based HTTP client for the browser and node.js
  • forbesApi - JSON Api Of The Forbes 400 Richest People List

Authors

  • Jesse Okeya - Initial work - website

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details