Technical SEO & Headless ChromeLIVE | v3.05 Endpoints • 54+ Data Points
Headless Chrome Technical & AI-Crawler Audit + 100-Page Crawl API
Execute real Headless Chrome rendering on desktop or mobile viewports to measure Core Web Vitals (LCP, CLS, TTFB, FCP, TBT, INP), post-JS On-Page SEO, AI Crawler Readiness (robots.txt directives for GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot + llms.txt), Security Headers, Broken Links, and async 5–100 page full-site crawls without HTTP timeouts.
✅ Real JS Rendering: Full Chromium execution — audits React, Next.js, Vue, Shopify & WordPress accurately
✅ detail=full (0 Extra Cr): Returns complete H1–H6 outline, oversized images, OG/Twitter, JSON-LD & text preview
✅ 0-Credit Streaming CSV Export: Download all crawled pages in RFC-4180 CSV via ?format=csv
Billing & Architecture Note: Single-URL audits (GET /api/v1/audit) check the 24-hour Audit Vault first in mode=auto (3 Cr hit vs 10 Cr live). Multi-page crawls (POST /api/v1/audit/crawl) execute asynchronously in the background: credits are reserved for max_pages × 2 Cr, and any uncrawled pages are refunded automatically via atomic compare-and-swap on completion.
Audits a single URL in Headless Chrome (desktop 1366x768 or mobile 390x844). Returns 60+ technical data points across HTTP, On-Page SEO, Core Web Vitals, Page Weight, Links/Media, Security Headers, AI Crawler Readiness, and prioritized issues. Add detail=full at 0 extra credits to include deep DOM arrays (headings outline, oversized/missing-alt image URLs, raw JSON-LD, links inventory, and extracted text). (Cache: 24-Hour Shared Vault)
Request Parameters
0 Cr charged on 400 validation errors
Parameter
Type & Default
Description & Allowed Values
urlREQ
string
def: —
Full public HTTP/HTTPS URL or domain (e.g. https://serpspur.com/). Private/loopback/metadata IPs are blocked.
device
enum
def: "desktop"
Viewport emulation: "desktop" (1366×768) or "mobile" (390×844).
detail
enum
def: "standard"
"standard" (compact metrics) or "full" (adds deep_onpage object with full headings outline, images, OG/Twitter, JSON-LD, links inventory & 5,000-char text preview for 0 extra credits).
check_links
0 | 1
def: 0
Set 1 to live-verify HTTP status of up to 30 internal/external links on the page (20 Cr).
mode
enum
def: "auto"
"sandbox" (0 Cr), "vault" (24h cache only; 404 = 0 Cr), "live" (force fresh render), or "auto" (24h vault hit -> live fallback).
Returned Data Points Dictionary
•
Top-Level & http Object (11 fields)5 entries ▾
url / final_url / domain / device / detail_level
string
Requested URL, post-redirect final URL, normalized root domain, viewport, and detail tier.
health_score / grade
int / string
0–100 weighted technical health score and letter grade (A+, A, B+, B, C, D, F).
http.status_code / is_https
int / bool
Final HTTP status code (200, 301, 404, etc.) and HTTPS enforcement flag.
http.redirect_hops / redirect_chain[]
int / array
Number of redirect hops and ordered array of intermediate URLs & status codes.
http.server / content_type
string|null
Response Server header and MIME Content-Type.
on_page_seo (24 Post-JS DOM SEO Data Points)9 entries ▾
title / title_length
string / int
Rendered <title> text and character length.
meta_description / meta_description_length
string / int
Rendered meta description text and character length.
canonical_url / canonical_matches_url
string / bool
Extracted rel="canonical" URL and whether it matches final_url.
Dispatches a non-blocking 5–100 page Headless Chrome site crawl via sitemap discovery + internal link BFS. Returns immediately (<250ms) with a job_id and poll_url so your app never times out. Credits are reserved upfront (max_pages × 2 Cr); if the site has fewer pages than requested, unused credits are auto-refunded atomically upon completion (both when polled and via our 15-minute background reconciler cron). (Cache: Async Queue + Permanent Archive)
Request Parameters
0 Cr charged on 400 validation errors
Parameter
Type & Default
Description & Allowed Values
urlREQ
string
def: —
Starting root URL or domain (also accepts "domain" alias).
max_pages
integer
def: 25
Max unique pages to crawl (clamped 5–100). Upfront reserve = max_pages × 2 Cr.
device
enum
def: "desktop"
"desktop" or "mobile" Chrome viewport.
webhook_url
string (HTTPS)
def: null
Optional public HTTPS callback URL notified via JSON POST when crawl finishes (SSRF-validated).
mode
enum
def: "live"
"live" (real background crawl) or "sandbox" (0 Cr instant test job).
Returned Data Points Dictionary
•
Dispatch Response Fields (Returned Immediately in <250ms)4 entries ▾
Polls a running crawl or retrieves a permanently archived completed crawl for 0 credits. Returns site-wide health rollup, cross-page duplicate title/meta clusters, AI crawler readiness, paginated per-page audits, and exact auto-refund accounting. Append ?format=csv to stream ALL crawled pages directly as an RFC-4180 CSV file. (Cache: Permanent DB Archive Once Completed)
Request Parameters
0 Cr charged on 400 validation errors
Parameter
Type & Default
Description & Allowed Values
job_idREQ
path
def: —
Job ID returned by POST /api/v1/audit/crawl (or "crawl_sandbox_demo" for free sandbox).
page / per_page
integer
def: 1 / 25
Pagination controls for pages[] in JSON mode (per_page 1–100).
format
enum
def: "json"
"json" (paginated) or "csv" (streams ALL crawled pages as text/csv with Content-Disposition attachment; returns HTTP 409 if crawl is still running).
Returned Data Points Dictionary
•
summary (Site-Wide Rollup — 14 Data Points)6 entries ▾
summary.site_health_score / grade
int / string
Site-wide average technical health score (0–100) and grade.
Direct CSV download link and credits automatically refunded for uncrawled pages.
GET/api/v1/audit/crawls
0 Credits (Free Task History)
List Past Async Site Crawl Jobs
Returns a paginated history of all multi-page site crawl tasks created by your account, filterable by status, with ready-to-use poll_url and csv_url links. (Cache: Direct DB History)
Request Parameters
0 Cr charged on 400 validation errors
Parameter
Type & Default
Description & Allowed Values
page / per_page
integer
def: 1 / 20
Pagination controls (per_page 1–50).
status
enum
def: "all"
Filter by "all", "queued", "running", "completed", or "failed".
mode
enum
def: live
Pass "sandbox" to test response shape for 0 credits.
Returned Data Points Dictionary
•
crawls[] Task History Fields (15 fields)4 entries ▾
job_id / domain / start_url / device / status
string
Job identifier, target domain, viewport, and status.
Direct JSON poll URL, 0-Cr CSV URL, and ISO-8601 timestamps.
POST/api/v1/audit/batch
3 Cr / Vault Hit (0 Cr for Misses)
Batch Technical Audit Vault Lookup (Up to 50 URLs)
Checks up to 50 URLs against the 24-hour Technical Audit Vault in a single ultra-fast request. You are charged only for cache hits; misses cost 0 credits. (Cache: 24-Hour Vault Only)
Request Parameters
0 Cr charged on 400 validation errors
Parameter
Type & Default
Description & Allowed Values
urlsREQ
array<string>
def: —
Array of 1–50 public URLs to look up.
device
enum
def: "desktop"
"desktop" or "mobile".
mode
enum
def: "vault"
"vault" or "sandbox" (0 Cr).
Returned Data Points Dictionary
•
Batch Response Structure3 entries ▾
data.hits[]
array
Full audit objects for every URL found in the 24h vault.