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

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

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