Nerfing Powerful Megalomaniacs


    0.4.0 • Public • Published


    facebookgraph: Node.js client for the Facebook Graph API with Flow support

    facebookgraph is a Node.js client/interface for the Facebook Graph API.

    • it uses axios instead of requests
    • it uses async/await syntax
    • it works only with Node.js 7.6+
    • it uses TypeScript
    • it comes with built-in pagination for fetching data from particular nodes or via search

    Table of Contents


    yarn add facebookgraph


    npm install facebookgraph


    In order to use Facebook Graph API you need to have an access token which is being used to initialize FacebookGraph object. Here's an example how to fetch 5 posts of the page with the id 523008607856853.

    const FacebookGraph = require('facebookgraph');
    const graph = new FacebookGraph('<Your Facebook Access Token>')
    const posts = await graph.fetch('523008607856853', 'posts', 5)

    Request object using ID

    const zuck = await graph.get('4');
    { id: '4',
      first_name: 'Mark',
      last_name: 'Zuckerberg',
      link: '',
      name: 'Mark Zuckerberg',
      updated_time: '2017-01-26T08:32:59+0000' }

    Search API

    Search API endpoint is: You can search through objects of type user, page, event, group, place, placetopic.

    The payload object has three properties: a search term (q), a search type (type) property and fields of each object. Check out the docs to see which fields can be requested for each object.

    const pages = await{ q: 'geek', type: 'page', fields: 'name, link' })

    The code above requests the name and link fields to be returned which are the part of the page public profile and do not require additional permissions. The Facebook Graph API's /search end point only returns publicly available information.

    The syntax for requesting the field of a field is field{nestedField}; to request more than one nested field, separate them by commas: field{nestedField1, nestedField2, nestedField3}; e.g. specify photos.limit(2) to return only 2 photos, or photos.limit(2){link, comments.limit(3)} to return only 2 photos but link and up to 3 comments for each one.

    const users = await{ q: 'geek', type: 'user', fields: 'photos.limit(2){link, comments.limit(2)}' }


    By default, .search and .fetch get only first 25 corresponding elements. It is possible, however, get more results as pagination is already incorporated. There is a 2nd paramater size for both .search and .fetch which defines how many elements should be fetched in total: it can be set either to a particular number or as Infinity to go through all the results pages and gather all results

    const pages = await{ q: 'geek', type: 'page', fields: 'name, link' }, Infinity)
    const posts = await graph.fetch('523008607856853', 'posts', 100)

    Posting text messages, photos or videos

    const post = await'me', { message: 'This is a test message.', link: '' });

    Set no_story to hide the post from showing up in the user feed.

    Batch requests

    const r = await graph.batch([
      { method: "GET", relative_url: "me"},
      { method: "GET", relative_url: "me/friends?limit=10"}


    npm i facebookgraph

    DownloadsWeekly Downloads






    Unpacked Size

    61.2 kB

    Total Files


    Last publish


    • avatar