Fork me on GitHub

Isamuni's APIs

If you are reading this, then you are probably interested in ISAMUNI and want to get some data out of it.

Isamuni is an information aggregator for Facebook groups. The word isamuni comes from the Sicilian dialect and means: let's stand up.

We collect two types of data: passive data and user active data. Passive data is all data crawled from Facebook (e.g. posts, events, user names, etc). User active data, instead, is all data manually entered by the users of the platform.

The following documentation is work in progress. Please report any problems or suggestions to the administrators of the project (via email programmatori.a.catania@gmail.com or submit an issue on the github project).

You can click the buttons to see live examples of the REST APIs. The output is truncated to avoid large amount of data populating this page.


Users

Get all users

GET /users.json

RESPONSE
HTTP/1.1 200 OK
Content-type: application/json

[
  {
    "name" : "Valentino Rossi",
    "occupation" : "student, engineer, etc",
    "description" : "Hello, I really like C++",
    "projects" : "isamuni",
    "links" : "http://www.example.com",
    "slug" : "valentino-rossi"
  }
]


Pages

Pages are of two categories: community pages and company pages.

GET /communities.json # OR: GET /companies.json 

RESPONSE
HTTP/1.1 200 OK
Content-type: application/json
[
  {
    "name" : "name",
    "links" : "links",
    "description" : "page description",
    "contacts" : "page contacts",
    "slug" : "page slug"
  }
]

...

Communities

Companies


Events

Get all events

GET /events.json

RESPONSE
HTTP/1.1 200 OK
Content-type: application/json

[
    {
        "name" : "name of the event",
        "content" : "Content of the event",
        "location" : LOC,
        "location_name" : LOC_NAME,
        "starts_at" : YYYY-MM-DD ..,
        "ends_at" : YYYY-MM-DD ..,
        "coordinates" : lat, long
    }
]


Feed

GET /feed.json

RESPONSE
HTTP/1.1 200 OK
Content-type: application/json

[
    {
        "name" : "post name",
        "post_type" : "type of post: status, photo, link, video, event",
        "content" : "content of the post",
        "link" : "link contained in post",
        "author_name" : "author",
        "created_at" : day and time
    }
]