Zaloguj się Zarejestruj się
Dostawca usług dla paneli SMM

API dla partnerów i paneli SMM

Podłącz usługi Follownia.pl do własnego panelu, sklepu albo systemu zamówień. API jest dostępne w prostym modelu GET / POST z parametrem action oraz w obecnym REST API.

Poproś o dostęp API Zobacz dokumentację

Dla kogo jest API?

API jest przygotowane dla partnerów, którzy chcą podłączyć usługi do własnego panelu SMM, sklepu albo prostego automatu bez rozbudowanej warstwy REST.

Właściciele paneli SMM

Podłącz usługi do własnego panelu i obsługuj zamówienia klientów automatycznie.

Agencje social media

Zamawiaj usługi dla wielu klientów z jednego systemu.

Sklepy i marketplace

Dodaj usługi social media jako produkt cyfrowy z automatyczną realizacją.

Developerzy

Korzystaj z prostego action API albo z istniejących endpointów REST.

Co umożliwia API?

Najprostsze integracje mogą korzystać wyłącznie z `action=services`, `balance`, `add`, `status` i `statuses` bez budowania osobnego klienta REST.

Pobieranie listy usług
Sprawdzanie cen i limitów
Składanie zamówień
Sprawdzanie statusu zamówienia
Sprawdzanie salda
GET / POST oraz JSON POST
Zgodność z istniejącym REST API

Dokumentacja API

Simple API działa na jednym endpointzie i parametrze `action`. REST endpointy `/api/v1/services`, `/api/v1/orders` i `/api/v1/balance` nadal pozostają dostępne.

Autoryzacja

GET / POST

Klucz API możesz przekazać jako `Authorization: Bearer API_KEY`, jako `key=API_KEY` w GET / POST albo w JSON body. Priorytet jest następujący: `Authorization Bearer` → `POST / JSON body key` → `GET key`.

Authorization: Bearer YOUR_API_KEY

Dla bezpieczeństwa zalecamy używać POST lub nagłówka Authorization. GET jest obsługiwany dla prostych integracji, ale klucz API może pojawić się w logach serwera lub historii przeglądarki.

Service list

GET / POST

Zwraca listę dostępnych usług w prostym formacie zgodnym z popularnymi panelami SMM.

Parameters
key Your API key
action services
Example request 
curl "https://follownia.pl/api/v1?key=YOUR_API_KEY&action=services"
Example response 
[
  {
    "service": 123,
    "name": "Obserwujący Instagram VHS",
    "type": "Default",
    "category": "Instagram - Obserwujący",
    "rate": "3.20",
    "currency": "PLN",
    "min": 100,
    "max": 50000,
    "speed": "bardzo szybkie",
    "quality": "VHS",
    "refill": false,
    "cancel": false
  }
]

User balance

GET / POST

Pokazuje saldo partnera przypisanego do aktywnego klucza API.

Parameters
key Your API key
action balance
Example request 
curl "https://follownia.pl/api/v1?key=YOUR_API_KEY&action=balance"
Example response 
{
  "balance": "732.18",
  "currency": "PLN"
}

Add order

GET / POST

Tworzy zamówienie i rozlicza je z salda klienta w jednej transakcji.

Parameters
key Your API key
action add
service Service ID
link Link to page
quantity Needed quantity
Example request 
curl -X POST "https://follownia.pl/api/v1" \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=123" \
  -d "link=https://www.instagram.com/example/" \
  -d "quantity=1000"
Example response 
{
  "order": "ZAM-20260701-483921",
  "charge": "3.20",
  "currency": "PLN"
}

Order status

GET / POST

Zwraca status jednego zamówienia należącego do partnera.

Parameters
key Your API key
action status
order Order ID
Example request 
curl "https://follownia.pl/api/v1?key=YOUR_API_KEY&action=status&order=ZAM-20260701-483921"
Example response 
{
  "charge": "3.20",
  "start_count": "0",
  "status": "In progress",
  "remains": "700",
  "currency": "PLN"
}

Multiple orders status

GET / POST

Pozwala pobrać status wielu zamówień jednocześnie. Limit to 100 identyfikatorów na jedno zapytanie.

Parameters
key Your API key
action statuses
orders Order IDs separated by comma
Example request 
curl "https://follownia.pl/api/v1?key=YOUR_API_KEY&action=statuses&orders=ZAM-20260701-483921,ZAM-20260701-123456"
Example response 
{
  "ZAM-20260701-483921": {
    "charge": "3.20",
    "start_count": "0",
    "status": "In progress",
    "remains": "700",
    "currency": "PLN"
  },
  "ZAM-20260701-123456": {
    "error": "Incorrect order ID"
  }
}

Errors

JSON

Simple API zwraca krótkie błędy w stylu paneli SMM. Najczęstsze odpowiedzi to:

{
  "error": "Missing API key"
}

{
  "error": "Invalid API key"
}

{
  "error": "Missing action"
}

{
  "error": "Invalid action"
}

{
  "error": "Insufficient balance"
}

{
  "error": "Rate limit exceeded"
}

Limity: `60 requests / minute`, `1000 requests / day`, `100 order IDs per statuses request`.