SEOptimer`s SEO Audit API

Run SEO Audits at Scale.
Integrate Reports into your Sales Workflows.

Signup Now

Who’s it for?

Digital Agencies

Web Designers and Developers

Bloggers and Researchers

What can I do with it?

Bulk Reporting - Want to audit a large number of prospects? Don’t have time to submit them one by one via the UI? Submit hundreds or even thousands of audits instantly via the API.

Integrate into your Sales Process and Systems - Want your Sales Staff to be able to run a report for prospects directly from within your CRM? Look no further than SEOptimer’s API.

Track for Problems or Changes - Run regular client reporting to keep track of improvements, or find potential issues early. Save regular copies and backups of reports to your Drive.

Prospecting for Particular Issues - Want to evaluate a range of prospects for a particular technical issue you specialise in? Or want to find prospects with the most pressing problems, and highest chance of converting to your services?

Trend Analysis & Research - Want to write the ultimate white paper on SSL Adoption? Audit a range of sites to see high level trends, build unique business insight and thought leadership.

Technical Features

Submit URLs via JSON - Commonly used and simple to implement API calling method.

Retrieve Data Points & Scores via JSON - Extract every reporting value into your database, or write custom logic and rules based on website values.

Retrieve Branded White Label PDFs - Customize the look and feel of your reports produced via the API. Set your own logo, company details, branding languages. Add custom text and choose which checks to run.

Custom Callback or Queue-And-Wait - Our API supports both options. SEOptimer can either call your endpoint on completion of a report, or you can poll on your provided Queue ID.

Available API Data Points

  • Title Tag
  • Meta Description Tag
  • Header Tags
  • Keyword Consistency
  • Amount of Content
  • Image Alt Attributes
  • Backlinks
  • Top Backlinks
  • On-Page Links
  • Broken Links
  • Friendly URLs
  • Noindex Tag Test
  • Noindex Header Test
  • Robots.txt
  • XML Sitemaps
  • Analytics
  • Structured Data
  • Top Keyword Rankings
  • Total Traffic From Search
  • Keyword Positions
  • Device Rendering
  • Use of Mobile Viewports
  • Flash used?
  • iFrames used?
  • Favicon
  • Legible Font Sizes
  • Tap Target Sizing
  • Page Speed
  • Page Size
  • Number of Objects Loaded
  • Google Accelerated Mobile Pages
  • Javascript Errors
  • GZIP Compression
  • Image Optimization
  • Minification
  • Deprecated HTML
  • Inline Styles
  • Facebook Page Connected
  • Facebook Open Graph Tags
  • Facebook Pixel
  • Twitter Connected
  • Twitter Cards
  • Twitter Activity
  • Instagram Connected
  • YouTube Connected
  • YouTube Activity
  • LinkedIn Connected
  • HTTPS redirect
  • Malware Check
  • SSL Security
  • Email Privacy
  • Technology List
  • Server IP Address
  • DNS Servers
  • Web server
  • Charset

Sample API Calls

Create Report (with PDF Option, No Callback)

curl --location --request POST "" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "x-api-key: XXXXXX" \
--data '{"url":"","pdf":1}'

{ "success":true, "data":{ "url": "", "pdf":true, "callback":false, "id":6 } }

Get Report

curl --location --request GET "" \
--header "Content-Type: application/json" \
--header "x-api-key: XXXXXX" \
--data ""

{ "success":true, "data":{ "id":2769, "input":{ "url":"", "pdf":true, "callback":false, "template":false }, "output":{ "success":true, "callback":false, "pdf":"", "recommendation_count":10, "screenshot":"", "report_generation_time":"48 second(s)", "request_completion_time":"1 minute(s) 4 second(s)", "scores":{ "overall":{ "grade":"A-", "title":"Your page is good", "description":"" }, "seo":{ "grade":"A", "title":"Your SEO is good", "description":"Your page is largely optimized for SEO performance. SEO optimization is important to ensure you can maximize ranking potential and drive traffic to your website from search engines. You can continue to build on your position by ensuring On and Off-Page factors highlighted here are improved, as well as through application of SEO strategies like content generation and link building." }, "performance":{ "grade":"C+", "title":"Your performance could be better", "description":"Your page's performance has some issues and room for improvement. Performance is important to ensure a good user experience, and reduced bounce rates (which can also indirectly affect your search engine rankings). We recommend addressing the highlighted factors below." }, "social":{ "grade":"D+", "title":"Your social could be better", "description":"You do not appear to have a strong social presence or level of social activity (or we may just not be able to see your profiles!). Social activity is important for customer communication, brand awareness and as a marketing channel to bring more visitors to your website. We recommend that you have all of your profiles listed on your page for visibility, and work to build a following on those networks." }, "ui":{ "grade":"A+", "title":"Your usability is very good!", "description":"Your page is highly usable across devices. Usability is important to maximize your available audience and minimize user bounce rates (which can indirectly affect your search engine rankings)." }, "security":{ "grade":"A+", "title":"Your security looks very good!", "description":"We haven't identified obvious security problems on your website. Security is important to ensure your website protects user data, doesn't become compromised or experience downtime or data loss. We recommend ongoing patching and the continuous use of protective monitoring tools." } }, "title":{ "section":"seo", "passed":true, "shortAnswer":"You have a title tag of optimal length (between 10 and 70 characters).", "recommendation":null, "value":"57", "data":"Easy Website Builder - Create a Website |" }, "description":{ "section":"seo", "passed":true, "shortAnswer":"Your page has a meta description of optimal length (between 70 and 320 characters).", "recommendation":null, "value":"154", "data":"Create your own website today with the best drag-and-drop website builder! Get fast hosting and all the tools you need to create a custom site in minutes." }, "headers":{ "section":"seo", "passed":true, "shortAnswer":"Your page is making good use of header tags.", "recommendation":null, "data":{ "h1":[ "Start Your Dreamby Creating a Website" ], "h2":[ "Your DreamStart Here.", "Unlimited PossibilitiesFor Your Dream", "Wish to Own Your Online Store?\nStart Selling Today.", "Stick With Your Dream\nWe'll Help You Grow.", "Start Your Dream With Our Website Builder.", "We've Got Your back 24/7", "Frequently AskedQuestions (FAQs)", "Create Your WebsiteIn Minutes" ], "h3":[ "Good for photographers", "Perfect for shopowners", "Designers will love this", "Let your creativity shine", "Great for startups", "See how easy it is to create a website", "Products", "Add-ons", "Company", "Support" ], "h4":[ "Web Hosting", "SSL Certificate", "SEO", "Cloud Backup", "Email Marketing", "VPN", "Choose a template", "Get a domain name", "Add Your Content", "Publish Your Site", "Market Your Site", "Do I need to know code to use the site builder?", "Can I cancel my plan?", "I already own a domain, can I use it with Yourwebsite?", "Are the website builder templates mobile-friendly?", "I use a different website builder, why should I use yours?", "Is the website maker easy to use?" ] } }, "keywords":{ "section":"seo", "passed":false, "shortAnswer":"Keyword Consistency Too Low", "recommendation":"Use your main keywords across the important HTML tags", "data":{ "keywords":[ { "word":"website", "count":15, "title":true, "description":true, "headers":true }, { "word":"create", "count":7, "title":true, "description":true, "headers":true }, { "word":"start", "count":7, "title":false, "description":false, "headers":true }, { "word":"online", "count":7, "title":false, "description":false, "headers":true }, { "word":"site", "count":6, "title":true, "description":true, "headers":true }, { "word":"dream", "count":6, "title":false, "description":false, "headers":true }, { "word":"marketing", "count":5, "title":false, "description":false, "headers":true }, { "word":"builder", "count":5, "title":true, "description":true, "headers":true } ], "phrases":[ { "word":"create your website", "count":4, "title":false, "description":false, "headers":true }, { "word":"website builder", "count":4, "title":true, "description":true, "headers":true }, { "word":"online store", "count":3, "title":false, "description":false, "headers":true }, { "word":"web hosting", "count":3, "title":false, "description":false, "headers":true }, { "word":"cloud backup", "count":3, "title":false, "description":false, "headers":true }, { "word":"email marketing", "count":3, "title":false, "description":false, "headers":true }, { "word":"features templates", "count":2, "title":false, "description":false, "headers":false }, { "name":"Yoast SEO", "icon":"/img/icons/app/Yoast SEO.png", "website":"", "version":"14.9" } ] } }, "contentLength":{ "section":"seo", "passed":false, "shortAnswer":"Page Text Content Too Short", "recommendation":"Increase Page text content", "value":"472" }, "imageAlt":{ "section":"seo", "passed":false, "shortAnswer":"Alt Attributes Missing From Images", "recommendation":"Add ALT attributes to all images", "data":{ "total":44, "altCount":43, "noAltCount":1 } }, "backlinks":{ "section":"seo", "passed":true, "shortAnswer":"You have a strong level of backlink activity to this page.", "recommendation":null, "data":{ "backlinks":2159498, "allbacklinks":2159498, "mozda":52, "referring_domains":24055 } }, "backlinksList":{ "section":"seo", "passed":null, "shortAnswer":"", "recommendation":null, "data":{ "list":[ { "domain_authority":98, "url":"", "title":"WordPress Jargon Glossary – Make Marketing", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"\n #40705 (Unable to login to admin backend from a wordpress login modal window)\n – WordPress Trac\n ", "anchor_text":"​" }, { "domain_authority":98, "url":"", "title":"Login page for wordpress site |", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"Redirect / www |", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"WARNING! Puts SPAM Ads in the plugin! |", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"The force SSL option link |", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"unexpected T_FUNCTION in keyring |", "anchor_text":"" }, { "domain_authority":98, "url":"", "title":"Any tips on using with WP All Import? - page 2 |", "anchor_text":"" } ] } }, "onPageLinks":{ "section":"seo", "passed":null, "shortAnswer":"", "recommendation":null, "data":{ "total":44, "filesCount":0, "externalCount":13, "nofollowCount":6, "externalPercentage":30, "nofollowPercentage":14 } }, "brokenLinks":{ "section":"seo", "passed":true, "shortAnswer":"We have not detected any broken links on your page.", "recommendation":null, "data":[ ] }, "friendlyUrls":{ "section":"seo", "passed":true, "shortAnswer":"Your page links appear friendly (easily human or search engine readable).", "recommendation":null }, "noindexTags":{ "section":"seo", "passed":true, "shortAnswer":"Your page is not using the Noindex Tag which prevents indexing.", "recommendation":null, "data":null }, "noindexHeaders":{ "section":"seo", "passed":true, "shortAnswer":"Your page is not using the Noindex Header which prevents indexing.", "recommendation":null, "data":null }, "robotsTxt":{ "section":"seo", "passed":true, "shortAnswer":"Your website appears to have a robots.txt file.", "recommendation":null, "data":"" }, "sitemap":{ "section":"seo", "passed":true, "shortAnswer":"Your website appears to have an XML sitemap.", "recommendation":null, "data":{ "found":1, "tested":1, "urls":[ "" ] } }, "analytics":{ "section":"seo", "passed":false, "shortAnswer":"Analytics Tracking Missing", "recommendation":"Implement an analytics tracking tool", "data":[ ] }, "schemaOrg":{ "section":"seo", "passed":true, "shortAnswer":"Your page is using structured data.", "recommendation":null, "data":"JSON-LD" }, "topKeywordRankings":{ "section":"rankings", "data":{ "keywords":[ { "keyword":"you web", "country":"BE", "language":"NL", "position":44, "total_searches":9140000, "estimated_traffic":19194 }, { "keyword":"your website", "country":"US", "language":"EN", "position":1, "total_searches":590, "estimated_traffic":179 }, { "keyword":"best web hosting -wordpress", "country":"US", "language":"EN", "position":8, "total_searches":5400, "estimated_traffic":104 }, { "keyword":"create a website", "country":"US", "language":"EN", "position":66, "total_searches":33100, "estimated_traffic":65 }, { "keyword":"create website", "country":"US", "language":"EN", "position":66, "total_searches":33100, "estimated_traffic":65 }, { "keyword":"website create", "country":"US", "language":"EN", "position":45, "total_searches":33100, "estimated_traffic":65 }, { "keyword":"ssl certificates", "country":"US", "language":"EN", "position":67, "total_searches":27100, "estimated_traffic":56 }, { "keyword":"website host", "country":"US", "language":"EN", "position":95, "total_searches":18100, "estimated_traffic":35 }, { "keyword":"whoisthis ip", "country":"IN", "language":"EN", "position":85, "total_searches":9900, "estimated_traffic":20 }, { "keyword":"my website", "country":"IN", "language":"EN", "position":12, "total_searches":1900, "estimated_traffic":14 } ] } }, "totalTrafficFromSearch":{ "section":"rankings", "data":{ "total":20426 } }, "keywordPositions":{ "section":"rankings", "data":{ "Position 1":4, "Position 2-3":0, "Position 4-10":18, "Position 11-20":86, "Position 21-30":143, "Position 31-100":1290 } }, "topKeywordRankings":{ "section":"rankings", "shortAnswer":"", "recommendation":null, "data":{ "keywords":[ { "keyword":"you web", "country":"BE", "language":"NL", "position":44, "total_searches":9140000, "estimated_traffic":19194 }, { "keyword":"your website", "country":"US", "language":"EN", "position":1, "total_searches":590, "estimated_traffic":179 }, { "keyword":"best web hosting -wordpress", "country":"US", "language":"EN", "position":8, "total_searches":5400, "estimated_traffic":104 }, { "keyword":"create a website", "country":"US", "language":"EN", "position":66, "total_searches":33100, "estimated_traffic":65 }, { "keyword":"create website", "country":"US", "language":"EN", "position":66, "total_searches":33100, "estimated_traffic":65 }, { "keyword":"website create", "country":"US", "language":"EN", "position":45, "total_searches":33100, "estimated_traffic":65 }, { "keyword":"ssl certificates", "country":"US", "language":"EN", "position":67, "total_searches":27100, "estimated_traffic":56 }, { "keyword":"website host", "country":"US", "language":"EN", "position":95, "total_searches":18100, "estimated_traffic":35 }, { "keyword":"whoisthis ip", "country":"IN", "language":"EN", "position":85, "total_searches":9900, "estimated_traffic":20 }, { "keyword":"my website", "country":"IN", "language":"EN", "position":12, "total_searches":1900, "estimated_traffic":14 } ] } }, "totalTrafficFromSearch":{ "section":"rankings", "shortAnswer":"", "recommendation":null, "data":{ "total":20426 } }, "keywordPositions":{ "section":"rankings", "shortAnswer":"", "recommendation":null, "data":{ "Position 1":4, "Position 2-3":0, "Position 4-10":18, "Position 11-20":86, "Position 21-30":143, "Position 31-100":1290 } }, "deviceRendering":{ "section":"ui", "passed":null, "shortAnswer":"This check visually demonstrates how your page renders on different devices. It is important that your page is optimized for mobile and tablet experiences as today the majority of web traffic comes from these sources.", "recommendation":null, "data":{ "mobile":"", "tablet":"" } }, "mobileViewport":{ "section":"ui", "passed":true, "shortAnswer":"Your page specifies a viewport matching the device's size, allowing it to render appropriately across devices.", "recommendation":null }, "flash":{ "section":"ui", "passed":true, "shortAnswer":"No Flash content has been identified on your page.", "recommendation":null }, "iframe":{ "section":"ui", "passed":true, "shortAnswer":"There are no iFrames detected on your page.", "recommendation":null }, "favicon":{ "section":"ui", "passed":true, "shortAnswer":"Your page has specified a favicon.", "recommendation":null }, "legibleFonts":{ "section":"ui", "passed":true, "shortAnswer":"The text on your page appears to be legible across devices.", "recommendation":null }, "tapTargetSizing":{ "section":"ui", "passed":true, "shortAnswer":"The links and buttons on your page appear to be appropriately sized for a user to easily tap on a touchscreen.", "recommendation":null }, "serverResponseTime":{ "section":"performance", "passed":true, "shortAnswer":"Your page's server response time is reasonably low which is good for load speed and user experience.", "recommendation":null, "data":{ "responseTime":348, "loadTime":3429, "completeTime":9243 } }, "pageSize":{ "section":"performance", "passed":false, "shortAnswer":"Your page's file size is quite large which, regardless of other optimizations, can reduce load speed and impact user experience. A general rule is to keep your page under 5MB in total file size.", "recommendation":"Reduce your total page file size", "data":{ "totalSize":5805838, "htmlSize":392492, "cssSize":2106279, "jsSize":1338434, "imageSize":1271981, "otherSize":696652 } }, "numberOfResources":{ "section":"performance", "passed":null, "shortAnswer":"This check displays the total number of files that need to be retrieved from web servers to load your page. As a general rule, having more files to retrieve increases the number of server requests and can subsequently increase page load time. It is a good idea to removing unnecessary files or consolidate files like styles and scripts where possible.", "recommendation":null, "data":{ "total":29, "images":10, "css":2, "js":3, "html":7, "other":7 } }, "hasAmp":{ "section":"performance", "passed":null, "shortAnswer":"This page does not appear to have AMP Enabled.", "recommendation":null, "data":{ "isAmpOpenTag":false, "isAmpScriptTag":false, "hasAmpBoilerplate":false, "hasAmpCustomStyles":false, "hasAmpImgTag":false, "hasCanonicalLink":true } }, "javascriptErrors":{ "section":"performance", "passed":true, "shortAnswer":"Your page is not reporting any JavaScript errors.", "recommendation":null }, "gzip":{ "section":"performance", "passed":true, "shortAnswer":"Your website is using GZIP compression.", "recommendation":null, "data":[ ] }, "optimizedImages":{ "section":"performance", "passed":true, "shortAnswer":"All of the images on your page appear to be optimized.", "recommendation":null }, "minified":{ "section":"performance", "passed":true, "shortAnswer":"All your JavaScript and CSS files appear to be minified.", "recommendation":null }, "deprecated":{ "section":"performance", "passed":true, "shortAnswer":"No deprecated HTML tags have been found within your page.", "recommendation":null }, "inlineCss":{ "section":"performance", "passed":false, "shortAnswer":"Inline Styles Found", "recommendation":"Remove inline styles" }, "facebookLink":{ "section":"social", "passed":true, "shortAnswer":"Your page has a link to a Facebook Page.", "recommendation":null }, "facebookPixel":{ "section":"social", "passed":false, "shortAnswer":"No Facebook Pixel", "recommendation":"Setup & Install a Facebook Pixel", "data":[ ] }, "twitterLink":{ "section":"social", "passed":false, "shortAnswer":"Twitter Page Link Not Found", "recommendation":"Create and link your Twitter profile" }, "twitterTags":{ "section":"social", "passed":true, "shortAnswer":"Your page is using Twitter Cards.", "recommendation":null, "data":{ "twitter:card":"summary_large_image", "twitter:title":"Create your own website in minutes", "twitter:description":"Use a powerful website builder on to create fabulous professional and responsive internet sites. You can easily customise, build and design your website in a matter of minutes.", "twitter:image":"" } }, "twitterActivity":false, "instagramLink":{ "section":"social", "passed":false, "shortAnswer":"Instagram Profile Link Not Found", "recommendation":"Create and link associated Instagram profile" }, "youtubeLink":{ "section":"social", "passed":true, "shortAnswer":"Your page has a link to a YouTube channel.", "recommendation":null }, "youtubeActivity":{ "section":"social", "passed":false, "shortAnswer":"YouTube Subscriber Activity Low", "recommendation":"Increase your YouTube channel subscribers", "data":{ "subscribers":12, "views":601 } }, "linkedInLink":{ "section":"social", "passed":true, "shortAnswer":"Your page has a link to a LinkedIn profile.", "recommendation":null, "data":null }, "openGraphTags":{ "section":"social", "passed":true, "shortAnswer":"Your page is using Facebook Open Graph Tags.", "recommendation":null, "data":{ "og:locale":"en_US", "og:type":"website", "og:title":"Make your own website in minutes", "og:description":"Use a powerful website builder on to create fabulous professional and responsive internet sites. You can easily customise, build and design your website in a matter of minutes.", "og:url":"", "og:site_name":"", "og:image":"", "og:image:width":"1238", "og:image:height":"1030" } }, "sslEnabled":{ "section":"security", "passed":true, "shortAnswer":"Your website has SSL enabled.", "recommendation":null }, "httpsRedirect":{ "section":"security", "passed":true, "shortAnswer":"Your page successfully redirects to a HTTPS (SSL secure) version.", "recommendation":null }, "malware":{ "section":"security", "passed":null, "shortAnswer":null, "recommendation":null, "data":null }, "email":{ "section":"security", "passed":true, "shortAnswer":"No email addresses have been found in plain text on your page.", "recommendation":null }, "technologies":{ "section":"technology", "passed":null, "shortAnswer":"These software or coding libraries have been identified on your page.", "recommendation":null, "data":[ "CloudFlare", "Elementor", "Google Font API", "Google Tag Manager", "MySQL", "PHP", "WordPress", "WP Rocket", "Yoast SEO" ] }, "ip":{ "section":"technology", "passed":null, "shortAnswer":"", "recommendation":null, "data":"" }, "dns":{ "section":"technology", "passed":null, "shortAnswer":"", "recommendation":null, "data":"
" }, "webServer":{ "section":"technology", "passed":null, "shortAnswer":"", "recommendation":null, "data":"cloudflare" }, "charset":{ "section":"technology", "passed":null, "shortAnswer":"", "recommendation":null, "data":"text/html" }, "recommendations":[ { "priority":"medium", "section":"performance", "recommendation":"Reduce your total page file size" }, { "priority":"low", "section":"seo", "recommendation":"Use your main keywords across the important HTML tags" }, { "priority":"low", "section":"social", "recommendation":"Increase your YouTube channel subscribers" }, { "priority":"low", "section":"seo", "recommendation":"Implement an analytics tracking tool" }, { "priority":"low", "section":"seo", "recommendation":"Add ALT attributes to all images" }, { "priority":"low", "section":"seo", "recommendation":"Increase Page text content" }, { "priority":"low", "section":"social", "recommendation":"Setup & Install a Facebook Pixel" }, { "priority":"low", "section":"performance", "recommendation":"Remove inline styles" }, { "priority":"low", "section":"social", "recommendation":"Create and link your Twitter profile" }, { "priority":"low", "section":"social", "recommendation":"Create and link associated Instagram profile" } ] }, "created_at":"2020-09-15 07:53:31", "completed_at":"2020-09-15 07:54:35" } }

How Do I Get Started?

For new SEOptimer customers, signup to one of the API plans below. Once in your Dashboard, you’ll have access to an ‘API’ Panel which displays your API usage and API Key.

For existing customers, reach out via Livechat to get one of the API Plans added to your account.

Have questions, interested in a bespoke plan, higher limits or special needs? Reach out via Live Chat below.

API Plans

Features API-1 API-2 API-3 Custom
Price $100 a Month $250 a Month $500 a Month Custom Pricing
Reports per Month 200 1000 5000 Custom Limit
Submit URLs via JSON
Retrieve Data Points via JSON
Retrieve Scores via JSON
Retrieve White Label PDFs
Add Report Custom Branding and Colors


Shoot us a message on Live Chat and we’ll get back to you as soon as possible.