API Dokumentation

Wir bieten Entwicklern die Möglichkeit über eine API eigene Anwendungen wie z.B. eine Android App oder ein Plugin für Multimedia-Player mit S.to zu verbinden. Für die API wird ein API-Key zur Authentifizierung benötigt dieser kann beim Support Team erfragt werden. Erstelle dazu ein Support Ticket mit einer kurzen Beschreibung deiner Anwendung. Nachfolgend findest du die Dokumentation.

API-Endpoint: https://s.to/api/{version}/

Der API-Key kann beim Support beantragt werden und ist immer als URL-Parameter key zu ubergeben:

https://s.to/api/{version}/function?key=MYSECRETKEY

Jeder Key kann unterschiedliche Berechtigungen und Beschränkungen haben, diese konnen beim Support erfragt werden.

API-Keys werden fur den nötigen Zweck ausgestellt und dementsprechend in folgenden Aspekten beschränkt:

• Abfrage-Anzahl in 24 Stunden
• Abfrage-Anzahl bestimmter Funktionen
• Zugriffsbeschränkungen anhand von IP, User-Agent, ...
• erlaubte Funktionen
• Inhalte der Antworten

Meldet einen Nutzer an und setzt ein Session-Cookie (SSTOCDN).

Aufruf

POST /api/v1/account/login

Antwort

{  
   "success":true
}

Parameter

Wert	Beispiel	Beschreibung
email	user@example.com	E-Mail Adresse des Nutzers
password	uPass123	Passwort des Nutzers

Gibt die Serien der Watchlist des Nutzers aus.

Aufruf

GET /api/v1/account/watchlist/list

Antwort

{  
   "series":[  
      {  
         "wid":1,
         // Watchlist-ID "id":1,
         "name":"Eine Serie",
         "link":"eine-serie",
         "cover":"/full/path/to/cover.jpg",
         "background":"/full/path/to/bg.jpg",
         "description":"Serienbeschreibung ...",
         "trailer":"http://external.page/video",
         "fsk":"12"
      }      //,
      ...
   ]
}
                

Parameter

Wert	Beispiel	Beschreibung
extended	1	(optional) zusätzliche Informationen: cover,background,description,trailer,fsk

Fügt der Watchlist einen Eintrag hinzu.

Aufruf

POST /api/v1/account/watchlist/add

Antwort

{  
   "success":true
}
                

Parameter

Wert	Beispiel	Beschreibung
id	25	hinzuzufügende Serie (id)

Fügt der Watchlist einen Eintrag hinzu.

Aufruf

POST /api/v1/account/watchlist/remove

Antwort

{  
   "success":true
}
                

Parameter

Wert	Beispiel	Beschreibung
wid	25	zu entfernender Watchlist-Eintrag (wid)

Fügt der Watchlist einen Eintrag hinzu.

Aufruf

GET /api/v1/genres/list

Antwort

{  
   "genres":[  
      {  
         "id":1,
         "name":"Abenteuer",
         "link":"abenteuer"
      },
      {  
         "id":2,
         "name":"Action",
         "link":"action"
      }      //,
      ...
   ]
}
                

Parameter

keine Parameter

Trägt einen Link ein. Diese Funktion ist aufgrund von fairness deaktiviert.

Aufruf

POST /api/v1/links/submit

Antwort

{  
   "success":true
}
                

Parameter

Wert	Beispiel	Beschreibung
series	25	Serien-ID
season	1	Staffel
episode	1	Episode
language	1	Sprache 1 = Deutsch 2 = Englisch 3 = Ger-Sub
link	http://link/id	einzutragender Link

Liefert eine Liste der Serien.

Aufruf

GET /api/v1/series/list?extended=1&category=1

Antwort

{  
   "series":[  
      {  
         "id":1,
         "name":"Eine Serie",
         "link":"eine-serie",
         "cover":"/full/path/to/cover.jpg",
         "background":"/full/path/to/bg.jpg",
         "description":"Serienbeschreibung ...",
         "trailer":"http://external.page/video",
         "fsk":12
      }      //,
      ...
   ]
}
                

Parameter

Wert	Beispiel	Beschreibung
extended	1	(optional) zusätzliche Informationen: cover,background,description,trailer,fsk
category	1	(optional) zeigt nur Serien der Kategorie: 0 = alle Serien 1 = Beliebt 2 = Neu 3 = Top 4 = zuletzt gesehen
genre	1	(optional, schließt category aus) Genre-ID siehe /v1/genres/list

Liefert Informationen zu einer Serie, Staffel oder Episode.

Aufruf

GET /api/v1/series/get?series=25&season=1

Antwort (Staffel)

{  
   "series":{  
      /* ... */
   }   "episodes":[  
      {  
         "series":25,
         "season":1,
         "episode":1,
         "german":"Folge Eins",
         "english":"Episode one",
         "description":"Lange Episodenbeschreibung ...",
         "links":[  
            {  
               "id":123456,
               "link":"https://s.to/goto/idAtHoster",
               "hoster":"HosterName",
               "language":1
            }            //,
            ...
         ]
      }      //,
      ...
   ]
}
                

Parameter

Wert	Beispiel	Beschreibung
series	25	Serien-ID
season	1	Staffel (optional)

Antwort (Serie)

{  
   "series":{  
      "id":25,
      "name":"Meine Serie",
      "link":"meine-serie",
      "cover":"/full/path/to/cover.jpg",
      "background":"/full/path/to/background.jpg",
      "trailer":"http://external.page/video",
      "fsk":12,
      "description":"Lange Beschreibung der Serie...",
      "productionStart":2006,
      "productionEnd":2011,
      "rating":{  
         "count":123,
         "result":4.5
      },
      "mainGenre":{  
         "id":2,
         "name":"Action",
         "link":"action"
      },
      "otherGenres":[  
         /* ... */
      ],
      "directors":[  
         {  
            "name":"Jim Doe",
            "link":"jim-doe"
         }         //,
         ...
      ],
      "actors":[  
         {  
            "name":"Bob Doe",
            "link":"bob-doe"
         }         //,
         ...
      ],
      "countries":[  
         {  
            "name":"USA",
            "link":"usa"
         }         //,
         ...
      ],
      "watchlist":false,
      "favourite":false
   },
   "seasons":[  
      1,
      2,
      3
   ]
}
                

Liefert die aktuelle Statistik.

Aufruf

GET /api/v1/statistics/get

Antwort

{  
   "links_count":1300000,
   "series_count":1500,
   "episodes_count":130000,
   "user_count":1300,
   "user_online":100,
   "user_online_list":[  
      {  
         "username":"Bob",
         "userlink":"bob",
         "rank":"user"
      }      //,
      ...
   ],
   "latest_user":"Jim"
}
                

Parameter

Keine Paramter