SEO Content Analysis API – URL

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

Example API call → https://api.seoreviewtools.com/seo-content-analysis-4-1/?keyword=content marketing&url=https://blog.hubspot.com/marketing/content-marketing&relatedkeywords=Content creation|Marketing strategy|Online PR&key=API-KEY

Price: 1 credits per request

Description: Discover how well a web page is optimized for search engines and get detailed SEO feedback to improve your content.

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
URL	&url=	The public URL you want to analyse example: https://example.com/url/
Key	&key=	Your private API key

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, including: Title found, Title tag text, Title length, Title tag number, Focus keywords position, Focus keywords found
Meta description	4	Meta description analysis, including: Title found, Meta description text, Meta description length, Meta description number, Focus keywords position, Focus keywords found
URL	2	Status code, Readability URL, Focus keywords, Input type, Feedback details
Content length	1	Word count, Corrected word count, Anchor text words, Anchor Percentage
Keyword usage	1	Focus keyword frequency and 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 count, 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

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

*/



// input URL

$inputUrl = 'https://blog.hubspot.com/marketing/content-marketing';



// API key 

$apiKey = 'YOUR-API-KEY';



// 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"; 



// specific API url 

$apiRequestUrl = 'https://api.seoreviewtools.com/seo-content-analysis-4-1/?keyword='.urlencode($keyword).'&relatedkeywords='.urlencode($relatedKeywords).' &url='.$inputUrl.'&key='.$apiKey;



// get data from API

$jsonReposnse = file_get_contents($apiRequestUrl);



// convert JSON to PHP array

$dataArray = json_decode($jsonReposnse, true);



// check if API call is success or failed

// (just some basic validation)



// API call fail

if ($dataArray['status'] !== 'ok'){



    // return error message

    echo 'Error message: '.$dataArray['error message'];



// API call success    

} else {



    // print data

    print_r($dataArray); 

}



?>

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

# API key
apiKey = 'YOUR-API-KEY'

# 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'

# input URL
inputUrl = 'https://blog.hubspot.com/marketing/content-marketing'

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

r = requests.request("GET", toolRequestUrl,)
print(r.text)

JSON response example

{
    "status": "ok",
    "data": {
        "Overview": {
            "Keyword": "content marketing",
            "URL": "https:\/\/blog.hubspot.com\/marketing\/content-marketing",
            "Overall SEO score": 87,
            "Available SEO points": 395,
            "Earned SEO points": 342.75,
            "Summary": {
                "Errors": 2,
                "Warnings": 0,
                "Optimized": 17
            }
        },
        "Input": {
            "URL": "https:\/\/blog.hubspot.com\/marketing\/content-marketing",
            "Status code": 200,
            "Readability URL": "High",
            "Focus keywords found": 1,
            "Keyword": "content marketing",
            "Input type": "URL",
            "Feedback details": {
                "Status code": {
                    "text": "This page returns the right status code ",
                    "class": "positive"
                },
                "Focus keyword": {
                    "text": "Great! Your input URL is easy to read, returns the right status code and targets your focus keyword ",
                    "class": "positive"
                }
            },
            "Max SEO score available": 10,
            "SEO Score": 10
        },
        "Title tag": {
            "Result": 1,
            "Title found": "Found",
            "Input URL": "https:\/\/blog.hubspot.com\/marketing\/content-marketing",
            "Title tag": "The Ultimate Guide to Content Marketing in 2024 ",
            "Title length": 48,
            "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 not using your focus keyword at the start of your Title tag",
                    "class": "negative"
                }
            },
            "Max SEO score available": 90,
            "SEO Score": 47.25
        },
        "Meta description": {
            "Result": 1,
            "Meta description found": "Found",
            "Input URL": "https:\/\/blog.hubspot.com\/marketing\/content-marketing",
            "Meta description": "Whether you\u2019re devising or refreshing your content marketing strategy, this guide will help you find ways to create and share content with your audience.",
            "Meta description length": 155,
            "meta description number": 1,
            "Focus keywords position": 53,
            "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": 27,
            "H3": 62,
            "H4": 63,
            "H5": 0,
            "H6": 7,
            "H1 count": 1,
            "H1 Content": "The Ultimate Guide to Content Marketing in 2024",
            "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": {
            "Input URL": "https:\/\/blog.hubspot.com\/marketing\/content-marketing",
            "Word count total": 7189,
            "Corrected word count": 6078,
            "Anchor text words": 1111,
            "Anchor Percentage": 15,
            "Feedback details": {
                "Found": {
                    "text": "Great! Your webpage contains enough words to perform well in search engines",
                    "class": "positive"
                }
            },
            "Max SEO score available": 50,
            "SEO Score": 50
        },
        "On page links summary": {
            "Total links": 297,
            "External links": 97,
            "Internal": 200,
            "Nofollow count": 0,
            "Duplicate links": 54,
            "No alt tag": 1,
            "Feedback details": {
                "Found": {
                    "text": "Great! Your webpage doesn't contain too many links",
                    "class": "positive"
                }
            },
            "Max SEO score available": 40,
            "SEO Score": 40
        },
        "Image analysis": {
            "Number of images": 75,
            "Image name contains keyword": 1,
            "Image ALT tag contains keyword": 1,
            "Keyword": "content marketing",
            "Feedback details": {
                "Found": {
                    "text": "Your webpage has an Image",
                    "class": "positive"
                },
                "Image name contains keyword": {
                    "text": "Image name contains your focus keyword: \"content marketing\"",
                    "class": "positive"
                },
                "Image ALT tag contains keyword": {
                    "text": "Image ALT tag contains your focus keyword: \"content marketing\"",
                    "class": "positive"
                }
            },
            "Max SEO score available": 20,
            "SEO Score": 20
        },
        "Keyword density": {
            "Result": 1,
            "Keyword": "content marketing",
            "Keyword type": "Two word phrases",
            "Frequency": 124,
            "Keyword density": 1.6402116402,
            "Feedback details": {
                "Found": {
                    "text": "Great! You've used your focus keyword 124 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, Online PR",
            "Related keywords found": "Content creation, Marketing strategy, Online PR",
            "Related keywords not found": "",
            "Related keyword input": 3,
            "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
        }
    }
}

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

Trusted by →