Turnkey RESTful infrastructure and 1-click white-label embed widgets for agencies, SaaS builders, and automation pipelines. Extract deep crawl audits, Core Web Vitals, and on-page technical health in milliseconds.
Connect your WordPress websites directly to the BornSEO Cloud Engine with 1 click. Zero manual API key entry, real-time Core Web Vitals advisor, Elementor SEO widget, and 19 built-in on-page technical tools.
Instant activation. Test with the ₹1 lifetime sandbox or pick a production pass with instant UPI / QR code payment.
Lifetime access • 25 Crawls
per month
per month
per month
Follow 3 straightforward steps to start crawling and scoring websites programmatically.
Subscribe to any tier (starting at ₹1 Sandbox). Open your dashboard to view your live key (born_live_...). Toggle eye icon to reveal or copy key.
Send your key in the HTTP header: Authorization: Bearer YOUR_API_KEY or x-api-key: YOUR_API_KEY with JSON body.
Receive standardized JSON payloads containing overall SEO scores, Core Web Vitals, metadata length checks, robot compliance, and speed diagnostics.
Production endpoints for multi-page crawling, rapid single-page diagnostics, key quotas, and agency theming.
Executes a multi-page crawler audit on internal links, scores on-page technical health, verifies Core Web Vitals, and detects broken links.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| url | string | Yes | - | Fully qualified HTTP or HTTPS domain to audit (e.g., https://bornseo.com). |
| max_pages | integer | Optional | 25 | Maximum internal links to crawl. Hard capped at 50 per call to prevent server resource abuse. |
| follow_subdomains | boolean | Optional | false | Whether internal link discovery should expand to subdomain hosts (e.g., blog.example.com). |
| device | string | Optional | "mobile" | User-agent profile emulation. Accepts "mobile" (iPhone / Android) or "desktop". |
{
"success": true,
"audit_id": "AUD_7f9c2d1b4a8e",
"domain": "bornseo.com",
"max_pages_crawled": 25,
"remaining_quota": 219,
"status": "completed",
"timestamp": "2026-11-11T16:30:00Z",
"scores": {
"overall": 92,
"on_page": 90,
"technical": 96,
"performance": 88,
"security": 95
},
"meta": {
"powered_by": "BornSEO Developer API Engine",
"tier": "pro"
}
}
Instantaneous single-page health check. Evaluates Core Web Vitals (LCP, CLS, FID), meta tags, heading tags, SSL certificates, and robots directives.
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Target web address to inspect. Must begin with http:// or https://. |
{
"status": "success",
"crawl_id": "CRW_18e9a2b5c4",
"url": "https://example.com",
"score": 94,
"vitals": {
"lcp": "1.10s",
"cls": "0.02",
"fid": "15ms",
"performance_grade": "A+"
},
"checks": {
"ssl": true,
"mobile_responsive": true,
"meta_title_present": true,
"meta_title_length": 54,
"meta_desc_present": true,
"meta_desc_length": 148,
"h1_count": 1,
"canonical_tag": true,
"robots_txt_found": true,
"sitemap_xml_found": true,
"broken_links": 0
},
"meta": {
"tier": "starter",
"response_time_ms": 210,
"audit_timestamp": "2026-11-11T16:35:10Z"
}
}
Inspect your active subscription tier, remaining audit balance, reset date, and API key status without entering your dashboard.
{
"success": true,
"key_prefix": "born_live_a1b2...",
"tier": "pro",
"monthly_quota": 220,
"used_this_month": 14,
"remaining_quota": 206,
"is_active": true,
"expires_at": "2026-12-11 18:00:00"
}
Give your agency clients, SaaS users, or blog visitors an interactive website SEO audit widget. Zero coding, zero server configuration. 100% turnkey.
<iframe src="https://bornseo.com/tools/crawler-embed.html?key=YOUR_API_KEY&theme=light" width="100%" height="680" style="border: none; border-radius: 20px; box-shadow: 0 10px 30px -5px rgba(0,0,0,0.06);" loading="lazy"> </iframe>
Your Bearer key. Credits are safely consumed from your monthly plan.
Toggle between minimalist light background or high-contrast dark theme.
Hex brand color for gauges, audit CTA buttons, and progress meters.
Hides BornSEO footer branding for 100% white-label client deployment (Pro+).
Listen to real-time events emitted by the embedded iframe to trigger CRM webhook pushes, capture client leads, or resize containers automatically:
window.addEventListener('message', (event) => { // Ensure security: verify message origin is BornSEO if (!event.origin.includes('bornseo.com')) return; const { type, payload } = event.data; if (type === 'BORNSEO_AUDIT_COMPLETED') { console.log('Audit Score:', payload.score, 'Target:', payload.target_url); // Trigger internal conversion tracking or lead pipeline } else if (type === 'BORNSEO_LEAD_SUBMITTED') { console.log('Lead Captured:', payload.email); } });
Run a free on-page technical analysis on any domain.
Copy drop-in code for your favorite backend runtime or framework.
BornSEO executes crawler algorithms, DOM parsers, and scoring math strictly inside hardened server sandboxes.
Requests targeting private RFC 1918 subnets (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), loopback (127.0.0.1), or AWS/GCP metadata endpoints (169.254.169.254) are strictly aborted at DNS level.
Target websites are analyzed in isolated container memory. Malicious client-side scripts, iframe busting code, and payload injections are completely disarmed before metrics calculation.
API secret tokens are never stored in plain text. We store irreversible SHA-256 hashes in our database, making credential leaks impossible even in database dump scenarios.
Crawls are hard capped at 50 internal pages per API call. This prevents bad actors or competitors from weaponizing the API for mass database scraping or denial-of-service on target hosts.
Sliding-window rate limits enforced per Bearer API Key across 60-second intervals.
| Plan Tier | Price | Monthly Quota | Rate Limit | Max Crawl Pages | White-Label Embed | SLA Support |
|---|---|---|---|---|---|---|
| Developer Sandbox | ₹1 (Lifetime) | 25 Total | 5 req / min | 25 pages | ✓ Included | Community |
| Starter Pass | ₹499 / mo | 150 Audits / mo | 15 req / min | 35 pages | ✓ Included | Standard Email (<4h) |
| Pro Growth (Popular) | ₹999 / mo | 220 Audits / mo | 30 req / min | 50 pages | ✓ Full White-Label | Priority Email (<2h) |
| Enterprise Unlimited | ₹1,499 / mo | 2,000 Audits / mo | 60 req / min | 50 pages | ✓ Custom Brand Theming | Dedicated Queue + Slack |
Every API response includes real-time telemetry headers so your application can dynamically throttle calls before hitting limits:
| Header | Type | Example | Description |
|---|---|---|---|
| X-RateLimit-Limit | Integer | 60 | Maximum API requests allowed per 60-second sliding window for your tier. |
| X-RateLimit-Remaining | Integer | 42 | Remaining allowed requests in the current window before throttling occurs. |
| X-RateLimit-Reset | Timestamp | 1731384060 | Unix epoch timestamp indicating when the current window quota refreshes. |
| Retry-After | Seconds | 18 | Delivered on HTTP 429 status codes; exact number of seconds your worker must sleep before retrying. |
| Status | Error Code | Resolution / Meaning |
|---|---|---|
| 200 OK | - | Crawl audit completed. Scored metrics and diagnostics returned in body. |
| 400 BAD REQUEST | INVALID_URL / SSRF_BLOCKED | Missing URL parameter, SSRF private IP loopback, or malformed domain. |
| 401 UNAUTHORIZED | INVALID_KEY | Bearer API key missing, inactive, revoked, or incorrect format. |
| 402 PAYMENT REQUIRED | PLAN_EXPIRED / QUOTA_EXHAUSTED | Monthly audit quota reached or billing cycle expired. Upgrade in dashboard. |
| 429 RATE LIMITED | RATE_LIMITED | Per-minute rate limit reached. Back off with exponential retry (Retry-After: 60). |
| 422 UNPROCESSABLE | TARGET_UNREACHABLE | Destination domain failed DNS resolution, refused TCP handshake, or returned 403 bot blocking. |
| 504 GATEWAY TIMEOUT | CRAWL_TIMEOUT | Target website took longer than 15,000ms to serve complete DOM. Audit engine aborted crawl safely. |
Common questions about keys, quotas, iframe white-labeling, and security.
Once your payment of ₹1 (or higher tier) is confirmed via ZapUPI, you are instantly redirected to your user dashboard at /dashboard. Navigate to the "Developer API" tab where your active API Key card is displayed. Click the eye toggle to reveal your secret key or the "Copy Key" button to grab it instantly.
Yes! You can embed https://bornseo.com/tools/crawler-embed.html?key=YOUR_KEY across an unlimited number of client domains or portals. Every audit executed consumes credits from your unified monthly quota pool.
Yes. Our backend enforces origin matching and sliding-window rate limiters. Furthermore, the iframe communicates with our server via an internal bridge token so your master account credentials are never exposed to browser scraping.
If your monthly quota is exhausted, subsequent requests will return HTTP status 402 Payment Required with code QUOTA_EXHAUSTED. You can upgrade to a higher tier at any time from the dashboard, which immediately credits additional audits to your balance.
Yes. Inside your dashboard at /dashboard, click the "Regenerate Key" button. Your previous key is revoked immediately and a brand new cryptographic token is issued without interrupting your active subscription plan.
Our crawler analyzes critical rendering path metrics including Largest Contentful Paint (LCP), Cumulative Layout Shift (CLS), and First Input Delay (FID/INP) using modern server-side headless browser simulation calibrated to mobile 4G network conditions.