DEVELOPER PLATFORM • REST API & WHITE-LABEL EMBEDS

High-Speed Website Crawler & Technical SEO Scoring Engine

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.

Sub-second single crawl 99.9% Cloud Uptime SLA Bearer Token & Zero-Trust SSRF Defense 1-Click Embeds for WP/Shopify
⚡ Official Release: Version 1.2.1

BornSEO is Now in WordPress!

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.

✓ 1-Click Cloud Sync ✓ Zero Server Load ✓ 19 Built-in SEO Tools ✓ Elementor SERP Preview
TRANSPARENT TIER PRICING

Simple Pricing, Instant API Keys

Instant activation. Test with the ₹1 lifetime sandbox or pick a production pass with instant UPI / QR code payment.

Monthly
Annual Save 15%
Test Drive

Developer Sandbox

₹1

Lifetime access • 25 Crawls

  • 25 Lifetime Audits
  • Live REST API Access
  • 5 requests / min rate
  • Core Web Vitals Scorer
  • White-Label Embed Widget
Starter

Starter Pass

₹499

per month

  • 150 Audits / month
  • Full JSON REST API
  • 15 requests / min rate
  • Up to 35 pages per audit
  • White-Label Embed Widget
Most Popular
Pro Growth

Pro Growth Pass

₹999

per month

  • 220 Audits / month
  • 30 requests / min rate
  • Up to 50 pages per audit
  • Deep Core Web Vitals
  • Full White-Label Iframe Embed
Enterprise

Enterprise Unlimited

₹1,499

per month

  • 2,000 Audits / month
  • 60 requests / min rate
  • Dedicated Priority Queue
  • 24/7 Priority SLA Slack / Email
  • Custom Themed Agency Embed
GET STARTED IN 60 SECONDS

Developer Quickstart Integration

Follow 3 straightforward steps to start crawling and scoring websites programmatically.

1

Obtain Your Live Key

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.

2

Authenticate Requests

Send your key in the HTTP header: Authorization: Bearer YOUR_API_KEY or x-api-key: YOUR_API_KEY with JSON body.

3

Consume Scored JSON

Receive standardized JSON payloads containing overall SEO scores, Core Web Vitals, metadata length checks, robot compliance, and speed diagnostics.

REST SPECIFICATION v1

REST API Endpoints Reference

Production endpoints for multi-page crawling, rapid single-page diagnostics, key quotas, and agency theming.

POST /api/v1/audit.php Crawler Engine

Executes a multi-page crawler audit on internal links, scores on-page technical health, verifies Core Web Vitals, and detects broken links.

Content-Type: application/json

Request Parameters (JSON Body)

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".

Sample JSON Response (200 OK)

{
  "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"
  }
}
POST /api/v1/crawl.php Sub-Second Audit

Instantaneous single-page health check. Evaluates Core Web Vitals (LCP, CLS, FID), meta tags, heading tags, SSL certificates, and robots directives.

Content-Type: application/json

Request Parameters

Parameter Type Required Description
url string Yes Target web address to inspect. Must begin with http:// or https://.

Sample JSON Response (200 OK)

{
  "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"
  }
}
GET /api/developer/keys.php Account Meta

Inspect your active subscription tier, remaining audit balance, reset date, and API key status without entering your dashboard.

Authorization: Bearer <KEY>

Sample JSON Response (200 OK)

{
  "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"
}
WHITE-LABEL EMBED ENGINE

Embed BornSEO Into Your Own Website

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>

Supported Query Parameters

?key=YOUR_API_KEY

Your Bearer key. Credits are safely consumed from your monthly plan.

&theme=light|dark

Toggle between minimalist light background or high-contrast dark theme.

&primary=%230866F5

Hex brand color for gauges, audit CTA buttons, and progress meters.

&hide_brand=1

Hides BornSEO footer branding for 100% white-label client deployment (Pro+).

Host Window postMessage Bridge

v1.2 Protocol

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);
  }
});
client-site.com/seo-audit
Live Preview
🔍

Instant SEO Website Audit

Run a free on-page technical analysis on any domain.

Overall Health
92 / 100 • Grade A+
92%
LCP
1.2s
CLS
0.02
SSL
Secure
MULTI-LANGUAGE INTEGRATION

Multi-Language Code Snippets

Copy drop-in code for your favorite backend runtime or framework.

curl -X POST https://bornseo.com/api/v1/crawl.php   -H "Authorization: Bearer born_live_xxxxxxxxxxxxxxxx"   -H "Content-Type: application/json"   -d '{"url": "https://example.com"}'
POST https://bornseo.com/api/v1/crawl.php
JSON In / JSON Out
ENTERPRISE SECURITY SPECIFICATION

Protected Architecture & Zero-Risk Execution

BornSEO executes crawler algorithms, DOM parsers, and scoring math strictly inside hardened server sandboxes.

🛡️

Zero-Trust SSRF Defense

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.

⚡

Isolated DOM Execution

Target websites are analyzed in isolated container memory. Malicious client-side scripts, iframe busting code, and payload injections are completely disarmed before metrics calculation.

🔒

SHA-256 Token Storage

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.

⏱️

Strict Pagination Cap

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.

RATE LIMITING POLICY

Tier Quotas & Concurrency Matrix

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

Standardized Rate Limit Response Headers

IETF Draft Compliance

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.

Standardized HTTP Response Status Codes

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.
FREQUENTLY ASKED QUESTIONS

Developer FAQ

Common questions about keys, quotas, iframe white-labeling, and security.

How do I get my live API key after completing payment?

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.

Can I use the white-label iframe embed on multiple client websites?

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.

Is my secret API key safe if passed in an iframe URL?

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.

What happens when my monthly audit quota runs out?

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.

Can I regenerate my API key if it is compromised?

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.

How are Core Web Vitals measured?

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.