README.md

phpGab

Update (October 2018)

Gab now has an official API and documentation at developers.gab.com. Use that instead of this repo, which won't be updated any more.

Gab.ai does not currently have a public API or much documentation, so here are some basic, quick and dirty PHP functions to get you started talking to the Gab.ai API unofficially. Presently only posting a plain text Gab is supported, but this should be easy to extend to start doing other things.

This is wholly unofficial, likely to break, and hopefully a temporary solution until Gab release an official public API. Use at your own risk and be sure to follow the Gab terms of service: https://gab.ai/about/tos

Please be respectful and do not spam Gab with this script!

You can follow us at https://gab.ai/white_label_dev

Features

1. Logs in to your Gab account to retrieve tokens automatically
2. Locally caches bearer tokens for very fast future requests
3. Automatically detects expired tokens and changed credentials
4. Well documented, easy to extend to perform other Gab functionality
5. Works on PHP 5+, no database required
6. Licensed under MIT

Usage

<?php

require_once 'phpgab.php';

//$DEBUG = TRUE;

$GabResponse = Gab_Send ('your_gab_username', 'your_gab_password', 'This gab is from phpGab. Hello world!');
var_dump ($GabResponse);

?>

array(5) {
  ["id"]=>
  string(36) "0c2e56b8-41fc-4a20-a758-9e1f822bdfd9"
  ["published_at"]=>
  string(25) "2017-06-23T21:30:25+00:00"
  ["type"]=>
  string(4) "post"
  ["actuser"]=>
  array(10) {
    ["id"]=>
    int(195348)
    ["name"]=>
    string(12) "We make apps"
    ["username"]=>
    string(15) "white_label_dev"
    ["picture_url"]=>
    string(43) "https://files.gab.ai/user/594d067129f06.png"
    ["verified"]=>
    bool(false)
    ["is_donor"]=>
    bool(false)
    ["is_investor"]=>
    bool(false)
    ["is_pro"]=>
    bool(false)
    ["is_private"]=>
    bool(false)
    ["is_premium"]=>
    bool(false)
  }
  ["post"]=>
  array(32) {
    ["id"]=>
    int(99999999)
    ["created_at"]=>
    string(25) "2017-06-23T21:30:25+00:00"
    ["revised_at"]=>
    NULL
    ["edited"]=>
    bool(false)
    ["body"]=>
    string(37) "This gab is from phpGab. Hello world!"
    ["body_html"]=>
    string(44) "<p>This gab is from phpGab. Hello world!</p>"
    ["body_html_summary"]=>
    string(44) "<p>This gab is from phpGab. Hello world!</p>"
    ["body_html_summary_truncated"]=>
    bool(false)
    ["only_emoji"]=>
    bool(false)
    ["liked"]=>
    bool(false)
    ["disliked"]=>
    bool(false)
    ["bookmarked"]=>
    bool(false)
    ["repost"]=>
    bool(false)
    ["reported"]=>
    bool(false)
    ["score"]=>
    int(0)
    ["like_count"]=>
    int(0)
    ["dislike_count"]=>
    int(0)
    ["reply_count"]=>
    int(0)
    ["repost_count"]=>
    int(0)
    ["is_quote"]=>
    bool(false)
    ["is_reply"]=>
    bool(false)
    ["is_replies_disabled"]=>
    bool(false)
    ["embed"]=>
    array(2) {
      ["html"]=>
      NULL
      ["iframe"]=>
      NULL
    }
    ["attachment"]=>
    array(2) {
      ["type"]=>
      NULL
      ["value"]=>
      NULL
    }
    ["category"]=>
    NULL
    ["category_details"]=>
    NULL
    ["language"]=>
    string(2) "en"
    ["nsfw"]=>
    bool(false)
    ["is_premium"]=>
    bool(false)
    ["is_locked"]=>
    bool(false)
    ["user"]=> &actuser
    ["replies"]=>
    array(1) {
      ["data"]=>
      array(0) {
      }
    }
  }
}

The above is an example of sending a simple plain text gab to your timeline. It is possible to construct a more elaborate gab by overriding the basic envelope options. The following example posts to the Philosophy topic.

$Gab = array (
    'body' => '<p>Turn off the light switch before changing the bulb. #Wisdom</p>',
    'is_html' => '1',
    'topic' => '5436f0a7-548a-4445-ad91-7db971b48c84'
);

$GabResponse = Gab_DoPost ('your_gab_username', 'your_gab_password', $Gab);