How to use GNU Social API

This guide will help you understand GNU Social's API and make a simple application.

Download and install GNU social

 * Download latest GNU social release from [[|here]].
 * [[Installing GNU social]]

Write Simple Application

This example is from the API documentation.

 * Open a commandline (terminal)
 * Familiarize yourself with CURL
 * Confirm you have an internet connection
 * Run this command by replacing username and password with your GNU Social username and password. Also replace with your GNU Social installation such as
  curl -u username:password -d status='Howdy!' -d lat='30.468' -d long='-94.743'
* You should receive a similar response to the one below:

 <?xml version="1.0" encoding="UTF-8"?>
 <status xmlns:statusnet="">
  <created_at>Sat Jan 17 13:40:21 +0000 2015</created_at>
   <name>Dalai Lama</name>
   <created_at>Tue Nov 26 00:30:25 +0000 2013</created_at>

Notice: If your apache does not have „Fancy URLs“ enabled, the example url's from above need to change. (e.g. becomes )

Notice: If you are using curl to upload media files, use -F (–form) rather than -d in order to set the content-type header to „multipart/form-data“.

Advanced information

 * [[GNU social API discovery|API discovery]]

//This page is available under the CC BY license, contents taken from