SEO API

The DiagnoSEO Tools API provides developers, content creators, and SEO professionals with powerful AI-driven endpoints designed to automate and optimize every stage of the content creation process — from keyword research to article generation and final polish.
Each endpoint is lightweight, secure, and built for fast integration into your existing workflow or CMS.

With DiagnoSEO’s API, you can:

📝 Generate high-quality SEO content automatically

🎯 Extract TF-IDF keywords from any set of URLs

🧩 Create article structures (titles, outlines, sections, summaries, FAQs) in multiple languages

🤖 Humanize AI-generated text for a more natural, reader-friendly tone

💬 Encourage user engagement with “Did You Know” sections and comment incentives

All requests use standard POST methods and return clean, JSON-formatted responses.

Humanize AI

Make AI-generated text sound natural and engaging. This endpoint refines tone, improves readability, and removes robotic phrasing while preserving meaning. Perfect for post-editing GPT output before publishing.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/humanize-text
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • inputThe text you want to humanize
  • tone(Optional) Required tone of voice. Default value: same as original
  • quality(Optional) Output quality. Set to “hi” to use gpt-4.1 AI model, gpt-4.1-mini will be used otherwise

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • textHumanized text if status is ‘ok’

Keywords based on TF IDF

Extract the most relevant keywords from any set of URLs using TF-IDF analysis. Identify top-performing terms in your niche and optimize your content for higher search relevance.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/tfidf-keywords
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • urlsStringified JSON array of URLs

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • dataJSON-encoded array of objects. Each object contains 2 fields: word (the keyword) and tf_idf (TF IDF value for this word in the context of provided URLs. Example: {“word”: “pizza”, “tf_idf”: 0.68}

Generate article outline

Automatically create a logical, SEO-friendly structure for your article. Generate headings and subheadings based on your topic, tone, and keywords — ideal for planning high-quality blog content in seconds.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-outline
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • topicThe topic of your article
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • headingCount(Optional) Number of headings to generate. Default: 5
  • tone(Optional) Required tone of voice. Default value: conversational
  • examples(Optional) JSON-encoded array of example headings
  • keywords(Optional) JSON-encoded array of keywords for use in the generated headings
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • outlineJSON-encoded array of objects. Each object contains 2 fields: level (level of heading in hierarchy) and text (the text of the heading)

Generate article sections

Turn your outline into complete, well-written sections. This endpoint generates paragraph-level content with control over tone, length, and readability — helping you scale consistent, human-like writing.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-sections
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • topicThe topic of your article
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of section titles
  • pov(Optional) Point of view from which the text shoould be written. Default value: second person
  • tone(Optional) Required tone of voice. Default value: conversational
  • keywords(Optional) JSON-encoded array of keywords for use in the generated headings
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used
  • sources(Optional) JSON-encoded array of page contents/urls that serve as source of information
  • paragraphsPerSection(Optional) Number of paragraphs in each section
  • maxWordsPerSentence(Optional) Max. number of words per sentence
  • maxSentencesPerParagraph(Optional) Max. number of sentences per paragraph

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • dataJSON-encoded array of objects. Each object contains 2 fields: sectionTitle (the title of the section) and paragraphs (array of paragraph texts)

Generate article title

Craft attention-grabbing titles optimized for SEO and reader engagement. Input your topic, keywords, or section titles to get creative and relevant title ideas instantly.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-title
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • topicThe topic of your article
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of article section titles
  • keyword(Optional) Keyword for use in the title
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • textThe text of the title

Generate article intro

Produce a compelling article introduction that hooks readers immediately. The AI analyzes your sections and topic to write a concise, keyword-optimized intro that fits your content style.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-intro
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • topicThe topic of your article
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of section titles
  • sectionTextsJSON-encoded array of section texts
  • introLength(Optional) Max. number of words. Default: 100
  • keyword(Optional) Keyword for use in the intro
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • textThe text of the article intro

Generate article summary

Automatically summarize your content into a few coherent sentences. Ideal for meta descriptions, newsletter snippets, or quick article overviews that maintain context and clarity.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-summary
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of section titles
  • sectionTextsJSON-encoded array of section texts
  • pov(Optional) Point of view from which the text shoould be written. Default value: second person
  • tone(Optional) Required tone of voice. Default value: conversational
  • keyword(Optional) Keyword for use in the summary
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used
  • maxWordsPerSentence(Optional) Max. number of words per sentence
  • maxSentences(Optional) Max. number of sentences

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • textThe text of the article summary

Generate key points

Extract key takeaways from your content. This endpoint generates short, impactful bullet points summarizing each section — perfect for TL;DR blocks, slide decks, or summaries.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-key-points
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of section titles
  • sectionTextsJSON-encoded array of section texts
  • maxWordsPerSentence(Optional) Max. number of words in each key point
  • pov(Optional) Point of view from which the text shoould be written. Default value: second person
  • tone(Optional) Required tone of voice. Default value: conversational
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • pointsArray of key point texts

Generate ‘did you know’ section

Add engaging trivia or insights to your content. The “Did You Know” endpoint produces fact-based, conversational snippets that make your articles more interesting and interactive.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-did-you-know
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • topicThe topic of your article
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of section titles
  • sectionTextsJSON-encoded array of section texts
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used
  • sources(Optional) JSON-encoded array of page contents/urls that serve as source of information
  • pov(Optional) Point of view from which the text shoould be written. Default value: second person
  • tone(Optional) Required tone of voice. Default value: conversational

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • pointsArray of key point texts

Generate FAQ

Create SEO-optimized FAQs directly from your article. The AI analyzes content context and produces relevant questions and clear, concise answers to improve SERP visibility and user understanding.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-article-faq
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • topicThe topic of your article
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of section titles
  • sectionTextsJSON-encoded array of section texts
  • questionCountDesired number of questions in the FAQ
  • questions(Optional) JSON-encoded array of questions to include in FAQ
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used
  • keyword(Optional) Keyword for use in the FAQ
  • sources(Optional) JSON-encoded array of page contents/urls that serve as source of information
  • pov(Optional) Point of view from which the text shoould be written. Default value: second person
  • tone(Optional) Required tone of voice. Default value: conversational

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • questionsArray of objects, each of them contains the following fields: q (question text) and a (answer text)

Generate comment incentive

Encourage audience engagement by adding a smart comment prompt at the end of your post. This endpoint generates short, natural closing lines that invite readers to share their opinions or experiences.

Endpoint URL: https://app.diagnoseo.com/tools/api/public/generate-comment-incentive
Request method: POST

Request fields

  • apikeyYour DiagnoSEO API key
  • languageLanguage of your article, e.g. ‘spanish’ or ‘english’
  • sectionTitlesJSON-encoded array of section titles
  • sectionTextsJSON-encoded array of section texts
  • forbiddenWords(Optional) JSON-encoded array of words that must not be used
  • tone(Optional) Required tone of voice. Default value: conversational
  • maxWords(Optional) Max. number of words. Default value: 60

Response fields

  • status‘ok’ in case of success, ‘error’ otherwise
  • messageBrief information on the cause of error if it occurs
  • textThe generated text of the comment incentive