Helpful content analysis API- Content Input

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:

  1. Headings (H1 – H6)
  2. Paragraph tags
  3. Blockquotes
  4. Links
  5. Image tags
  6. List tags
  7. 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
expertise rating
people-first content rating



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 code example


    API documentation for SEO Review Tools.
    API info:
    API documentation:

function curlFunction ($toolRequestUrl$data){
$ch curl_init();
$html curl_exec($ch);
$curlInfo curl_getinfo($ch);

// Content to check
<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>
<p><strong>TIP</strong>: now also available as <a class="btn btn-desult btn-bdr-black" href="">API end-point →</a></p>
<img class="alignleft reviewed  size-thumbnail " src="" alt="Ann Smarty" /><img class="tlogo" src="" alt="internet marketing ninjas" />
<p>Ann Smarty featured this tool as part of her blog post: <a class="external" href="" 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="" 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 "".$apiKey;

$seoDataJson curlFunction($toolRequestUrl$data);

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

Python code example

import requests
import json

def curl_function(tool_request_url, data):
    response =, 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>
<p><strong>TIP</strong>: now also available as <a class="btn btn-desult btn-bdr-black" href="">API end-point →</a></p>
<img class="alignleft reviewed  size-thumbnail " src="" alt="Ann Smarty" /><img class="tlogo" src="" alt="internet marketing ninjas" />
<p>Ann Smarty featured this tool as part of her blog post: <a class="external" href="" 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="" 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"{api_key}"

seo_data_json = curl_function(tool_request_url, data)


JSON response example

Trusted by →