SEO API
Interfejs DiagnoSEO Tools API zapewnia programistom, twórcom treści i specjalistom SEO potężne, oparte na sztucznej inteligencji punkty końcowe (endpoints), zaprojektowane do automatyzacji i optymalizacji każdego etapu procesu tworzenia treści — od analizy słów kluczowych po generowanie artykułów i końcowe dopracowanie.
Każdy endpoint jest lekki, bezpieczny i stworzony z myślą o szybkiej integracji z istniejącym środowiskiem pracy lub CMS-em.
Dzięki API DiagnoSEO możesz:
📝 Automatycznie generować wysokiej jakości treści SEO
🎯 Wyodrębniać słowa kluczowe TF-IDF z dowolnego zestawu adresów URL
🧩 Tworzyć struktury artykułów (tytuły, konspekty, sekcje, podsumowania, FAQ) w wielu językach
🤖 „Uczłowieczać” teksty wygenerowane przez AI, nadając im naturalny i przyjazny ton
💬 Zwiększać zaangażowanie użytkowników poprzez sekcje „Czy wiesz, że…” i zachęty do komentowania
Wszystkie zapytania wykorzystują standardową metodę POST i zwracają przejrzyste odpowiedzi w formacie JSON.
Humanize AI
Nadaj tekstom generowanym przez AI naturalne i angażujące brzmienie. Ten endpoint poprawia ton wypowiedzi, zwiększa czytelność i usuwa nienaturalne zwroty, zachowując przy tym pierwotne znaczenie. Idealny do obróbki tekstu z GPT przed publikacją.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/humanize-text
Metoda: POST
Pola zapytania:
- apikey – Twój klucz API DiagnoSEO
- input – Tekst, który chcesz „uczłowieczyć”
- tone (opcjonalne) – Wymagany ton wypowiedzi. Domyślnie: taki sam jak oryginał
- quality (opcjonalne) – Jakość wyjściowa. Ustaw „hi”, aby użyć modelu gpt-4.1 (domyślnie używany jest gpt-4.1-mini)
Pola odpowiedzi:
- status – „ok” w przypadku sukcesu, „error” w przeciwnym razie
- message – Krótki opis przyczyny błędu (jeśli wystąpi)
- text – Uczłowieczony tekst (jeśli status = „ok”)
Słowa kluczowe oparte na TF-IDF
Wyodrębnij najistotniejsze słowa kluczowe z dowolnych adresów URL, korzystając z analizy TF-IDF. Zidentyfikuj najczęściej występujące i najbardziej wartościowe terminy w swojej niszy, aby zoptymalizować treści pod kątem SEO.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/tfidf-keywords
Metoda: POST
Pola zapytania:
- apikey – Twój klucz API DiagnoSEO
- urls – Tekstowy (stringified) JSON zawierający tablicę adresów URL
Pola odpowiedzi:
- status – „ok” w przypadku sukcesu, „error” w przeciwnym razie
- message – Krótki opis przyczyny błędu (jeśli wystąpi)
- data – Tablica obiektów JSON; każdy zawiera pola:
- word (słowo kluczowe)
- tf_idf (wartość TF-IDF tego słowa w kontekście podanych URL, np.
{"word": "pizza", "tf_idf": 0.68})
Generowanie konspektu artykułu
Automatycznie utwórz logiczną, przyjazną SEO strukturę artykułu. Endpoint generuje nagłówki i podnagłówki na podstawie tematu, tonu i słów kluczowych — idealny do szybkiego planowania wysokiej jakości treści blogowych.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-outline
Metoda: POST
Pola zapytania:
- apikey – Twój klucz API DiagnoSEO
- topic – Temat artykułu
- language – Język artykułu (np. „spanish”, „english”)
- headingCount (opcjonalne) – Liczba nagłówków do wygenerowania (domyślnie 5)
- tone (opcjonalne) – Wymagany ton wypowiedzi (domyślnie: konwersacyjny)
- examples, keywords, forbiddenWords (opcjonalne) – Tablice JSON z przykładami nagłówków, słowami kluczowymi lub zakazanymi słowami
Pola odpowiedzi:
- status – „ok” lub „error”
- message – Opis błędu
- outline – Tablica obiektów z polami:
- level – Poziom nagłówka w hierarchii
- text – Tekst nagłówka
Generowanie sekcji artykułu
Przekształć konspekt w kompletne, dobrze napisane sekcje. Ten endpoint generuje teksty akapitów z kontrolą nad tonem, długością i czytelnością — idealny do tworzenia spójnych, naturalnych treści w większej skali.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-sections
Metoda: POST
Pola zapytania:
(apikey, topic, language, sectionTitles + parametry opcjonalne: pov, tone, keywords, forbiddenWords, sources, paragraphsPerSection, maxWordsPerSentence, maxSentencesPerParagraph)
Pola odpowiedzi:
- status – „ok” lub „error”
- message – Opis błędu
- data – Tablica obiektów zawierająca:
- sectionTitle – Tytuł sekcji
- paragraphs – Tablica akapitów
Generowanie tytułu artykułu
Twórz przyciągające uwagę tytuły zoptymalizowane pod SEO i zaangażowanie czytelników. Podaj temat, słowa kluczowe lub tytuły sekcji, aby natychmiast uzyskać kreatywne i trafne propozycje tytułów.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-title
Metoda: POST
Pola zapytania:
apikey, topic, language, sectionTitles, (opcjonalnie keyword, forbiddenWords)
Pola odpowiedzi:
status, message, text (tekst wygenerowanego tytułu)
Generowanie wstępu artykułu
Wygeneruj atrakcyjny wstęp do artykułu, który natychmiast przyciągnie uwagę czytelnika. Sztuczna inteligencja analizuje temat i sekcje, by stworzyć zwięzły, zoptymalizowany pod kątem słów kluczowych wstęp dopasowany do stylu treści.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-intro
Metoda: POST
Pola zapytania:
apikey, topic, language, sectionTitles, sectionTexts, (opcjonalnie introLength, keyword, forbiddenWords)
Pola odpowiedzi:
status, message, text (tekst wygenerowanego wstępu)
Generowanie podsumowania artykułu
Automatycznie streszczaj treść w kilku spójnych zdaniach. Idealne do opisów meta, newsletterów lub szybkich przeglądów artykułów, zachowujących sens i kontekst.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-summary
Metoda: POST
Pola zapytania:
apikey, language, sectionTitles, sectionTexts, (opcjonalne: pov, tone, keyword, forbiddenWords, maxWordsPerSentence, maxSentences)
Pola odpowiedzi:
status, message, text (tekst podsumowania)
Generowanie kluczowych punktów (key points)
Wydobądź najważniejsze wnioski z treści. Endpoint generuje krótkie, konkretne punkty podsumowujące każdą sekcję — idealne do bloków TL;DR, prezentacji lub streszczeń.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-key-points
Metoda: POST
Pola zapytania:
apikey, language, sectionTitles, sectionTexts, (opcjonalne: maxWordsPerSentence, pov, tone, forbiddenWords)
Pola odpowiedzi:
status, message, points (tablica wygenerowanych punktów)
Generowanie sekcji „Czy wiesz, że…”
Dodaj ciekawostki lub fakty, które wzbogacą Twój artykuł. Endpoint „Did You Know” tworzy angażujące, oparte na faktach fragmenty w lekkim, rozmownym tonie.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-did-you-know
Metoda: POST
Pola zapytania:
apikey, topic, language, sectionTitles, sectionTexts, (opcjonalne: forbiddenWords, sources, pov, tone)
Pola odpowiedzi:
status, message, points (tablica ciekawostek)
Generowanie FAQ
Utwórz zoptymalizowaną pod SEO sekcję FAQ bezpośrednio z treści artykułu. AI analizuje kontekst i tworzy trafne pytania wraz z jasnymi, zwięzłymi odpowiedziami, poprawiając widoczność w wyszukiwarkach i zrozumiałość dla użytkownika.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-faq
Metoda: POST
Pola zapytania:
apikey, topic, language, sectionTitles, sectionTexts, questionCount, (opcjonalne: questions, forbiddenWords, keyword, sources, pov, tone)
Pola odpowiedzi:
status, message, questions (tablica obiektów z polami: q – pytanie, a – odpowiedź)
Generowanie zachęty do komentowania
Zwiększ zaangażowanie odbiorców, dodając inteligentne wezwanie do dyskusji na końcu posta. Ten endpoint generuje krótkie, naturalne zdania zachęcające czytelników do dzielenia się opiniami lub doświadczeniami.
Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-comment-incentive
Metoda: POST
Pola zapytania:
apikey, language, sectionTitles, sectionTexts, (opcjonalne: forbiddenWords, tone, maxWords)
Pola odpowiedzi:
status, message, text (tekst wygenerowanej zachęty do komentarza)