Allegro API – kompendium wiedzy
Allegro ma API od lat. Co więcej, bezpłatnie udostępnia je podmiotom posiadającym konta firmowe i swoim partnerom. Tak jak nasze Raporty Allegro Rentowność korzystają z danych z Allegro API, aby zautomatyzować dla Ciebie aktualne wyniki sprzedażowe pod analizę rentowności firmy, tak i Ty możesz agregować dane z tego źródła do własnych CRM czy ERP. Z tego artykułu dowiesz się, jak uzyskać klucz API Allegro i do czego można go wykorzystać.

- Czy Allegro ma API?
- Co daje Allegro API?
- Jak uzyskać klucz API Allegro (klucz WebAPI)?
- Allegro API w AlleSpark
- Allegro API funkcjonalności – tworzenie oferty powiązanej z produktem (przykład)
- Spojrzenie na ekspansję zagraniczną Allegro i Allegro REST API
- Allegro API – FAQ
Czy Allegro ma API?
Allegro ma API REST (stąd oficjalna nazwa brzmi Allegro REST API), a jego dokumentacja jest otwarta i możesz się z nią zaznajomić na oficjalnej stronie serwisu pod adresem: https://developer.allegro.pl/tutorials/informacje-podstawowe-b21569boAI1 .
API Allegro korzysta z protokołu HTTP oraz jego metod. Jako interfejs programistyczny składa się ze szczegółowo opisanych reguł i protokołów postępowania. Dzięki temu pozwala na prowadzenie precyzyjnej wymiany informacji pomiędzy serwisem i zewnętrznym oprogramowaniem, ułatwiając zarządzanie sklepem Allegro.Z tego względu dostęp do Allegro API przydaje się szczególnie największym firmom sprzedającym na tym marketplace – takim, które każdego dnia realizują wiele zamówień i nie mają czasu na ręczne ich przetwarzanie. API Allegro daje możliwość zautomatyzowania kluczowych procesów oraz połączenie ze sobą kilku kanałów sprzedaży (np. konto Allegro z własnym sklepem internetowym), aby zarządzać wszystkim z jednego miejsca.
➔ Status Page public API Allegro (publicznego API Allegro) znajdziesz na stronie API Status Allegro. Narzędzie zawiera aktualizacje dotyczące incydentów i wszelkich prac serwisowych. Dla komfortu użytkowników Status Page Allegro API został podzielony na grupy poszczególnych funkcjonalności.
Co daje Allegro API?
Allegro API to zestaw specjalnych protokołów, który pozwala na komunikację pomiędzy zasobami Allegro a zewnętrznymi programami (takimi jak systemy księgowe i magazynowe). Podczas komunikacji oba podmioty wymieniają się różnymi danymi. Dzięki niemu sprzedawcy mogą:
- wystawiać kilka ofert naraz,
- edytować nawet wiele ofert jednocześnie,
- pobierać aktualne dane sprzedażowe,
- stosować wyróżnienia w wielu ofertach w tym samym czasie,
- zarządzać przesyłkami (za pomocą opcji Wysyłam z Allegro),
- zarządzać komunikacją z klientami.
Jak uzyskać klucz API Allegro (klucz WebAPI)?
Z pewnością zastanawiasz się teraz jak uzyskać klucz API Allegro i czy jest on darmowy. Otóż jest, a jego uzyskanie jest niesamowicie łatwe. Oto instrukcja:
- Wejdź na stronę Developer Allegro.
- Zaloguj się na swoje konto na Allegro.
- Wybierz opcję Zarejestruj aplikację.
Klucz WebAPI uzyskasz w kolejnych krokach, wykonuj poszczególne instrukcje Allegro.
Allegro API w AlleSpark
Nasze narzędzie do analizy sprzedaży na Allegro AlleSpark również korzysta z API Allegro. W ten sposób, o ile użytkownik narzędzia (zarówno ten z pakietu FREE jak i PRO), zautoryzuje naszą aplikację, wyświetlą mu się w raportach jego rentowności wszystkie aktualne koszty i przychody z działalności na Allegro.Pozyskane dane o ilości sprzedanych sztuk, wartości sprzedaży, kurierach itd. AlleSpark dzieli po ID wystawianych ofert, przypisując im odpowiednie parametry. To dzięki temu, i temu, że użytkownicy wrzucają w AlleSpark pliki ze swoimi kosztami Allegro Ads oraz cenami zakupu, nasza aplikacja robi to, czego nie zobaczysz po prostu w Allegro Analytics – pokaże Ci wyniki każdej oferty osobno, każdej kategorii, w której sprzedajesz i pozwoli Ci korzystać z wymiarów i filtrów.
➔ Masz trudności z interpretowaniem danych dostępnych w AlleSpark? Przeczytaj nasz poradnik, który tłumaczy analizę Allegro z AlleSpark krok po kroku. Może Ci się także przydać nieco szerszy artykuł o analityce Allegro.

Allegro API funkcjonalności – tworzenie oferty powiązanej z produktem (przykład)
Do utworzenia oferty potrzebujesz POST /sale/product-offers.
➔ Wariant 1 – Jeśli produkt znajduje się w katalogu Allegro
KROK 1. Przekaż identyfikator produktu (np. GTIN), cenę i liczbę sztuk w strukturze żądania.
curl -X POST
'https://api.allegro.pl/sale/product-offers’
-H 'Authorization: Bearer {token}’
-H 'Accept: application/vnd.allegro.public.v1+json’
-H 'Content-Type: application/vnd.allegro.public.v1+json’
-d '{
„productSet”:
[{
„product”:
{
„id”: „5902719471797”, // numer GTIN, MPN lub ID produktu
„idType”: „GTIN” // typ wartości w polu „product.id”.
// Dla GTIN wskaż „GTIN”,dla numerów
// katalogowych nadanych przez producenta – „MPN”.
// Jeśli wskazujesz UUID produktu, pozostaw pole puste.
}
}],
„sellingMode”: {
„price”: {
„amount”: „220.85”, // cena
„currency”: „PLN”
}
},
„stock”: {
„available”: 10 // liczba sztuk
}
}’
KROK 2. Jeśli dane produktu są z jakiegoś powodu niekompletne, otrzymasz odpowiedź kodem 422 z komunikatem błędu
{
„errors”:[
{
„code”:”ConstraintViolationException.MissingRequiredParameters”,
„message”:”Missing required parameters: 209298, 356″,
„details”:”ConstraintViolationException.MissingRequiredParameters”,
„path”:”parameters”,
„userMessage”:”Uzupełnij parametry obowiązkowe: Skład zestawu, Pojemność.”,
„metadata”:{
}
}
]
}
Krok 3. Przekaż brakujące parametry obowiązkowe za pomocą tablicy productSet.product.parameters[].
➔ Wariant 2 – Jeśli nie wiesz, czy produkt znajduje się w katalogu Allegro lub chcesz utworzyć nowy produkt
KROK 1. Przekaż komplet danych na temat produktu w strukturze żądania w obiekcie product. Zestaw parametrów wspieranych zyskasz dzięki GET /sale/categories/{categoryId}/parameters. Nie umieszczaj żadnej wartości w polu product.id. Uzupełnij request informacjami na temat ceny produktu i liczby dostępnych sztuk.
curl -X POST
'https://api.allegro.pl/sale/product-offers’
-H 'Authorization: Bearer {token}’
-H 'Accept: application/vnd.allegro.public.v1+json’
-H 'Content-Type: application/vnd.allegro.public.v1+json’
-d '{
„productSet”: [{
„product”: {
„name”: „Produkt testowy”,
„category”: {
„id”: „89060”
},
„parameters”: [{
„name”: „EAN”,
„values”: [
„0744861045021”
]
},
{
„id”: „237218”,
„values”: [
„Testowy tytuł”
]
}
],
„images”: [
„https://…adres-pierwszego-obrazka.jpeg”
]
} }],
„sellingMode”: {
„price”: {
„amount”: „220.85”,
„currency”: „PLN”
}
},
„stock”: {
„available”: 10
}
}’
KROK 2. Nawet jeśli system rozpozna produkt, może okazać się, że część danych jest niezgodna z katalogiem Allegro. W takiej sytuacji otrzymasz odpowiedź z kodem 422.
„errors”: [
{
„code”: „PARAMETER_MISMATCH”,
„message”: „The provided parameter 'Wysokość produktu'(223329) value (202.00) does not match
the existing parameter value (22.00)”,
„details”: null,
„path”: „productSet[0].product.parameters”,
„userMessage”: „The specified product exists. The specified parameter `Wysokość produktu` with
the value `202.00` does not match the product parameter `22.00`.”,
„metadata”: {
„productId”: „8b6270a8-06c6-4ad7-a9c2-7443a79ea4ab”
}
}
]
}
KROK 3. Skoryguj wartości.
KROK 4. W polu metadata znajdziesz id rozpoznanego produktu. Jeśli chcesz, użyj go do stworzenia oferty zgodnie z instrukcją opisaną w wariancie 1.
➔ Wszystkie zamieszczone w tym artykule fragmenty kodu pochodzą ze strony Allegro Developer.
Spojrzenie na ekspansję zagraniczną Allegro i Allegro REST API
Ekspansja zagraniczna Allegro postępuje. Obecnie serwis posiada polską, czeską i słowacką odsłonę. Wkrótce pojawi się także na Węgrzech. Co ważne, sprzedawcy mogą prezentować swoje produkty nie tylko na domyślnym rynku, ale także we wszystkich zagranicznych domenach portalu. Oczywiście, aby to było możliwe, nie muszą tworzyć kilku ofert w różnych językach.
Dzięki Allegro REST API wystarczy wystawić daną ofertę raz, aby móc prowadzić sprzedaż na innych odsłonach portalu. To ogromne ułatwienie, które przekłada się na niebagatelną oszczędność czasu – zwłaszcza jeśli posiada się spory asortyment.
Allegro API – FAQ
Do czego służy Allegro API?
Allegro API (Allegro REST API) pozwala na prowadzenie komunikacji pomiędzy Allegro i innymi oprogramowaniami. Tym samym, dzięki Allegro API połączysz swoje konto na portalu z programem księgowym, magazynowym lub esklepem. Integracja sklepu internetowego z Allegro może znacznie ułatwić Ci pracę, przyspieszając, chociażby, proces wystawiania ofert w serwisie.
Czy API może usprawnić sprzedaż na Allegro?
Allegro REST API może usprawnić sprzedaż na Allegro. Dzięki API da się bowiem zautomatyzować wiele procesów: począwszy od wystawiania ofert, przez komunikowanie się z klientami, aż po pobieranie danych sprzedażowych. Ze względu na oszczędność czasu i zasobów to idealne rozwiązanie dla dużych sklepów, które każdego dnia realizują mnóstwo zamówień.
Czy Allegro API jest darmowe?
Korzystanie z Allegro API jest bezpłatne. Co więcej, ma do niego dostęp każdy użytkownik portalu. Wyjątkiem jest dostęp do Allegro Ads API, ponieważ przysługuje on jedynie agencjom Allegro Ads obsługującym konta Allegro.
Czy Allegro API pozwala na monitoring cen?
Monitorowanie cen na Allegro to bardzo ważna sprawa. Dzięki API Allegro można pobrać cenę danej oferty, co zdecydowanie ułatwia proces śledzenia zmian na portalu.
Forum API Allegro GitHub – czy znajdę tam ważne informacje?
Allegro nie prowadzi osobnego forum dla pytań dotyczących API. Wiele informacji możesz jednak znaleźć na GitHubie. Forum API Allegro GitHub to także dobre miejsce, aby zadać swoje pytanie.