Using the APIs

Friendica offers multiple API endpoints to interface with third-party applications:


HTTP Method

API endpoints can restrict the HTTP method used to request them. Using an invalid method results in HTTP error 405 "Method Not Allowed".


Friendica supports basic HTTP Auth and OAuth 1 to authenticate the user to the APIs.

OAuth settings can be added by the user in web UI under /settings/oauth/.


When an error occurs in API call, an HTTP error code is returned, with an error message Usually:

Error body is


    "error": "Specific error message",
    "request": "API path requested",
    "code": "HTTP error code"


    <error>Specific error message</error>
    <request>API path requested</request>
    <code>HTTP error code</code>

Usage Examples


/usr/bin/curl -u USER:PASS https://YOUR.FRIENDICA.TLD/api/statuses/update.xml -d source="some source id" -d status="the status you want to post"


The RSStoFriendika code can be used as an example of how to use the API with python. The lines for posting are located at line 21 and following.

def tweet(server, message, group_allow=None): url = server + '/api/statuses/update' urllib2.urlopen(url, urllib.urlencode({'status': message,'group_allow[]':group_allow}, doseq=True))

There is also a module for python 3 for using the API.