Followir bietet eine einfache HTTP-API im gängigen Format der SMM Panel API v2, sodass die meisten Reseller-Panels und Skripte ohne Anpassung damit funktionieren. Alle Antworten sind JSON.
Erste Schritte
- Erstelle ein Konto und lade Guthaben auf.
- Öffne die API-Seite in deinem Konto und erzeuge deinen API-Schlüssel. Halte ihn geheim.
- Optional: Füge die IP-Adressen hinzu, die deinen Schlüssel verwenden dürfen (leer lassen, um jede IP zuzulassen).
Endpunkt
| URL | https://followir.com/api/v2 |
|---|---|
| Methode | POST (GET funktioniert ebenfalls) |
| Format | Formularparameter als Eingabe, JSON als Ausgabe |
| In jedem Aufruf erforderlich | key (dein API-Schlüssel) und action |
Aktionen
| action | Parameter | Funktion |
|---|---|---|
services | key | Listet alle verfügbaren Services mit Preisen und Limits auf |
add | key, service, link, quantity (runs, interval für Drip-Feed) | Gibt eine neue Bestellung auf |
status | key, order oder orders (durch Kommas getrennt) | Bestellstatus, einzeln oder mehrere |
cancel | key, order oder orders (durch Kommas getrennt) | Storniert Bestellungen bei Services, die dies erlauben |
refill | key, order oder orders (durch Kommas getrennt) | Fordert einen Refill für berechtigte Bestellungen an |
refill_status | key, refill | Status einer Refill-Anfrage |
balance | key | Dein aktuelles Guthaben und die Währung |
services
curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=services"
[
{
"service": "1",
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram",
"rate": "0.9000",
"min": "100",
"max": "100000",
"refill": true,
"cancel": false
}
]
rate ist der Preis pro 1000. refill und cancel geben an, ob der Service sie unterstützt.
add
curl -X POST "https://followir.com/api/v2" \
-d "key=YOUR_API_KEY" -d "action=add" \
-d "service=1" -d "link=https://instagram.com/username" -d "quantity=1000"
{ "order": 850758 }
Bei Drip-Feed-Services kannst du zusätzlich runs (mindestens 2) und interval (Minuten, 1 bis 1440) senden. Bei anderen Services werden sie ignoriert.
status
curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=status" -d "order=850758"
{
"charge": "0.9000",
"start_count": "3572",
"status": "In progress",
"remains": "400",
"currency": "USD"
}
Mehrere Bestellungen auf einmal: Sende orders=850758,850759. Die Antwort ist ein Objekt, dessen Schlüssel die Bestellnummern sind. Mögliche status-Werte: Pending, In progress, Completed, Partial, Canceled, Refunded.
cancel
curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=cancel" -d "order=850758"
{ "status": "Success" }
Manche Stornierungen warten auf eine Bestätigung, dann zeigt die Antwort "status": "Pending". Bei mehreren Bestellungen erhältst du eine Liste von { "order": ..., "cancel": ... }-Einträgen.
refill und refill_status
curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill" -d "order=850758"
{ "refill": "12" }
curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill_status" -d "refill=12"
{ "refill": "12", "status": "Pending" }
balance
curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=balance"
{ "balance": "25.50", "currency": "USD" }
Fehler
Wenn etwas schiefgeht, enthält die Antwort ein Feld error:
{ "error": "Not enough funds" }
| Meldung | Bedeutung |
|---|---|
API key is required | Der Parameter key fehlt |
Action is required / Incorrect action | action fehlt oder ist unbekannt |
Invalid API key | Der Schlüssel ist falsch oder deaktiviert, oder deine IP steht nicht auf der Whitelist |
Incorrect service ID / Service not found | Die Service-Nummer existiert nicht oder ist deaktiviert |
Link is required / Incorrect quantity | Der Link fehlt oder die Menge ist keine gültige Zahl |
Quantity must be between ... | Außerhalb des Minimums und Maximums des Services |
Not enough funds | Dein Guthaben reicht für diese Bestellung nicht aus |
Order not found | Die Bestellung existiert in deinem Konto nicht |
Cancel is not available for this service | Dieser Service kann nicht storniert werden |
Codebeispiele
PHP
$ch = curl_init("https://followir.com/api/v2");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'add',
'service' => 1,
'link' => 'https://instagram.com/username',
'quantity' => 1000,
]));
$response = json_decode(curl_exec($ch), true);
print_r($response);
Python
import requests
r = requests.post("https://followir.com/api/v2", data={
"key": "YOUR_API_KEY",
"action": "status",
"order": 850758,
})
print(r.json())
Gut zu wissen
- Die Bestellnummern sind dieselben, die du auf deiner Bestellungsseite siehst.
- Mehrere gleichzeitige Bestellungen für denselben Link können abgelehnt werden, bis die erste abgeschlossen ist.
- Jeder Aufruf wird in deinem Konto protokolliert. Wenn du glaubst, dass dein Schlüssel kompromittiert wurde, erzeuge ihn auf der API-Seite neu.
- Brauchst du Hilfe bei der Integration? Eröffne ein Ticket auf der Support-Seite.
