SEO audit tool: how to get on-page SEO data as JSON/CSV (API, Python, no code)

Q: How do I use the SEO audit tool from Python?

Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/seo-audit with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.

Q: How do I limit the number of results?

Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.

Audit the on-page SEO of any public web pages: title, meta description, headings, canonical, indexability, structured data types, image alt text, link counts and social tags, with a list of issues and a 0 to 100 score per page. This guide shows the output fields, a working input, and Python, JavaScript and cURL code for the Actor v0iddo/seo-audit on Apify.

Open SEO audit tool on Apify

What data you get

One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.

Field	Label	Type	Example
`url`	Page	URL	https://www.python.org/
`statusCode`	Status	number	200
`score`	Score	number	86
`indexable`	Indexable	true/false	true
`title`	Title	text	Welcome to Python.org
`titleLength`	Title length	number	21
`metaDescriptionLength`	Description length	number	52
`h1Count`	H1 headings	number	5
`wordCount`	Words	number	955
`imagesMissingAlt`	Images without alt	number	0
`internalLinks`	Internal links	number	64
`externalLinks`	External links	number	64
`canonicalIsSelf`	Canonical is this page	true/false
`issues`	Issues	list	[{"code": "canonical_missing", "severity": "warning", "message": "T...
`finalUrl`		text	https://www.python.org/
`redirected`		true/false	false
`https`		true/false	true
`contentType`		text	text/html
`pageSizeBytes`		number	52794
`metaDescription`		text	The official home of the Python Programming Language
`h1`		text	Functions Defined
`h2Count`		number	9
`lang`		text	en
`hreflangCount`		number	0
`imagesCount`		number	1
`nofollowLinks`		number	0
`structuredDataTypes`		list	["WebSite"]
`openGraph`		object	{"title": true, "description": true, "image": true}
`hasViewport`		true/false	true
`robotsTxtFound`		true/false	true
`sitemapListed`		true/false	false

Input example

This is the input that is pre-filled on the Actor page. Change the values for your own run.

{
  "startUrls": [
    "https://www.python.org/",
    "https://docs.python.org/3/",
    "https://www.joelonsoftware.com/"
  ],
  "maxPagesPerSite": 5,
  "maxItems": 20
}

Input field	Type	What it does
`startUrls` (required)	array	Web pages to audit, one address per line, for example https://example.com/pricing.
`maxPagesPerSite`	integer	1 audits only the pages you list.
`maxItems`	integer	The run stops after this many result rows.

Output sample

Real rows from a run of the Actor. Fields that name people are left out of the sample.

[
  {
    "url": "https://www.python.org/",
    "finalUrl": "https://www.python.org/",
    "statusCode": 200,
    "redirected": false,
    "https": true,
    "contentType": "text/html",
    "pageSizeBytes": 52794,
    "score": 86,
    "indexable": true,
    "title": "Welcome to Python.org",
    "titleLength": 21,
    "metaDescription": "The official home of the Python Programming Language",
    "metaDescriptionLength": 52,
    "h1": "Functions Defined",
    "h1Count": 5,
    "h2Count": 9,
    "wordCount": 955,
    "lang": "en",
    "hreflangCount": 0,
    "imagesCount": 1,
    "imagesMissingAlt": 0,
    "internalLinks": 64,
    "externalLinks": 64,
    "nofollowLinks": 0,
    "structuredDataTypes": [
      "WebSite"
    ],
    "openGraph": {
      "title": true,
      "description": true,
      "image": true
    },
    "hasViewport": true,
    "robotsTxtFound": true,
    "sitemapListed": false,
    "issues": [
      {
        "code": "canonical_missing",
        "severity": "warning",
        "message": "The page has no canonical link."
      },
      {
        "code": "title_too_short",
        "severity": "notice",
        "message": "The title is only 21 characters. Titles of 30 to 60 characters usually work best."
      },
      {
        "code": "meta_description_too_short",
        "severity": "notice",
        "message": "The meta description is only 52 characters. 70 to 160 characters usually work best."
      }
    ]
  },
  {
    "url": "https://www.python.org/psf/",
    "finalUrl": "https://www.python.org/psf-landing/",
    "statusCode": 200,
    "redirected": true,
    "https": true,
    "contentType": "text/html",
    "pageSizeBytes": 50764,
    "score": 82,
    "indexable": true,
    "title": "Python Software Foundation",
    "titleLength": 26,
    "metaDescription": "The official home of the Python Programming Language",
    "metaDescriptionLength": 52,
    "h1": "The Python Software Foundation is the charitable organization behind the Python programming language.",
    "h1Count": 5,
    "h2Count": 6,
    "wordCount": 633,
    "lang": "en",
    "hreflangCount": 0,
    "imagesCount": 1,
    "imagesMissingAlt": 0,
    "internalLinks": 84,
    "externalLinks": 37,
    "nofollowLinks": 0,
    "structuredDataTypes": [
      "WebSite"
    ],
    "openGraph": {
      "title": true,
      "description": true,
      "image": true
    },
    "hasViewport": true,
    "robotsTxtFound": true,
    "sitemapListed": false,
    "foundOn": "https://www.python.org/",
    "issues": [
      {
        "code": "canonical_missing",
        "severity": "warning",
        "message": "The page has no canonical link."
      },
      {
        "code": "title_too_short",
        "severity": "notice",
        "message": "The title is only 26 characters. Titles of 30 to 60 characters usually work best."
      },
      {
        "code": "meta_description_too_short",
        "severity": "notice",
        "message": "The meta description is only 52 characters. 70 to 160 characters usually work best."
      }
    ]
  }
]

Code: Python, JavaScript and cURL

Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/seo-audit.

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {'startUrls': ['https://www.python.org/',
               'https://docs.python.org/3/',
               'https://www.joelonsoftware.com/'],
 'maxPagesPerSite': 5,
 'maxItems': 20}

run = client.actor("v0iddo/seo-audit").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript (apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const input = {
  "startUrls": [
    "https://www.python.org/",
    "https://docs.python.org/3/",
    "https://www.joelonsoftware.com/"
  ],
  "maxPagesPerSite": 5,
  "maxItems": 20
};

const run = await client.actor('v0iddo/seo-audit').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

cURL

curl -X POST "https://api.apify.com/v2/acts/v0iddo~seo-audit/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://www.python.org/", "https://docs.python.org/3/", "https://www.joelonsoftware.com/"], "maxPagesPerSite": 5, "maxItems": 20}'

Price

$4.00 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $2.80 per 1,000. See the pricing tab for your plan. A new Apify account gets $5 of platform credit every month.

Good to know

One row per audited page. At most 500 listed addresses, at most 200 pages per site and 5000 pages per run. With Pages per site at 1 only the pages you list are read.
The page is read as a visitor without JavaScript sees it, so a page that builds its title or links in the browser shows what the server sends. The run does not read sitemaps, images or other sites.
The score starts at 100 and loses 20 points per error, 8 per warning and 2 per notice, down to 0. A page that answers with an HTTP error or an empty page scores 0, and a page that is not HTML (a...
Duplicate title and duplicate description checks compare a page with the pages of the same site audited earlier in the run, so the later page of a pair carries the finding and names the first.

FAQ

What data does the SEO audit tool return?

Each result is one row in an Apify dataset. Fields include url, statusCode, score, indexable, title, titleLength, metaDescriptionLength, h1Count, and more. The table above shows every field with an example value.

How do I use the SEO audit tool from Python?

Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/seo-audit with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.

Can I use it without writing code?

Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.

How much does it cost?

$4.00 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $2.80 per 1,000. A new Apify account gets $5 of platform credit every month.

How do I limit the number of results?

Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.

Can I send the results to Google Sheets, Make, Zapier or n8n?

Yes. Apify datasets connect to Google Sheets, Slack, Make, Zapier and n8n, and a webhook can call your own service when a run finishes. You can also export the dataset as JSON, CSV or Excel.

Open SEO audit tool on Apify

Related guides

Similarweb Scraper: Scrape Similarweb top websites rankings by category: global rank, domain, category, rank change, average vi...
Sitemap URL extractor: Sitemap URL extractor and sitemap index crawler.
Pracuj.pl Scraper: Scrape Polish job postings from pracuj.pl: title, company, workplaces and address, salary per contract type...