# SEO Helper: On-Page Audit & SERP Preview

SEO Helper runs two modes over a list of URLs. Onpage mode returns a full audit per page: title and description with character lengths, canonical match, robots directives, a heading outline, word count, images with missing alt counts, link counts by type, hreflang, JSON-LD and a flat issue list. Serp_preview mode shows how Google would truncate your snippet. Pages cost $1.00 per 1,000. Run it from Apify Console or the API.

## Key facts

- Price: from $0.001 per page audit, $1.00 per 1,000
- Pricing model: Pay per event
- Output: JSON, CSV, Excel, XML, RSS via Apify datasets
- Access: Apify Console, REST API, Python and JS clients, MCP tool seo_page_audit
- Version: Updated Nov 2026, build 0.1.16
- Usage: 96.7% successful runs (30 days)
- Actor: subimpact/seo-helper

## Who it is for

- SEO consultants auditing a client's key pages before a campaign
- Content teams checking title and description lengths at scale
- Developers verifying canonical, robots and hreflang after a deploy
- Agencies comparing pages before and after an SEO change

## Use cases

### Audit a page before you edit it

Set mode onpage and list URLs in pageUrls. Each row returns issues such as missing-title, title-too-long, missing-meta-description, no-h1, multiple-h1, canonical-mismatch, noindex and all-images-missing-alt. Because the flags are flat strings, you can filter a spreadsheet by issue type rather than reading a nested report, which makes a pre-campaign audit quick.

### Preview a snippet before publishing

Switch to serp_preview and pass serpOverrides with a candidate title and description per URL. The actor applies Google-style truncation at 60 and 155 characters on word boundaries and returns displayedTitle, titleTruncated and descriptionTruncated, so you can test a rewrite without touching the live page.

### Check technical tags after a deploy

The audit record includes canonical with canonicalMatchesUrl, robots with noindex flagged, hreflang alternates, JSON-LD structured data and microdata itemtypes. Run the same URL list before and after a release and diff those fields to catch a canonical pointing at staging, a stray noindex or hreflang that lost a market.

### Find alt text and link gaps in bulk

imagesTotal and imagesMissingAlt come with the image URLs, and linkCounts splits total, internal, external, follow, nofollow, sponsored and UGC. Set includeLinks true to keep the full lists. That gives an accessibility and internal linking read for a batch of pages without a separate crawler or a manual page-by-page check.

### Catch redirects and fetch failures

Each row carries httpStatus, finalUrl and redirectChain with every hop and its status code. Pages that fail arrive as rows with a populated error field and a null audit, so a 404 or a blocked fetch is visible rather than missing. That matters when a sitemap export includes URLs that no longer resolve.

## Price events

- page audit (`page-audit`): $0.001, lowest tier $0.001. One URL audited in onpage mode (full on-page SEO report).
- SERP preview (`serp-preview`): $0.001, lowest tier $0.001. One URL processed in serp_preview mode (snippet truncation preview).

Prices from the Apify Store. Apify shows the final price before each run.

## How it compares with other Apify actors

Price per 1,000 pages at Apify Store list prices, checked 20 Nov 2026.

| Actor | Price per 1,000 pages (Free plan) | Higher plans (Gold) | Start fee per run | Platform usage | Users | Rating | Last build |
| --- | --- | --- | --- | --- | --- | --- | --- |
| SEO Helper (on-page audit + SERP preview) (this API) | $1.00 | $1.00 | None | Paid separately | 1 | No reviews yet | 18 Nov 2026 |
| [Complete SEO Audit Tool - Website Crawler with 0-100 Scores](https://apify.com/smart-digital/complete-seo-audit-tool) | $40.00 | $30.00 | None | Included | 858 | 5.0 (4 reviews) | 25 Oct 2026 |
| [Website SEO Audit Crawler — On-Page Analyzer](https://apify.com/logiover/website-seo-audit-crawler) | $10.00 | $5.00 | $0.00005 | Included | 186 | No reviews yet | 14 Nov 2026 |
| [Advanced SEO Audit Tool - AI-Powered Insights](https://apify.com/ittechinnovators/advanced-seo-audit-tool---ai-powered-insights) | $10.00 | $7.00 | $0.00005 | Paid separately | 51 | 5.0 (2 reviews) | 15 Jan 2026 |
| [Schema Markup Scraper & SEO Auditor](https://apify.com/autofacts/metadata-scraper) | $5.00 | $3.00 | None | Included | 240 | No reviews yet | 13 Nov 2026 |

### Where Complete SEO Audit Tool - Website Crawler with 0-100 Scores is stronger

- Crawls a whole site and returns a site level report with average scores
- Core Web Vitals and performance checks alongside on-page SEO
- Issues carry a priority and a fix hint, plus duplicate title and description detection

### Where this API is stronger

- Plain HTTP with no browser, so page audits run fast and light
- SERP snippet preview mode in the same actor
- Title and description truncation flags for snippet planning

### Where Website SEO Audit Crawler — On-Page Analyzer is stronger

- Crawls a whole site with scope and page limits
- Detailed per page fields: canonical, meta robots, Open Graph, Twitter card and image alt counts
- SEO score and issue count on every row

### Where this API is stronger

- SERP snippet previews with truncation flags as well as audits
- Spot checks on a URL list without starting a crawl
- Structured data and hreflang checks in the same audit row

### Where Advanced SEO Audit Tool - AI-Powered Insights is stronger

- Performance, UX and payment gateway checks alongside SEO
- AI generated recommendations when an OpenAI key is supplied
- Mobile friendliness and loading time recorded per page

### Where this API is stronger

- No API key needed for any part of the audit
- SERP snippet preview with truncation flags in the same actor
- On-page detail row covering meta tags, headings, images, links and hreflang

### Where Schema Markup Scraper & SEO Auditor is stronger

- Extracts JSON-LD, microdata, RDFa, Open Graph and Twitter Cards in one row
- Schema type detection at scale, including LocalBusiness with NAP and geo
- Optional crawl with depth and request limits

### Where this API is stronger

- SERP snippet previews with truncation flags as a second mode
- Plain HTTP audit with no browser step
- Two modes behind one small input set

SEO audit actors differ in how much of a site they crawl and how much reporting they add. The smart-digital and logiover listings produce site level crawls with scores, and autofacts goes deepest on structured data, while this actor stays a single page audit. Its second mode previews how a title and description would look in Google, with truncation flags.

Prices are Apify Store list prices, checked 20 Nov 2026. Platform usage 'Paid separately' means Apify bills compute on top of the event price. Check each listing before you buy.

## Input

- `mode` (string, optional): onpage = audit URLs; serp_preview = Google snippet preview with truncation flags
- `pageUrls` (array, optional): URLs to audit (onpage mode) or preview (serp_preview mode). Leave empty for a one-URL demo run.
- `maxUrls` (integer, optional): Optional cap on how many URLs are processed per run. Leave empty for no limit.
- `serpOverrides` (array, optional): Optional title/description overrides per URL for serp_preview mode (used instead of the live page)
- `useLivePage` (boolean, optional): serp_preview: pull title/description from the live page before applying overrides
- `includeLinks` (boolean, optional): onpage: include the full link list + image lists in the audit record
- `fetchTimeoutSec` (integer, optional): Per-page fetch timeout in seconds
- `proxyUrl` (string, optional): Optional HTTP(S) proxy for page fetches

### Example input

```json
{
  "pageUrls": [
    "https://example.com"
  ]
}
```

## Output fields

- `recordType` (any): 
- `url` (any): 
- `httpStatus` (any): 
- `issues` (any): 
- `displayedTitle` (any): 
- `titleTruncated` (any): 
- `descriptionTruncated` (any): 

## Sample output

Trimmed from one of our own test runs. Personal data is redacted.

```json
[
  {
    "recordType": "page-audit",
    "url": "https://example.com",
    "finalUrl": "https://example.com/",
    "httpStatus": 200,
    "redirectChain": [],
    "audit": {
      "url": "https://example.com/",
      "title": "Example Domain",
      "titleLength": 14,
      "titleOverLimit": false,
      "description": "",
      "descriptionLength": 0,
      "descriptionOverLimit": false,
      "canonical": "",
      "canonicalMatchesUrl": null,
      "robots": null,
      "metaRefresh": null,
      "headings": [],
      "headingCounts": {},
      "h1Count": 0,
      "wordCount": 25,
      "imagesTotal": 0,
      "imagesMissingAlt": 0,
      "imagesMissingAltUrls": [],
      "allImages": [],
      "openGraph": {},
      "twitter": {},
      "linkCounts": {
        "total": 0,
        "internal": 0,
        "external": 0,
        "nofollow": 0,
        "sponsored": 0,
        "ugc": 0
      },
      "links": [],
      "hreflang": [],
      "structuredData": [],
      "microdataItemtypes": []
    },
    "issues": [
      "missing-meta-description",
      "no-h1"
    ]
  }
]
```

## How to run it

1. Set mode to onpage for a full audit or serp_preview for snippet truncation checks.
2. Paste URLs into pageUrls, for example https://example.com/product/1. Leave it empty for a one-URL demo run.
3. Set maxUrls on large lists to stay inside the run timeout, and raise fetchTimeoutSec if slow pages time out.
4. For a preview of a rewrite, add serpOverrides entries with url, title and description, and set useLivePage false to test the override alone.
5. Run the actor, then export the rows as JSON or CSV and filter on the issues array.

### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/subimpact~seo-helper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pageUrls":["https://example.com"]}'
```

### Python

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("subimpact/seo-helper").call(run_input={
      "pageUrls": [
        "https://example.com"
      ]
    })

for item in client.dataset(run["default_dataset_id"]).iterate_items():
    print(item)
```

### JavaScript

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('subimpact/seo-helper').call({
  "pageUrls": [
    "https://example.com"
  ]
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);
```

### MCP

```bash
claude mcp add subimpact-data -e APIFY_TOKEN=<YOUR_APIFY_TOKEN> -- npx -y @subimpact/data-mcp

# Then ask your agent to use the seo_page_audit tool.
```

### n8n

Use the Apify node (Run an Actor).
Actor ID: subimpact/seo-helper
Input JSON: paste the example input below.

## Limits

- The SERP preview approximates Google's rules and is not a live Google result.
- URLs are fetched one at a time, so very large lists need a cap or several runs.
- Sites with aggressive anti-bot protection may need your own proxy.
- Pages that fail to fetch return an error row with no audit data.

## FAQ

### What does an audit cost?

Both modes are billed at $0.001 per URL, which is $1.00 per 1,000 pages, and platform usage is billed separately by Apify. A page that cannot be fetched still returns a row with its error, so you can tell a failed fetch from a page you never submitted.

### Do I need API keys for Google or an SEO vendor?

No. The actor fetches pages over plain HTTP with no browser and no third-party key. The SERP preview is its own approximation of Google's presentation rules rather than a live Google query, which is why it runs without a search API.

### How accurate is the SERP preview?

It applies Google-style limits of 60 characters for the title and 155 for the description, truncating on word boundaries with an ellipsis. Google may render snippets differently for a particular query, so treat the preview as a length and wording check rather than a pixel-exact mock.

### Which issues does the audit flag?

Flat flags cover missing-title, title-too-long, missing-meta-description, no-h1, multiple-h1, canonical-mismatch, noindex and all-images-missing-alt. The underlying values, character lengths and counts sit in the audit object beside each flag, so you can filter on the flag and still read the detail.

### How fast does it process a list?

URLs are processed sequentially, typically 150 to 300 per minute. On a very large list, set maxUrls so the run finishes inside the platform timeout, or split the list across runs and merge the exports afterwards.

### What happens when a site blocks the request?

The row is delivered with a populated error field and a null audit rather than being dropped. Sites with aggressive anti-bot protection may need the proxyUrl option set to an HTTP or HTTPS proxy; otherwise a block shows up as a fetch failure you can retry.

### Can I test a title rewrite without publishing it?

Yes, in serp_preview mode. Add a serpOverrides entry with the URL plus candidate title and description, and set useLivePage false if you want nothing read from the live page. The row then reports the truncated display plus both truncation flags for the version you are considering.

## Links

- Page: https://subimpact.net/apis/seo-helper/
- Category: https://subimpact.net/apis/category/search-seo/
- Run on Apify: https://apify.com/subimpact/seo-helper
- All data APIs: https://subimpact.net/apis/
- Catalogue JSON: https://subimpact.net/apis/catalogue.json
