# SEO Audit API - Broken Links, Meta Tags & Site Crawler (`sndzcc/seo-audit`) Actor

Crawl any website and audit every page: SEO score, issues to fix, broken links, redirects, titles, meta descriptions, headings, images without alt, structured data, sitemap and robots.txt.

- **URL**: https://apify.com/sndzcc/seo-audit.md
- **Developed by:** [Sndz Data](https://apify.com/sndzcc) (community)
- **Categories:** SEO tools, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 page auditeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEO Audit API: Broken Links, Meta Tags & Site Crawler

Give it a website and it **crawls its pages** (following internal links and the sitemap) and audits each one: an **SEO score from 0 to 100**, a clear **list of issues**, **broken links**, redirects, titles, meta descriptions, headings, canonical, images without alt text, Open Graph, structured data, word count and response time. Plus a **site summary** with the top issues, robots.txt, sitemap and HTTPS redirect.

No browser extension, no subscription: pay per page audited.

### Why this one?

- **Clear to-do list.** Every page comes with its issues ranked as error, warning or notice, worst pages first.
- **Real broken links only.** Internal and external links are tested; links that only block bots (LinkedIn, some social sites) aren't reported as broken.
- **Duplicates across the site.** Duplicate titles and meta descriptions are flagged.
- **Many sites in one run.** Audit your clients' or competitors' websites in bulk.
- **Polite crawler.** Respects robots.txt by default and identifies itself.

### What it checks

| Area | Checks |
|---|---|
| **Status** | HTTP status, redirects and redirect chains, response time, HTML size |
| **Meta tags** | Title (missing, too long, too short, duplicate), meta description (missing, length, duplicate), meta robots / noindex, canonical |
| **Content** | H1 (missing, multiple), H2 count, word count (thin content), language attribute |
| **Links** | Broken links (404, 410, 5xx, dead domains), internal / external / nofollow counts |
| **Images** | Images without alt text, with their URLs |
| **Mobile and social** | Viewport tag, Open Graph title and image, Twitter card |
| **Technical** | Structured data (JSON-LD types), hreflang, mixed content, robots.txt, sitemap, HTTP to HTTPS redirect |

### Input

| Field | What it does |
|---|---|
| **Websites** | Websites or start pages, one per line. |
| **Max pages per website** | How many pages to audit on each site (default 30). |
| **Check broken links** | Test every link found. On by default. |
| **Max links to check per website** | Cap for links that aren't crawled as pages (external ones, files). |
| **Respect robots.txt** | Skip pages disallowed by robots.txt. On by default. |

```json
{
  "startUrls": ["https://www.example.com", "competitor.com"],
  "maxPagesPerSite": 100,
  "checkLinks": true
}
```

### Output

One row per page, worst score first:

```json
{
  "url": "https://www.example.com/pricing",
  "statusCode": 200,
  "finalUrl": "https://www.example.com/pricing",
  "redirects": [],
  "loadTimeMs": 420,
  "sizeKb": 88.4,
  "score": 72,
  "issues": [
    {"severity": "error", "issue": "1 broken link(s)"},
    {"severity": "warning", "issue": "Missing meta description"},
    {"severity": "notice", "issue": "Missing canonical tag"}
  ],
  "title": "Pricing",
  "titleLength": 7,
  "metaDescription": null,
  "h1": ["Simple pricing"],
  "h1Count": 1,
  "canonical": null,
  "noindex": false,
  "language": "en",
  "wordCount": 640,
  "imagesWithoutAlt": 2,
  "brokenLinks": [{"url": "https://www.example.com/old-plan", "status": 404}],
  "structuredData": ["Organization", "Product"],
  "internalLinkCount": 42,
  "externalLinkCount": 6,
  "site": "https://www.example.com"
}
```

The **Site summary** (the `SUMMARY` record, free) has the average score, pages with errors, total broken links, the 15 most frequent issues, robots.txt, sitemaps and whether HTTP redirects to HTTPS.

### Good to know

- Pages are read as HTML, without running JavaScript. Sites built entirely in JavaScript may show fewer links and content.
- Sites with strong bot protection may block the crawler; those pages show their status code.
- The score starts at 100 and drops 15 points per error, 5 per warning and 1 per notice.

### Integrations

Schedule a monthly audit and send it to Google Sheets, Looker Studio, Slack or your client reports with Apify integrations, Zapier, Make or n8n.

### How to use it

1. Click **Try for free** (or **Start**) at the top of this page.
2. Fill in the input, or keep the example to see it working in seconds.
3. Click **Start** and wait for the run to finish.
4. Download the results as **Excel, CSV, JSON or HTML**, or get them through the Apify API.

### How much does it cost?

**$0.002 per page audited** ($2.00 per 1,000). No start fee, no monthly fee, and you only pay for the results saved to your dataset.

| Example | Cost |
|---|---|
| Audit a 100-page website | about $0.20 |
| Monthly audit of 10 client sites (500 pages each) | about $10.00 |

Apify's free plan includes monthly credit, so you can try it for free.

### FAQ

**What does the SEO audit check?**

Status and redirects, titles, meta descriptions, headings, canonical, noindex, broken links, images without alt, Open Graph, structured data, mixed content, speed, robots.txt and sitemap.

**Is it a broken link checker too?**

Yes. It tests internal and external links and lists the broken ones on each page, ignoring links that only block bots.

**How is the score calculated?**

Each page starts at 100 and loses 15 points per error, 5 per warning and 1 per notice.

**Can I audit competitors or many client sites?**

Yes. Add as many websites as you want; each gets its own pages and summary.

### More tools from Sndz Data

- [BORME Scraper API - Spain New Company Leads Daily](https://apify.com/sndzcc/borme-spain-companies): every new company registered in Spain, daily
- [App Store & Google Play Reviews Scraper API](https://apify.com/sndzcc/app-reviews-scraper): App Store and Google Play reviews in one run
- [Job Scraper API - Greenhouse, Lever, Ashby & Workable](https://apify.com/sndzcc/ats-jobs-scraper): all open jobs from Greenhouse, Lever, Ashby and more
- [Google News Scraper API - Articles with Real URLs](https://apify.com/sndzcc/google-news-scraper): news by keyword or topic, with real article URLs
- [Email & Contact Scraper API - Emails, Phones & Socials](https://apify.com/sndzcc/contact-details-scraper): emails, phones and social profiles from any website
- [Telegram Scraper API - Channel Posts, Views & Media](https://apify.com/sndzcc/telegram-channel-scraper): posts, views and media from public Telegram channels
- [Brand Monitoring API - Mentions Radar for News & Reddit](https://apify.com/sndzcc/brand-mentions-radar): brand mentions across 9 sources, with sentiment
- [AI Image Upscaler API - Upscale & Enhance Photos 4x](https://apify.com/sndzcc/ai-image-upscaler): upscale and enhance photos 4x with AI
- [Keyword Research API - Google, YouTube & Amazon Ideas](https://apify.com/sndzcc/keyword-ideas-machine): hundreds of keyword ideas from 5 search engines
- [Tech Stack Detector API - Wappalyzer & BuiltWith Alternative](https://apify.com/sndzcc/tech-stack-detector): the technologies behind any website, in bulk
- [Polymarket & Kalshi API - Prediction Market Odds](https://apify.com/sndzcc/prediction-markets-scraper): live odds from Polymarket and Kalshi in one dataset
- [WHOIS & Domain Lookup API - DNS, SSL & Availability](https://apify.com/sndzcc/domain-intel): WHOIS, availability, DNS and SSL for any list of domains
- [Bluesky Scraper API - Posts, Profiles & Followers](https://apify.com/sndzcc/bluesky-scraper): posts, profiles and followers from Bluesky, no login
- [OCR API - Image & PDF to Text Extractor, 100+ Languages](https://apify.com/sndzcc/image-pdf-to-text): text from images and scanned PDFs, 100+ languages

### Support

Missing a check? Open an issue on the **Issues** tab and it will be added.

If this Actor saves you time, a quick ⭐ review helps a lot and keeps it maintained. Thank you!

# Actor input Schema

## `startUrls` (type: `array`):

Websites or start pages to audit, one per line. Each one is crawled through its internal links and sitemap.

## `maxPagesPerSite` (type: `integer`):

How many pages to audit on each website.

## `checkLinks` (type: `boolean`):

Test every link found (internal and external) and report the broken ones on each page.

## `maxLinksToCheck` (type: `integer`):

Links that weren't crawled as pages (external ones, files...) are tested up to this number per website.

## `respectRobotsTxt` (type: `boolean`):

Skip pages the website's robots.txt asks crawlers not to visit.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.python.org"
  ],
  "maxPagesPerSite": 30,
  "checkLinks": true,
  "maxLinksToCheck": 500,
  "respectRobotsTxt": true
}
```

# Actor output Schema

## `overview` (type: `string`):

One row per page, worst score first: status, title, description, headings, broken links, images without alt, speed and issues.

## `summary` (type: `string`):

Per website: average score, top issues, broken links, robots.txt, sitemap and HTTPS redirect.

## `allData` (type: `string`):

Every field of every page, including canonical, Open Graph, structured data, redirects and link counts.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://www.python.org"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sndzcc/seo-audit").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "startUrls": ["https://www.python.org"] }

# Run the Actor and wait for it to finish
run = client.actor("sndzcc/seo-audit").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://www.python.org"
  ]
}' |
apify call sndzcc/seo-audit --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sndzcc/seo-audit"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HW5SZrhC1nP5OWN3I/builds/Hnqwxut9jXz8btfCT/openapi.json