SEO Content Analysis API – Content Input – V 4.0

API endpoint → https://api.seoreviewtools.com/seo-content-analysis-4-0/

Price: 1 credits per request

Description: Discover how well a piece of (unpublished) content is optimized for search engines and get detailed SEO feedback to improve your content. Designed for content publishers and content creating environments (custom CMS, news sites or e-commerce platforms).

Query string parameters

Name	Parameter	Description
Keyword	&keyword=	The keyword or phrase is used by the the algorithm to analyse the provided content and calculates the SEO score using intelligent keyword recognition. (max phrase length = 6 words) example: SEO Tools
Related keywords	&relatedkeywords=	Optional: Add related keywords to analyse topic relevance (separated by the \| sign). A minimum of 3 related keywords is required example: content creation\|marketing strategy\|brand awareness\|content marketing strategy\|high quality content
Key	&key=	Your private API key

Name

Parameter

Description

Keyword

&keyword=

The keyword or phrase is used by the the algorithm to analyse the provided content and calculates the SEO score using intelligent keyword recognition. (max phrase length = 6 words)

example: SEO Tools

Related keywords

&relatedkeywords=

Optional: Add related keywords to analyse topic relevance (separated by the | sign). A minimum of 3 related keywords is required

example: content creation|marketing strategy|brand awareness|content marketing strategy|high quality content

Key

&key=

Your private API key

Post fields

Name	Description
data	The data post field is used to post the content as a string to the API. example HTML structure: ‘<html><head><title>…’ (see code example for more details)

Response elements

Name	Feedback elements	Description
SEO score	0	Overall SEO score Available SEO points Earned SEO points Summary including (Errors, Warnings, Optimized)
Title Tag	4	Title tag analysis includes: Title found Title tag text Title length Title tag number Focus keywords position Focus keywords found
Meta description	4	Meta description analysis includes: Title found Meta description text Meta description length Meta description number Focus keywords position Focus keywords found
Content length	1	Word count Corrected word count Anchor text words Anchor Percentage
Keyword usage	1	Focus keyword frequency Keyword density
Related keywords*	1	Optional: topic relevance analysis based on related keywords
Internal and external links	1	Total links External links Internal links Nofollow links Duplicate links Missing alt tag
Image analysis	3	Number of images Image name contains keyword Image ALT tag contains keyword
Headings	2	H1 count H1 content Count headings H1 – H6

*optional: depending on the request parameters

SEO Score interpretation

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

Score	Description
75% – 100%	The content is well optimized for search.
51% – 74%	The content needs work to improve its ranking potential
0% – 50%	The content is poorly optimized for the focus keyword

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 search
negative	Element is NOT optimized for search
couldhave	Element can be further optimized for search

More information: discover more about this API

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 = 

'<html>

    <head>

        <title>The Ultimate Guide to Content Marketing</title>

        <meta name="description" content="Discover how to create a successful content marketing strategy that will help you reach your audience and increase conversions">

    </head>

    <body>

        <h1>Content Marketing</h1>

        <p>Today, outbound marketing strategies (or anything that interrupts your audience members) aren’t as effective at resonating with and converting audience members as they once were. Content marketing is the process of planning, creating, distributing, sharing, and publishing content via channels such as social media, blogs, websites, podcasts, apps, press releases, print publications, and more. The goal is to reach your target audience and increase brand awareness, sales, engagement, and loyalty. </p>

    </body>

</html>'; 



// Keyword to check

$keywordInput = "Content marketing"; 



// Related keywords (optional)

$relatedKeywords = "Content creation|marketing strategy|brand awareness|content marketing strategy|high quality content|target audience|online pr|sharing content|content marketing definition|content marketing examples|content distribution|promoting content"; 



// API key 

$apiKey = "YOUR API KEY"; 



$toolRequestUrl = "https://api.seoreviewtools.com/seo-content-analysis-4-0/?content=1&keyword=".urlencode($keywordInput)."&relatedkeywords=".urlencode($relatedKeywords)."&key=".$apiKey;



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



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

echo($seoDataJson);                                        

?>

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

# Content to check
data = '''
<html>
    <head>
        <title>The Ultimate Guide to Content Marketing</title>
        <meta name="description" content="Discover how to create a successful content marketing strategy that will help you reach your audience and increase conversions">
    </head>
    <body>
        <h1>Content Marketing</h1>
        <p>Today, outbound marketing strategies (or anything that interrupts your audience members) are not as effective at resonating with and converting audience members as they once were. Content marketing is the process of planning, creating, distributing, sharing, and publishing content via channels such as social media, blogs, websites, podcasts, apps, press releases, print publications, and more. The goal is to reach your target audience and increase brand awareness, sales, engagement, and loyalty. </p>
    </body>
</html>
'''


# keyword
keyword = 'Content marketing'

# related keywords (optional)
relatedKeywords = 'Content creation|marketing strategy|brand awareness|content marketing strategy|high quality content|target audience|online pr|sharing content|content marketing definition|content marketing examples|content distribution|promoting content'

# API key
apiKey = 'YOUR API KEY'
toolRequestUrl = 'https://api.seoreviewtools.com/seo-content-analysis-4-0/?content=1&keyword='+keyword+'&relatedkeywords='+relatedKeywords+'&key='+apiKey

r = requests.post(url = toolRequestUrl, data = data)
print(r.text)

JSON response example

{
    "status": "ok",
    "data": {
        "Overview": {
            "Keyword": "content marketing",
            "Overall SEO score": 70,
            "Available SEO points": 385,
            "Earned SEO points": 270.5,
            "Summary": {
                "Errors": 5,
                "Warnings": 1,
                "Optimized": 11
            }
        },
        "Title tag": {
            "Result": 1,
            "Title found": "Found",
            "Title tag": "The Ultimate Guide to Content Marketing",
            "Title length": 39,
            "title tag number": 1,
            "Focus keywords position": 30,
            "Focus keywords found": 1,
            "Keyword": "content marketing",
            "Feedback details": {
                "Found": {
                    "text": "Your webpage has a Title tag",
                    "class": "positive"
                },
                "Length": {
                    "text": "Your Title tag is the perfect length",
                    "class": "positive"
                },
                "Focus keyword": {
                    "text": "Your Title tag targets your focus keyword: \"content marketing\"",
                    "class": "positive"
                },
                "Focus keywords position": {
                    "text": "You are using your focus keyword at the start of your Title tag",
                    "class": "positive"
                }
            },
            "Max SEO score available": 90,
            "SEO Score": 90
        },
        "Meta description": {
            "Result": 1,
            "Meta description found": "Found",
            "Meta description": "Discover how to create a successful content marketing strategy that will help you reach your audience and increase conversions",
            "Meta description length": 126,
            "meta description number": 1,
            "Focus keywords position": 44,
            "Focus keywords found": 1,
            "Keyword": "content marketing",
            "Feedback details": {
                "Found": {
                    "text": "Your webpage has a Meta description",
                    "class": "positive"
                },
                "Length": {
                    "text": "Your Meta description is the perfect length",
                    "class": "positive"
                },
                "Focus keyword": {
                    "text": "Your Meta description targets your focus keyword: \"content marketing\"",
                    "class": "positive"
                },
                "Focus keywords position": {
                    "text": "You are not using your focus keyword at the start of your Meta description tag",
                    "class": "negative"
                }
            },
            "Max SEO score available": 20,
            "SEO Score": 10.5
        },
        "Page Headings summary": {
            "H1": 1,
            "H2": 0,
            "H3": 0,
            "H4": 0,
            "H5": 0,
            "H6": 0,
            "H1 count": 1,
            "H1 Content": "Content Marketing",
            "Focus keywords found": 1,
            "Keyword": "content marketing",
            "Feedback details": {
                "Found": {
                    "text": "Your webpage has a H1 tag",
                    "class": "positive"
                },
                "Focus keyword": {
                    "text": "Great! Your webpage contains a H1 tag and targets your focus keyword",
                    "class": "positive"
                }
            },
            "Max SEO score available": 20,
            "SEO Score": 20
        },
        "Word count": {
            "Word count total": "72",
            "Corrected word count": "72",
            "Anchor text words": "0",
            "Anchor Percentage": "0",
            "Feedback details": {
                "Found": {
                    "text": "You should write more content for this page",
                    "class": "couldhave"
                }
            },
            "Max SEO score available": 50,
            "SEO Score": 5
        },
        "On page links summary": {
            "Total links": 0,
            "External links": 0,
            "Internal": 0,
            "Nofollow count": 0,
            "Duplicate links": 0,
            "No alt tag": 0,
            "Feedback details": {
                "Found": {
                    "text": "Your webpage contains less than 2 links",
                    "class": "negative"
                }
            },
            "Max SEO score available": 40,
            "SEO Score": 0
        },
        "Image analysis": {
            "Number of images": 0,
            "Image name contains keyword": 0,
            "Image ALT tag contains keyword": 0,
            "Keyword": "content marketing",
            "Feedback details": {
                "Found": {
                    "text": "Add an Image to your webpage",
                    "class": "negative"
                },
                "Image name contains keyword": {
                    "text": "You are not using your focus keyword: \"content marketing\" in your image Name",
                    "class": "negative"
                },
                "Image ALT tag contains keyword": {
                    "text": "You are not using your focus keyword: \"content marketing\" in your image ALT Tag",
                    "class": "negative"
                }
            },
            "Max SEO score available": 20,
            "SEO Score": 0
        },
        "Keyword density": {
            "Result": 1,
            "Keyword": "content marketing",
            "Keyword type": "Two word phrases",
            "Frequency": 2,
            "Keyword density": "2.78%",
            "Feedback details": {
                "Found": {
                    "text": "Great! You've used your focus keyword 2 times in the content of your page",
                    "class": "positive"
                }
            },
            "Max SEO score available": 90,
            "SEO Score": 90
        },
        "Related keywords": {
            "Related keywords": "Content creation, marketing strategy, brand awareness, content marketing strategy, high quality content, target audience, online pr, sharing content, content marketing definition, content marketing examples, content distribution, promoting content",
            "Related keywords found": "brand awareness, target audience, sharing content",
            "Related keywords not found": "Content creation, marketing strategy, content marketing strategy, high quality content, online pr, content marketing definition, content marketing examples, content distribution, promoting content",
            "Related keyword input": 12,
            "Intelligent match": 3,
            "Exact match": 2,
            "Feedback details": {
                "Found": {
                    "text": "Great! You've optimized the content of your page with 3 or more related keywords",
                    "class": "positive"
                }
            },
            "Max SEO score available": 55,
            "SEO Score": 55
        }
    }
}

Supported versions:

Ready to start testing the SEO Content Analysis API – Content Input – V 4.0 endpoint? Get your API Key →

Trusted by →