Helpful content analysis API- Content Input

API endpoint → https://api.seoreviewtools.com/helpful-content-analysis/?content=1

Price: 6 credits per request

Description: The Helpful Content Analysis API helps to discover content that meets the requirements for being considered helpful, as well as identify content that needs attention. This API endpoints uses the Google helpful content guidelines, Google quality rater guidelines and a custom trained AI to score the content that’s posted to the API.

Query string parameters

Name	Parameter	Description
Key	&key=	Your private API key

JSON POST data (required)

Use JSON formatting ((UTF-8) to post the content to the API. Input limit ≈ 500K characters / ≈ 380 words. Use basic HTML markup to make give the API better understanding of your content.

Allowed HTML tags:

Headings (H1 – H6)
Paragraph tags
Blockquotes
Links
Image tags
List tags
Strong, em, etc.

Response elements

Name	Description
helpful content score	The score for your content on a 0 – 100 scale (percentage).
helpful content status	The status for your content. Result options: Passed, Needs work, Failed
available points	The sum all the available points
earned points	The exact number of earned points
category score	– content and quality (score, available points and earned points) – expertise (score, available points and earned points) – people-first content (score, available points and earned points)
content and quality	rating feedback
expertise	rating feedback
people-first content	rating feedback

helpful content score interpretation

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

Score	Description
70% – 100%	The content passed the helpful content analysis
55% – <= 70%	The content needs work to pass he helpful content analysis
0% – < 55%	The content failed the helpful content analysis

Google helpful content guidelines

The API provides a summary of Google’s content guidelines to assist editors in determining whether Google will classify the content as ‘helpful’.

Question category	Description
Content and quality	These questions evaluate content quality, including originality, value, and accuracy.
Expertise	These questions gauge content trustworthiness and expertise, considering factors like sourcing, author background, site reputation, and factual accuracy.
Focus on people-first content	These questions evaluate the alignment of content with the target audience.

PHP
Python

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); 
}     
 
 
// Content to check 
$data = '  
<h2>Check page headings, with the HTML Headings tool.</h2> 
<p>Headings are used to structure the textual content of a web page and are an important on-page SEO factor. The most important heading is the H1 heading followed by the H2 and H3. There are six levels of headings available from H1 to H6.</p> 
<p>The H1 heading should contain the main subject of a page. Use only one H1 on a web page.</p> 
<blockquote> 
<p><strong>TIP</strong>: now also available as <a class="btn btn-desult btn-bdr-black" href="https://api.seoreviewtools.com/documentation/content-apis/headings-api/">API end-point →</a></p> 
</blockquote> 
<img class="alignleft reviewed  size-thumbnail " src="https://www.seoreviewtools.com/wp-content/uploads/ann-smart.jpg" alt="Ann Smarty" /><img class="tlogo" src="https://www.seoreviewtools.com/wp-content/uploads/internet-marketing-ninjas.png" alt="internet marketing ninjas" /> 
<p>Ann Smarty featured this tool as part of her blog post: <a class="external" href="https://www.singlegrain.com/content-marketing-strategy-2/how-and-why-to-create-an-effective-content-structure-for-better-ranking/" target="_blank" rel="nofollow noopener noreferrer">How (and Why) to Create an Effective Content Structure for Better Ranking</a><br />“To quickly see your (or your competitor’s) on-page subheads, use this handy tool which extracts HTML headings from any web page. ...extract subheadings from any page and read through them to make sure they make sense even without the full context, flow well and provide a good outline of your on-page content.”</p> 
<p><strong>Ann Smarty</strong> — Internet Marketing Ninjas</p> 
<p><img class="aligncenter img-responsive" src="https://www.seoreviewtools.com/wp-content/uploads/ann-smarty-mention.png" alt="Ann Smarty Twitter" /></p> 
';  
 
// remove tabs and spaces 
$data = preg_replace('/\s+/S', " ", $data); 
 
// Encode data array to JSON 
$data = json_encode($data); 
 
// API key  
$apiKey = "YOUR API KEY"; 
 
 
$toolRequestUrl = "https://api.seoreviewtools.com/helpful-content-analysis/?content=1&key=".$apiKey; 
 
 
$seoDataJson = curlFunction($toolRequestUrl, $data); 
 
header("Content-type: application/json"); 
echo($seoDataJson);                                         
?>

Python code example

import requests
import json

def curl_function(tool_request_url, data):
    response = requests.post(tool_request_url, data=data)
    return response.text

# Content to check
data = '''
<h2>Check page headings, with the HTML Headings tool.</h2>
<p>Headings are used to structure the textual content of a web page and are an important on-page SEO factor. The most important heading is the H1 heading followed by the H2 and H3. There are six levels of headings available from H1 to H6.</p>
<p>The H1 heading should contain the main subject of a page. Use only one H1 on a web page.</p>
<blockquote>
<p><strong>TIP</strong>: now also available as <a class="btn btn-desult btn-bdr-black" href="https://api.seoreviewtools.com/documentation/content-apis/headings-api/">API end-point →</a></p>
</blockquote>
<img class="alignleft reviewed  size-thumbnail " src="https://www.seoreviewtools.com/wp-content/uploads/ann-smart.jpg" alt="Ann Smarty" /><img class="tlogo" src="https://www.seoreviewtools.com/wp-content/uploads/internet-marketing-ninjas.png" alt="internet marketing ninjas" />
<p>Ann Smarty featured this tool as part of her blog post: <a class="external" href="https://www.singlegrain.com/content-marketing-strategy-2/how-and-why-to-create-an-effective-content-structure-for-better-ranking/" target="_blank" rel="nofollow noopener noreferrer">How (and Why) to Create an Effective Content Structure for Better Ranking</a><br />“To quickly see your (or your competitor’s) on-page subheads, use this handy tool which extracts HTML headings from any web page. ...extract subheadings from any page and read through them to make sure they make sense even without the full context, flow well and provide a good outline of your on-page content.”</p>
<p><strong>Ann Smarty</strong> — Internet Marketing Ninjas</p>
<p><img class="aligncenter img-responsive" src="https://www.seoreviewtools.com/wp-content/uploads/ann-smarty-mention.png" alt="Ann Smarty Twitter" /></p>
'''

# Remove tabs and spaces
data = ' '.join(data.split())

# Encode data to JSON
data = json.dumps(data)

# API key
api_key = "YOUR API KEY"

tool_request_url = f"https://api.seoreviewtools.com/helpful-content-analysis/?content=1&key={api_key}"

seo_data_json = curl_function(tool_request_url, data)

print(seo_data_json)

JSON response example

{
    "status": "ok",
    "result": 1,
    "data": {
        "tool name": "helpful content analysis",
        "helpful content score": 58,
        "helpful content status": "Needs work",
        "available points": 160,
        "earned points": 92,
        "category score": {
            "content and quality": {
                "score": 55,
                "available points": 120,
                "earned points": 66
            },
            "expertise": {
                "score": 70,
                "available points": 20,
                "earned points": 14
            },
            "people-first content": {
                "score": 60,
                "available points": 20,
                "earned points": 12
            }
        },
        "data": {
            "content and quality": {
                "Does the content provide original information, reporting, research, or analysis?": {
                    "rating": "3",
                    "feedback": "The content does not present original research but compiles existing information in a useful way, focusing on HTML headings and their importance in SEO."
                },
                "Does the content provide a substantial, complete, or comprehensive description of the topic?": {
                    "rating": "6",
                    "feedback": "The content provides a useful overview of the importance of HTML headings for SEO, but lacks depth in technical explanation and examples."
                },
                "Does the content provide insightful analysis or interesting information that is beyond the obvious?": {
                    "rating": "4",
                    "feedback": "While it mentions the importance of headings, the text doesn't offer insightful analysis beyond common knowledge."
                },
                "If the content draws on other sources, does it avoid simply copying or rewriting those sources, and instead provide substantial additional value and originality?": {
                    "rating": "5",
                    "feedback": "The content references an API and a testimonial, but it's unclear how much unique value this adds beyond the sources."
                },
                "Does the main heading or page title provide a descriptive, helpful summary of the content?": {
                    "rating": "7",
                    "feedback": "The main heading serves as an adequate preview of the content's purpose, but it could be more concise and specific."
                },
                "Does the main heading or page title avoid exaggerating or being shocking in nature?": {
                    "rating": "8",
                    "feedback": "The main heading is straightforward and free from sensationalism, appropriately reflecting the content's nature."
                },
                "Is this the sort of page you'd want to bookmark, share with a friend, or recommend?": {
                    "rating": "5",
                    "feedback": "This page could be useful for someone new to SEO, but may not offer enough depth for more advanced users to bookmark or share."
                },
                "Would you expect to see this content in or referenced by a printed magazine, encyclopedia, or book?": {
                    "rating": "4",
                    "feedback": "The content might appear in a digital marketing newsletter or blog, but it lacks the rigor and depth typically expected in printed reference materials."
                },
                "Does the content provide substantial value when compared to other pages in search results?": {
                    "rating": "5",
                    "feedback": "The content is useful but not unique; similar explanations can be found across various SEO resources online."
                },
                "Does the content have any spelling or stylistic issues?": {
                    "rating": "9",
                    "feedback": "The content is well-written without noticeable spelling or grammatical errors."
                },
                "Is the content produced well, or does it appear sloppy or hastily produced?": {
                    "rating": "7",
                    "feedback": "The layout with testimonials and calls to action is thoughtful, though the overall content could benefit from more detailed explanation."
                },
                "Is the content mass-produced by or outsourced to a large number of creators, or spread across a large network of sites, so that individual pages or sites don't get as much attention or care?": {
                    "rating": "3",
                    "feedback": "The content feels somewhat generic, which could indicate a broader, less focused production strategy."
                }
            },
            "expertise": {
                "Is this content written or reviewed by an expert or enthusiast who demonstrably knows the topic well?": {
                    "rating": "6",
                    "feedback": "The inclusion of a testimonial from Ann Smarty, a recognized figure in internet marketing, adds credibility, yet the article itself lacks technical depth."
                },
                "Does the content have any easily-verified factual errors?": {
                    "rating": "8",
                    "feedback": "No factual inaccuracies are found; the basic information about HTML headings is correct."
                }
            },
            "people-first content": {
                "Is the content primarily made to attract visits from search engines?": {
                    "rating": "7",
                    "feedback": "The content is SEO-centric and aims to rank well for certain keywords but also tries to provide useful, navigable information for real users."
                },
                "Is the content mainly summarizing what others have to say without adding much value?": {
                    "rating": "5",
                    "feedback": "It mainly summarizes established SEO practices with little new insight or unique content added."
                }
            }
        }
    }
}

Ready to start testing the Helpful content analysis API- Content Input endpoint? Get your API Key →

Trusted by →