API dla partnerów

Wystawiaj ogłoszenia na LocaYo prosto z własnego programu

Dla komisów, dealerów, biur nieruchomości, agencji pracy, sklepów i twórców programów do ogłoszeń. Twój program dodaje, zmienia i zdejmuje ogłoszenia sam. Za 0 zł: bez abonamentu i bez opłaty za ogłoszenie.

Wygeneruj klucz

Nie jesteś informatykiem? Zacznij tutaj: dla komisów · dla pracodawców i agencji pracy · dla biur nieruchomości

Start w trzech krokach

Załóż konto firmowe na LocaYo (e-mail z kodem, Google albo Facebook).
W panelu wejdź w Integracje (API) i wygeneruj klucz. Widzisz go raz — zapisz go w programie.
Wysyłaj ogłoszenia: PUT https://api.locayo.app/api/integracje/v1/ogloszenia/{Twój numer oferty}.

Tworzysz program dla wielu komisów albo biur? Nie potrzebujesz umowy z nami: każdy Twój klient generuje własny klucz i wpisuje go w Twoim programie. Ogłoszenia wychodzą pod jego kontem.

Autoryzacja

Każde zapytanie ma nagłówek Authorization: Bearer lcy_live_…. Klucz wymienisz albo unieważnisz w panelu jednym kliknięciem — stary przestaje działać od razu. Adres bazowy: https://api.locayo.app/api/integracje/v1.

Endpointy

PUT	/ogloszenia/{id}	Dodaje albo aktualizuje ogłoszenie o Twoim numerze oferty. Ten sam JSON drugi raz nic nie psuje.
DELETE	/ogloszenia/{id}	Zdejmuje ogłoszenie. Z ?powod=sprzedane strona zostaje z plakietką „Sprzedane”.
GET	/ogloszenia/{id}	Status jednego ogłoszenia i adres na LocaYo.
GET	/ogloszenia?strona=1&status=active	Wszystkie Twoje ogłoszenia z API, po 100 na stronę.
GET	/slowniki	Działy, rodzaje, typy i cechy z dozwolonymi wartościami.
GET	/konto	Nazwa konta i liczba ogłoszeń w każdym statusie.

Przykład: samochód z komisu

curl -X PUT https://api.locayo.app/api/integracje/v1/ogloszenia/AUTO-1042 \
  -H "Authorization: Bearer lcy_live_…" \
  -H "Content-Type: application/json" \
  -d @auto.json

{
  "dzial": "motoryzacja",
  "rodzaj": "auto-osobowe",
  "typ": "sprzedam",
  "marka": "Toyota",
  "stan": "uzywany",
  "cena": 45900,
  "waluta": "PLN",
  "doNegocjacji": true,
  "opis": "Pierwszy właściciel, serwisowana w ASO, bezwypadkowa…",
  "cechy": {
    "model": "Corolla",
    "rokProdukcji": 2018,
    "przebieg": 98000,
    "stanTechniczny": "nieuszkodzony",
    "paliwo": "benzyna",
    "skrzynia": "manualna"
  },
  "lokalizacja": { "miasto": "Kraków", "kodPocztowy": "30-001", "lat": 50.06, "lng": 19.94 },
  "zdjecia": ["https://twoj-serwer.pl/foto/1042-1.jpg", "https://twoj-serwer.pl/foto/1042-2.jpg"],
  "opiekun": { "nazwa": "Jan Kowalski", "telefon": "+48600100200" }
}

201 Created
{
  "success": true,
  "data": {
    "id": "AUTO-1042",
    "status": "pending",
    "tytul": "Toyota Corolla, 2018, 98 000 km – Kraków",
    "url": null,
    "wynik": "dodane",
    "ostrzezenia": []
  }
}

Tytuł auta i nieruchomości składamy sami z pól (marka, model, rocznik, przebieg, miasto), żeby lista trzymała jeden styl. W innych działach podajesz tytul (5–90 znaków).

Pola ogłoszenia

dzial, rodzaj	tak	Z GET /slowniki, np. motoryzacja / auto-osobowe, nieruchomosci / mieszkanie.
typ	nie	sprzedam (domyślnie), zamienie, wynajme — dozwolone typy podaje słownik.
opis	tak	Minimum 80 znaków. Linki i nazwy innych portali wycinamy.
cena, waluta	nie	Liczba w złotych; bez ceny = „zapytaj o cenę”. Waluta domyślnie PLN.
cechy	zależnie	Klucze ze słownika. Auta: rokProdukcji, przebieg i stanTechniczny są wymagane.
marka, stan	nie	Stan: nowy, jak-nowy, uzywany, uszkodzony (domyślnie uzywany).
lokalizacja	tak	miasto wymagane; dzielnica, kodPocztowy, wojewodztwo, lat/lng opcjonalnie. Na mapie pokazujemy okolicę, nie adres.
zdjecia	nie	Do 20 publicznych adresów JPG/PNG/WebP, w kolejności. Ten sam adres pobieramy tylko raz.
opiekun	nie	Osoba prowadząca ofertę: „Pokaż numer” dzwoni do niej zamiast na numer konta.

Zasady

Pierwsze ogłoszenia z API sprawdzamy ręcznie (status pending), do akceptacji przyjmujemy 60 nowych na dobę. Potem publikują się od razu i bez dobowego limitu.
Ogłoszenie żyje, dopóki go nie zdejmiesz. Jeśli przez 30 dni nie przyjdzie żadne zapytanie z Twoim kluczem, uznajemy integrację za wyłączoną i zdejmujemy ogłoszenia.
Limit: 1200 zapytań na godzinę dla klucza — pełna synchronizacja 1000 ogłoszeń mieści się w godzinie.
Ogłoszenie usunięte przez właściciela konta albo odrzucone przez moderację nie wraca z programu.
Klient kontaktuje się z Tobą przez czat LocaYo albo „Pokaż numer”. Nie bierzemy prowizji.

Błędy

401 BRAK_KLUCZA / ZLY_KLUCZ	Brak nagłówka albo klucz unieważniony.
422 BLEDNE_DANE	Lista „bledy” z polem i komunikatem — wszystkie problemy naraz.
409 ZABLOKOWANE	Ogłoszenie usunął właściciel konta albo odrzuciła moderacja. Nie wraca pod tym samym id.
404 NIE_MA	Nie ma ogłoszenia o tym id.
429 RATE_LIMIT_EXCEEDED	Ponad 1200 zapytań na godzinę dla klucza.
429 LIMIT_DOBOWY	Do pierwszej akceptacji przez moderację: 60 nowych ogłoszeń na dobę. Aktualizacje bez limitu.

Pytania techniczne: napisz do nas.