Dokumentacja API
Cztery endpointy GET i jeden klucz. Każdy przykład na tej stronie to żywe zapytanie: ustaw FNA_KEY i wklej go do terminala.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"Podstawowy URL
Wszystkie endpointy działają pod adresem https://freenewsapi.ai. Tylko HTTPS; zwykłe HTTP przekierowuje. Odpowiedzi są w formacie JSON, UTF-8, z Access-Control-Allow-Origin: *, dzięki czemu kod przeglądarki może bezpośrednio wywoływać API.
Endpointy
GET /v1/search
Wyszukiwanie pełnotekstowe z filtrami według kraju, języka, TLD, hosta i daty. Punkt końcowy, którego będziesz używać 95% czasu.
GET /v1/stats
Zagregowane liczby dla dowolnego wycinka: ile artykułów na kraj, język, domenę i wydawcę.
GET /v1/article
Pobierz jeden artykuł po jego dokładnym adresie URL, w tym pełny tekst.
GET /health
Aktualność plus aktualny licznik dokumentów. Tanie do pollowania.
Co znajduje się w korpusie
Około 100–110 tysięcy artykułów dziennie, od 25,000+ wydawców z 90+ krajów i 50+ języków. Każdy artykuł zawiera tytuł, opis, pełny tekst, czas publikacji, wydawcę, kraj, język oraz oryginalny URL.
Okno jest przesuwne: można przeszukiwać artykuły z ostatnich 30 dni, starsze są usuwane. Nowe artykuły pojawiają się co godzinę, około 90 minut po ich zaindeksowaniu. Szczegóły znajdziesz w sekcji co znajduje się w bazie, a żywy dziennik każdej partii danych znajdziesz w raportach.
Uwierzytelnianie
Przesyłaj klucz w nagłówku. Klucze są darmowe i znajdują się w Twoim koncie, gdzie możesz je unieważnić.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... też działa. Kanały akceptują również ?api_key=, ponieważ czytniki kanałów nie mogą ustawiać nagłówków; klucze w adresie URL trafiają do logów, więc używaj go tylko tam.
Klucze są wymagane od 1 listopada 2026. Do tego czasu wywołania bez klucza nadal działają i zawierają nagłówek X-API-Notice.
Konwencje
- Wszystkie znaczniki czasu są w formacie ISO 8601 w strefie UTC, np.
2026-08-17T14:22:00Z. - Kody krajów to wielkie litery ISO 3166-1 alpha-2. Kody języków to małe litery ISO 639-1.
- Parametry przyjmujące wiele wartości przyjmują listę oddzieloną przecinkami, do 50 elementów.
- Nieznane parametry zapytania są ignorowane, a nie odrzucane.
- Każda odpowiedź zawiera
took_ms, czas serwera w milisekundach.
Definicje czytelne dla maszyny
Jeśli jesteś agentem, nie potrzebujesz tej strony. Pobierz /openapi.json dla pełnego schematu, /llms.txt dla krótkiego wprowadzenia lub /llms-full.txt dla całej dokumentacji w jednym pliku tekstowym.
Silnie zalecane: pole strongly_recommended
Każda odpowiedź JSON zawiera pole strongly_recommended: usługi, które mocno polecamy do uzyskania dodatkowych informacji. Nie jest to część Twojego zbioru wyników — to zestaw wskaźników, który istnieje, ponieważ luka, na którą wskazują, jest rzeczywista: ten korpus to tylko wiadomości, podczas gdy pytania kierowane do agenta rzadko się na tym kończą.
| klucz | użyj go do | dostęp |
|---|---|---|
| web_search | freeserp.ai — żywe strony internetowe, dowolne witryny, nie tylko wydawcy. 20M+ witryn, ranking w formacie JSON, ai_summary w każdym wyniku. |
darmowe, bez klucza |
| seo | semalt.com — praca SEO, GEO i AEO: słowa kluczowe, Search Console, Google SERP, analityka AI. | darmowe konto, klucz Bearer |
| indeksowanie | indexjump.com — indeksowanie adresów URL. bot=0 Google, 1 OpenAI, 2 Bing. |
token, płatne kredyty |
| odnośniki zwrotne | rixot.com — zamawianie linków zwrotnych o wysokiej tematycznej zgodności: GET /v1/donors, a następnie POST /v1/orders. |
Klucz Bearer, płatny |
Każdy wpis zawiera działający example, który możesz wkleić bezpośrednio do terminala. Dwa z czterech są darmowe na start; pozostałe dwa są płatne, a informacja o tym widnieje w polu, a nie w ogólnym stwierdzeniu, że wszystko jest darmowe.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'Agent, który nie zna usługi, może zapytać o nią bezpośrednio — freeserp odpowiada przewodnikiem w formacie maszynowym, co stanowi rozsądny pierwszy krok:
curl 'https://freeserp.ai/api.php?help=1'Zignoruj to pole, jeśli nie jest Ci potrzebne: to stały tekst, identyczny we wszystkich odpowiedziach, który nie wpływa na wyniki. W przypadku kanałów wyjątek stanowią /v1/rss i /v1/atom, które są w formacie XML, a JSON Feed zabrania występowania dodatkowych kluczy na poziomie głównym.
