AI Content Optimization API – Content input

API endpoint → https://api.seoreviewtools.com/ai-content-optimization/?content=1

Price: 1 credits per request

Description: Discover how well an article is structured for AI answers and LLM retrieval (GEO). Designed for content publishers and content creating environments (custom CMS, news sites or e-commerce platforms).

Query string parameters

Name	Parameter	Description
Key	&key=	Your private API key

JSON POST object (required)

Use JSON to post the data to the API.

JSON POST structure:

content_input	Description
title_tag	The web page title
meta_description	A brief summary of the web page
body_content	The body content including HTML formatting (paragraph tags, headings, tables, images, links and more …)

Code example

{
  "content_input": {
    "title_tag": "Example document title",
    "meta_description": "Example document Meta Description",
    "body_content": "<h1>Example document Heading</h1><p>Example content including HTML formatting ... </p>"
  }

Response elements

Category	Name
content citability ↴
	readability
	freshness
	top-of-page content
	faq content
	table of contents
	in-content tags
meta data ↴
	title tag
	meta description
semantic structure ↴
	headings
	table and list elements
	content depth
	links
media ↴
	images and video

AI Content Score interpretation

This overview shows how you should interpret the AI content score, returned by the API.

Score	Description
75% – 100%	The content is well optimized for AI.
51% – 74%	The content needs work to improve its visibility potential in AI
0% – 50%	The content is poorly optimized for AI

Feedback classes

The element specific feedback classes are designed to help you structure and visually style the output for the end users.

Feedback class name	Description
positive	Element is optimized for AI
negative	Element is NOT optimized for AI
couldhave	Element can be further optimized for AI

Tool: AI Content Optimization Checker

PHP code example


<?php                    



/*

    API documentation for SEO Review Tools.

    API info: https://www.seoreviewtools.com/seo-api/

    API documentation: https://api.seoreviewtools.com/documentation/

    LinkedIn: https://www.linkedin.com/company/seo-review-tools

*/





function curlFunction ($toolRequestUrl, $data){

    $ch = curl_init();

    curl_setopt($ch, CURLOPT_URL, $toolRequestUrl);

    curl_setopt($ch, CURLOPT_HEADER, 0);

    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    curl_setopt($ch, CURLOPT_POST, 1);

    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); 

    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST,false); 

    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    curl_setopt($ch,CURLOPT_POSTFIELDS, $data);

    $html = curl_exec($ch);

    $curlInfo = curl_getinfo($ch);

    return($html);

}    



// Title tag

$title_tag = 'AI Visibility Tool 3.1 - SEO Review Tools';    

// Meta description        

$meta_description = '';



// Content to check

$body_content = '

<article>

  <h2>AI Visibility Checker.</h2>



  <blockquote>

    <p>

      <strong>Update</strong>: Additional visibility metrics are 

      <a href="#visibility_metrics"><strong>Now available -> </strong></a>

    </p>

  </blockquote>



  <p>

    The AI Brand Visibility tool is designed to analyze and compare how different AI models perceive your brand and associated product/services. Discover how popular LLMs look at your brand including: brand awareness, credibility and competitors. Generate a report to evaluate your visibility in Google Gemini, ChatGPT and Perplexity to see how you perform compared to your competitors in AI powered search.

  </p>



  <p>

    <noscript>

      <img src="https://www.seoreviewtools.com/wp-content/uploads/AI-brand-report-1.2.png" alt="AI Brand Report - SEO Review" />

    </noscript>

    <img src="https://www.seoreviewtools.com/wp-content/uploads/AI-brand-report-1.2.png" alt="AI Brand Report - SEO Review">

  </p>



  <blockquote>

    <p>

      The AI Brand Visibility report is powered by our latest 

      <a href="https://www.seoreviewtools.com/ai-visibility-api/">

        <strong>AI brand research APIs -></strong>

      </a>

    </p>

  </blockquote>



  

 </article>



'; 







$body_content = mb_convert_encoding($body_content, 'UTF-8', 'UTF-8');





$data = [

    'content_input' => [

        'title_tag' => $title_tag, 

        'meta_description' => $meta_description,  

        'body_content' => trim($body_content)

    ]

];







// Encode data array to JSON

$data = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);



// API key 

$apiKey = 'YOUR-API-KEY';



$toolRequestUrl = "https://api.seoreviewtools.com/ai-content-optimization/?content=1&key=".urlencode($apiKey);



$aiDataJson = curlFunction($toolRequestUrl, $data);



header("Content-type: application/json");

echo($aiDataJson);    

                                    

?>

cURL code example


curl -X POST "https://api.seoreviewtools.com/ai-content-optimization/?content=1&key=YOUR-API-KEY" \

     -H "Content-Type: application/json" \

     -d '{

          "content_input": {

            "title_tag": "AI Visibility Tool 3.1 - SEO Review Tools",

            "meta_description": "",

            "body_content": "<article><h2>AI Visibility Checker.</h2><p>The AI Brand Visibility tool is designed to analyze brand awareness...</p></article>"

          }

        }'

Python code example

# API documentation for SEO Review Tools.
# API info: https://www.seoreviewtools.com/seo-api/
# API documentation: https://api.seoreviewtools.com/documentation/
# LinkedIn: https://www.linkedin.com/company/seo-review-tools

import requests
import json

# 1. Configuration & Data
api_key = 'YOUR-API-KEY'
title_tag = 'AI Visibility Tool 3.1 - SEO Review Tools'
meta_description = ''

# Content to check
body_content = """
<article>
  <h2>AI Visibility Checker.</h2>
  <blockquote>
    <p>
      <strong>Update</strong>: Additional visibility metrics are 
      <a href="#visibility_metrics"><strong>Now available -> </strong></a>
    </p>
  </blockquote>
  <p>
    The AI Brand Visibility tool is designed to analyze and compare how different AI models perceive your brand...
  </p>
  <p>
    <img src="https://www.seoreviewtools.com/wp-content/uploads/AI-brand-report-1.2.png" alt="AI Brand Report - SEO Review">
  </p>
  <blockquote>
    <p>
      The AI Brand Visibility report is powered by our latest 
      <a href="https://www.seoreviewtools.com/ai-visibility-api/">
        <strong>AI brand research APIs -></strong>
      </a>
    </p>
  </blockquote>
 </article>
"""

# 2. Structure the payload
# Python dictionaries map perfectly to PHP associative arrays
payload = {
    'content_input': {
        'title_tag': title_tag,
        'meta_description': meta_description,
        'body_content': body_content.strip()
    }
}

# 3. API URL (Note the content=1 flag)
tool_request_url = f"https://api.seoreviewtools.com/ai-content-optimization/?content=1&key={api_key}"

try:
    # 4. Perform the POST request
    # Using json=payload automatically sets Content-Type to application/json
    # and handles json.dumps() for you.
    response = requests.post(tool_request_url, json=payload, verify=True)

    # 5. Output the result
    if response.status_code == 200:
        # Parse the JSON response
        result = response.json()
        print(json.dumps(result, indent=4))
    else:
        print(f"HTTP Error: {response.status_code}")
        print(response.text)

except requests.exceptions.RequestException as e:
    print(f"Connection Error: {e}")

JSON response example

{
    "status": "ok",
    "tool name": "AI content optimization",
    "overview": {
        "overall score": 33,
        "available points": 620,
        "earned points": 204.175,
        "summary": {
            "recommendations": 7,
            "warnings": 3,
            "optimized": 5
        }
    },
    "excluded_tools": 0,
    "data": {
        "content citability": {
            "overview": {
                "category score": 14,
                "available points": 210,
                "earned points": 29.775
            },
            "readability": {
                "readability formula": "Flesch Kincaid Reading Ease",
                "score": 42,
                "grade level": "College",
                "label": "Difficult to read",
                "feedback": [
                    {
                        "text": "Content is \"Difficult to read\", consider simplifying your content for broader coverage",
                        "class": "negative"
                    }
                ],
                "explanation": "Content that is easy to read is also easier for language models to understand, chunk, and reuse when generating answers",
                "impact": "high",
                "affecting": "AIO, User",
                "data": {
                    "reading time": "0 min 22 sec",
                    "speaking time": "0 min 31 sec",
                    "avg. word length": "5 characters",
                    "avg. sentence length": "18 words",
                    "avg. paragraph length": "1 sentences"
                }
            },
            "freshness": {
                "date detected": false,
                "content age": "N\/A",
                "most recent source": "N\/A",
                "feedback": [
                    {
                        "text": "No \"publication\" or \"last updated\" dates detected, consider adding both dates to your content",
                        "class": "negative"
                    }
                ],
                "explanation": "AI models favour recent data to provide accurate up-to-date answers",
                "impact": "high",
                "affecting": "AIO, SEO, User",
                "data": {
                    "publication date": "N\/A",
                    "last updated": "N\/A"
                }
            },
            "top-of-page content": {
                "lead paragraph detected": true,
                "lead paragraph characters": 58,
                "lead paragraph word count": 8,
                "feedback": [
                    {
                        "text": "Lead paragraph detected",
                        "class": "positive"
                    },
                    {
                        "text": "Short lead paragraph detected, consider extending it to 120 characters",
                        "class": "couldhave"
                    }
                ],
                "explanation": "A high percentage of content referenced by LLMs comes from top-of-page-content",
                "impact": "medium",
                "affecting": "AIO, User",
                "data": {
                    "tag": "P",
                    "content": "Update: Additional visibility metrics are Now available ->"
                }
            },
            "faq content": {
                "faq detected": false,
                "faq count": 0,
                "schema detected": false,
                "feedback": [
                    {
                        "text": "No FAQ style content detected, consider adding Q&A formatted content to make it easier to retrieve",
                        "class": "negative"
                    }
                ],
                "explanation": "FAQs make it easier for LLMs to understand, retrieve, and reuse specific pieces of information",
                "impact": "medium",
                "affecting": "AIO, SEO, User",
                "data": []
            },
            "table of contents": {
                "toc detected": false,
                "toc items count": 0,
                "feedback": [
                    {
                        "text": "No Table of contents detected, consider adding a (TOC) to improve content accessibility",
                        "class": "negative"
                    }
                ],
                "explanation": "A table of contents acts as a roadmap, helping LLMs navigate and structure the content of a document",
                "impact": "medium",
                "affecting": "AIO, User",
                "data": []
            },
            "in-content tags": {
                "in-content tags detected": true,
                "in-content tag count": 3,
                "in-content tag types": "strong",
                "feedback": [
                    {
                        "text": "In content tags detected to place more weight on specific topics",
                        "class": "positive"
                    }
                ],
                "explanation": "Content tags such as <code><em><\/code> and <code><strong><\/code> place more weight on specific entities \/ topics referenced in your content",
                "impact": "medium",
                "affecting": "AIO, User",
                "data": [
                    {
                        "tag": "strong",
                        "content": "Update"
                    },
                    {
                        "tag": "strong",
                        "content": "Now available ->"
                    },
                    {
                        "tag": "strong",
                        "content": "AI brand research APIs ->"
                    }
                ]
            }
        },
        "meta data": {
            "overview": {
                "category score": 69,
                "available points": 130,
                "earned points": 90
            },
            "title tag": {
                "title tag detected": true,
                "title tag count": 1,
                "title tag characters": 41,
                "title tag words": 7,
                "feedback": [
                    {
                        "text": "The Title tag contains 41 characters, utilizing the total available characters effectively",
                        "class": "positive"
                    }
                ],
                "explanation": "The Title Tag helps LLMs to define the main topic and intent of a page",
                "impact": "high",
                "affecting": "AIO, SEO, User",
                "data": [
                    "AI Visibility Tool 3.1 - SEO Review Tools"
                ]
            },
            "meta description": {
                "meta description detected": false,
                "meta description count": 0,
                "meta description characters": 0,
                "meta description words": 0,
                "feedback": [
                    {
                        "text": "No Meta description detected, add a Meta description containing (100 - 160) characters",
                        "class": "negative"
                    }
                ],
                "explanation": "The Meta Description Tag provides LLMs with a quick page summary",
                "impact": "medium",
                "affecting": "AIO, SEO, User",
                "data": []
            }
        },
        "semantic structure": {
            "overview": {
                "category score": 17,
                "available points": 235,
                "earned points": 39.4
            },
            "headings": {
                "h1 detected": false,
                "h1 count": 0,
                "subheadings detected": true,
                "heading hierarchy": "consistent",
                "heading types": "h2",
                "total number of headings": 1,
                "empty headings detected": false,
                "duplicate headings detected": false,
                "feedback": [
                    {
                        "text": "No H1 tag detected, add a H1 tag to your content",
                        "class": "negative"
                    },
                    {
                        "text": "Correct subheading hierarchy detected",
                        "class": "positive"
                    }
                ],
                "explanation": "Headings (H1 - H4) help structure your content and organize related subtopics",
                "impact": "medium",
                "affecting": "AIO, SEO, User",
                "data": [
                    {
                        "tag": "h2",
                        "content": "AI Visibility Checker."
                    }
                ]
            },
            "table and list elements": {
                "lists detected": 0,
                "tables detected": 0,
                "feedback": [
                    {
                        "text": "No 0 List(s) and 0 Table(s) detected, consider adding one of these elements",
                        "class": "negative"
                    }
                ],
                "explanation": "Table and List elements are a very effective format of providing structured content to LLMs",
                "impact": "high",
                "affecting": "AIO, User",
                "data": {
                    "list elements": [],
                    "table elements": []
                }
            },
            "content depth": {
                "content detected": true,
                "total words detected": 120,
                "paragraphs count": 3,
                "avg words per paragraph": 28,
                "feedback": [
                    {
                        "text": "Insufficient content depth (120 words) detected, add at least (400 words) for broader topic coverage",
                        "class": "couldhave"
                    }
                ],
                "explanation": "A sufficient number of paragraphs helps ensure content depth and broad topic coverage for LLM extraction",
                "impact": "high",
                "affecting": "AIO, SEO, User",
                "data": "AI Visibility Checker Update Additional visibility metrics are Now available Update Additional visibility metrics are Now available Update Now available Now available The AI Brand Visibility tool is designed to analyze and compare how different AI models perceive your brand and associated product services Discover how popular LLMs look at your brand including brand awareness credibility and competitors Generate a report to evaluate your visibility in Google Gemini ChatGPT and Perplexity to see how you perform compared to your competitors in AI powered search The AI Brand Visibility report is powered by our latest AI brand research APIs The AI Brand Visibility report is powered by our latest AI brand research APIs AI brand research APIs AI brand research APIs"
            },
            "links": {
                "total links": 2,
                "external links": 0,
                "internal links": 2,
                "nofollow count": 0,
                "duplicate links": 0,
                "no alt tag": 0,
                "feedback": [
                    {
                        "text": "low number of internal links detected, consider adding > 2 internal links to improve relevant page structure",
                        "class": "couldhave"
                    }
                ],
                "explanation": "Internal links create entry points that help connect and surface relevant documents",
                "impact": "medium",
                "affecting": "AIO, SEO, User",
                "data": [
                    {
                        "url": "#visibility_metrics",
                        "anchor text": "Now available -&gt;",
                        "anchor type": "Text",
                        "link type": "Internal",
                        "nofollow": "0"
                    },
                    {
                        "url": "https:\/\/www.seoreviewtools.com\/ai-visibility-api\/",
                        "anchor text": "AI brand research APIs -&gt;",
                        "anchor type": "Text",
                        "link type": "subdomain",
                        "nofollow": "0"
                    }
                ]
            }
        },
        "media": {
            "overview": {
                "category score": 100,
                "available points": 45,
                "earned points": 45
            },
            "images and video": {
                "images detected": 1,
                "videos detected": 0,
                "missing alt tags": 0,
                "feedback": [
                    {
                        "text": "1 Image(s) and 0 Video(s) detected",
                        "class": "positive"
                    }
                ],
                "explanation": "LLMs prefer to return both text and visual content in their answers",
                "impact": "high",
                "affecting": "AIO, SEO, User",
                "data": {
                    "Images": [
                        {
                            "type": "img",
                            "src": "https:\/\/www.seoreviewtools.com\/wp-content\/uploads\/AI-brand-report-1.2.png",
                            "alt": "AI Brand Report - SEO Review"
                        }
                    ],
                    "Videos": []
                }
            }
        }
    }
}

Ready to start testing the AI Content Optimization API – Content input endpoint? Get your API Key →

Trusted by →