# Surredo API

The Surredo API enables programmatic access to Surredo in unique and advanced ways. Tap into core elements of Surredo like: Posts, Direct Messages, ~~Spaces~~, ~~Lists~~, users, and more.

### Important terminology

Please understand the terminology of our API before you start using it.

| Title              | Value                                                                                                                                  |                                                                                                                                                                                                                                                    |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Access URL     | \[YOUR-SITE-URL]/mobile\_api/\[ENDPOINT\_TYPE]                                                                                         | URL address for access to API Must be as shown in the example. E.g. [https://surredo.anight.space/mobile\_api/login](http://surredo.anight.space/api_docs/)                                                                                        |
| Auth token         | <https://surredo.anight.space/mobile_api?session_id=[YOUR-SESSION-ID]>                                                                 | Most of the user's actions require his authorization, for example, like, or determine whether the user follows some kind of profile, etc. Therefore, we recommend that you always send a user's session on a get request if the user is logged in. |
| API Access key     | [	https://surredo.anight.space/mobile\_api?api\_key=\[YOUR-API-KEY\]](https://surredo.anight.space/mobile_api?api_key=\[YOUR-API-KEY]) | To access the API, the most important point is a unique API key that is specific to each instance of this script.                                                                                                                                  |
| Response data type | {...}                                                                                                                                  | The server response to your API request will be in JSON format                                                                                                                                                                                     |