O tym API
UN Comtrade to prowadzona przez Wydział Statystyczny ONZ (UNSD) baza oficjalnych statystyk handlu towarami (i usługami) zgłaszanych przez blisko 200 krajów i terytoriów. API udostępnia dane w formacie REST/JSON: przepływy eksportu i importu z wartościami oraz ilościami, według krajów zgłaszających, partnerów, kierunku przepływu i klasyfikacji towarowej. Warstwa preview (ścieżka /public/v1/preview/) jest publiczna, nie wymaga konta ani klucza i nadaje się do szybkich testów oraz małych zapytań, ale ogranicza wynik do 500 rekordów i podlega limitowi częstotliwości. Do pełnych, dużych pobrań (do 250 000 rekordów na zapytanie) służy pełne API pod odrębną ścieżką, wymagające bezpłatnego klucza subskrypcyjnego z konta UN Comtrade. Dane są objęte polityką ONZ dotyczącą wykorzystania i redystrybucji — przeznaczone do użytku wewnętrznego, a ich ponowne rozpowszechnianie wymaga zgody.
Najczęstsze pytania
Czy trzeba mieć klucz API?
W warstwie preview nie — działa bez rejestracji i bez klucza, ale jest ograniczona do 500 rekordów na zapytanie i objęta limitem częstotliwości. Pełne API (do 250 000 rekordów na zapytanie) wymaga bezpłatnego klucza subskrypcyjnego z konta UN Comtrade.
Jakie dane zwraca to API?
Roczne i miesięczne statystyki handlu towarami (oraz usługami): wartości i ilości eksportu i importu w podziale na kraj zgłaszający, kraj partnera, kierunek przepływu (eksport/import) i kod towarowy w klasyfikacjach HS, SITC lub BEC. Odpowiedź w formacie JSON.
Czy można wywołać to API bezpośrednio z przeglądarki?
Nie. API nie zwraca nagłówków CORS zezwalających na wywołania z innych domen, więc kod frontendowy w przeglądarce zostanie zablokowany — trzeba je wywoływać po stronie serwera. Dlatego nie ma tu żywego przycisku „Wypróbuj”.
Kto prowadzi to API?
Organizacja Narodów Zjednoczonych — baza UN Comtrade prowadzona przez Wydział Statystyczny ONZ (UNSD). Dokumentacja: uncomtrade.org.