Documentation

LeadRanker AI

Add AI lead scoring to any website in under 5 minutes — no coding required. Works with WordPress, Next.js, Webflow, Wix, Shopify, and any HTML site.

<500ms

Average scoring time

1 tag

Installation on any site

Zero

Form changes needed

LeadRanker AI intercepts form submissions on your website, sends the data to our AI engine, and instantly scores each lead as HOT, WARM, or COLD. The visitor is redirected to a personalised score page. You receive an alert for every HOT lead.

Quick Start

From zero to scoring leads in 5 minutes.

Create your account at app.leadrankerai.com — free trial included, no credit card needed.

Get your API key — go to Dashboard → Connections. Copy the key that starts with lrai_

Add one script tag to your website (see platform guides below).

Test it — fill out any form on your site. You should be redirected to a score page within 1 second.

Check your dashboard — the lead appears at app.leadrankerai.com with a score and recommendation.

✅

No form changes needed. The pixel detects email, name, and phone fields automatically on any form — Elementor, Contact Form 7, Gravity Forms, MetForm, or plain HTML.

How It Works

The full technical flow from form submission to lead score:

Flow

Visitor fills form on your site
        ↓
LeadRanker pixel intercepts submit silently
        ↓
POST /api/v1/ingest/pixel  (with your API key)
        ↓
AI analyses: name + email + phone + message + page context
        ↓
Score: 0–100  |  Bucket: HOT / WARM / COLD
        ↓
Visitor → redirected to Magic Portal (their score page)
        ↓
You → HOT lead email alert + dashboard update

ℹ️

Offline resilience: If a visitor submits a form while offline, the pixel caches the lead locally and retries automatically when their connection returns.

WordPress Plugin

Works with MetForm, Elementor, Contact Form 7, Gravity Forms, WPForms, Ninja Forms, and any other WordPress form plugin — zero configuration.

Download the plugin — go to Dashboard → Connections → Download WordPress Plugin (.zip)

In WordPress admin: Plugins → Add New → Upload Plugin → choose the .zip file → Install Now → Activate

In the left sidebar click ⚡ LeadRanker AI → paste your lrai_ API key → set API URL to https://api.leadrankerai.com

Check Enable AI Scoring → click Save Settings

Click Test Connection — you should see ✅ Connected

MetForm specific notes

MetForm uses AJAX submission. The pixel automatically handles this. If you notice MetForm submitting before the score loads, enable Debug Mode in the plugin settings (F12 → Console) to verify the intercept is working.

⚠️

If your WordPress site uses a caching plugin (WP Rocket, W3 Total Cache), clear the cache after installing the plugin so the script loads on all pages.

Next.js

Add to your root layout — the pixel will detect and score forms on all pages automatically.

App Router (Next.js 13+)

tsx — app/layout.tsx

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html>
      <body>
        {children}
        {/* LeadRanker AI Pixel — scores every form automatically */}
        <script
          src="https://app.leadrankerai.com/pixel.js"
          data-api-key="lrai_YOUR_KEY_HERE"
          data-portal="https://app.leadrankerai.com/portal"
          defer
        />
      </body>
    </html>
  )
}

Pages Router (Next.js 12 and below)

tsx — pages/_app.tsx

import Head from 'next/head'

export default function MyApp({ Component, pageProps }) {
  return (
    <>
      <Head>
        <script
          src="https://app.leadrankerai.com/pixel.js"
          data-api-key="lrai_YOUR_KEY_HERE"
          data-portal="https://app.leadrankerai.com/portal"
          defer
        />
      </Head>
      <Component {...pageProps} />
    </>
  )
}

Webflow

Open your Webflow project → click Project Settings (gear icon)

Go to the Custom Code tab

In the Footer Code section, paste:

html — Webflow Footer Code

<script
  src="https://app.leadrankerai.com/pixel.js"
  data-api-key="lrai_YOUR_KEY_HERE"
  data-portal="https://app.leadrankerai.com/portal"
  defer>
</script>

4

Click Save Changes → then Publish your site

Wix

Go to Wix Dashboard → Settings → Custom Code

Click + Add Custom Code

Paste the script tag (same as Webflow above)

Set Place Code in: Body - end

Set Add Code to Pages: All Pages → click Apply

⚠️

Wix forms use their own submission system. The pixel intercepts at the JavaScript level. If Wix blocks it, use the Email Forwarding method instead — forward Wix form notification emails to your Magic Email address.

Plain HTML / Any Website

Paste this tag before </body> on every page that has a contact form:

html

<script
  src="https://app.leadrankerai.com/pixel.js"
  data-api-key="lrai_YOUR_KEY_HERE"
  data-portal="https://app.leadrankerai.com/portal"
  defer>
</script>

Replace lrai_YOUR_KEY_HERE with your actual API key from the Connections page.

Shopify

Shopify Admin → Online Store → Themes → Edit Code

Open layout/theme.liquid

Find </body> and paste the script tag just above it

Click Save

Facebook / Meta Lead Ads

Facebook Lead Ads collect leads inside Facebook — there's no website form. Use the Email Forwarding method.

Go to Meta Business Suite → Lead Ads → Leads Setup

Find Email Notifications or Lead Delivery

Copy your Magic Email Address from Dashboard → Connections

Paste it as the notification email destination

Every new Facebook lead will be scored automatically within seconds

ℹ️

Your Magic Email looks like: leads+YOUR-BROKERAGE-ID@leadrankerai.com — find it in Dashboard → Connections → Magic Email Address.

Google Ads Lead Form Extensions

In Google Ads → open your campaign → Assets → Lead Form

Scroll to Lead Delivery — Email

Paste your Magic Email Address as the recipient

Submit a test lead to verify scoring

Email Forwarding (Gmail)

No website access? Use Gmail filters to forward lead notification emails to LeadRanker automatically.

Open Gmail → Settings (gear) → See all settings → Filters and Blocked Addresses

Click Create a new filter

In Subject, type keywords like "New Lead" or "Form submission" or "New Enquiry"

Click Create filter → check Forward it to → paste your Magic Email Address

Click Create filter. Done — every matching email now triggers AI scoring.

API Authentication

All API requests require either a JWT Bearer token (for dashboard APIs) or an API Key header (for the pixel ingest endpoint).

Get a token (login)

bash

curl -X POST https://api.leadrankerai.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"yourpassword"}'

# Response:
{
  "access_token": "eyJhbGciOiJIUzI1NiJ9...",
  "token_type": "bearer"
}

Use the token

bash

curl https://api.leadrankerai.com/leads/history \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..."

Pixel Ingest Endpoint

Used by the pixel script and WordPress plugin to submit lead data for scoring.

Endpoint

POST  https://api.leadrankerai.com/api/v1/ingest/pixel

Request headers

Header	Required	Description
X-API-Key	✅ Yes	Your `lrai_` API key from Dashboard → Connections
Content-Type	✅ Yes	application/json

Request body

Field	Type	Required	Description
email	string	✅ Yes	Lead's email address
name	string	No	Lead's full name
phone	string	No	Phone number (any format)
message	string	No	Form message / enquiry text
source	string	No	e.g. "wordpress_pixel", "custom"
page_url	string	No	URL where form was submitted

Response

json — 200 OK

{
  "status":         "scored",
  "lead_id":        "uuid-here",
  "score":          85,
  "bucket":         "HOT",
  "sentiment":      "urgent",
  "recommendation": "Follow up within 2 hours. Lead shows strong buying signals.",
  "magic_link":     "https://app.leadrankerai.com/portal?token=eyJ..."
}

Manual Score Endpoint

Score a lead manually from your own system using a JWT token.

bash

curl -X POST https://api.leadrankerai.com/leads/score \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Rahul Sharma",
    "email":   "rahul@example.com",
    "phone":   "+91 9876543210",
    "message": "I want to buy a 3BHK flat in Kochi under 60 lakhs, need to move in 2 months"
  }'

Webhook / CRM Integration

Push leads directly from your CRM or any system via webhook.

Endpoint

POST  https://api.leadrankerai.com/inbound/{YOUR_BROKERAGE_ID}

Your brokerage ID is in your Magic Email address: leads+THIS-PART@leadrankerai.com

json — Request body

{
  "message": "Lead enquiry text here",
  "name":    "Lead Name",
  "email":   "lead@example.com",
  "phone":   "+91 9876543210",
  "source":  "salesforce"
}

FAQ

Is my lead data secure?

Yes. All data is encrypted in transit (TLS 1.3) and at rest (AES-256). We never sell or share your lead data. Compliant with the Indian IT Act 2000 and GDPR for international clients.

Does the pixel slow down my website?

No. The pixel loads with defer, meaning it loads after your page content. It has zero impact on page speed or Core Web Vitals.

What if the lead submits offline?

The pixel detects the offline state, caches the lead submission locally, and retries automatically when the connection returns.

What if the API is down?

The pixel has a fallback — if our API doesn't respond within the timeout, the original form submission proceeds normally. Your leads are never lost.

Does the lead portal page require a login?

No. The Magic Portal link contains a signed JWT token — leads can view their score without creating an account. Links expire after 1 hour for security.

How does field detection work?

The pixel scores each input field by checking its name, id, placeholder, aria-label, and autocomplete attributes to identify email, name, phone, and message fields — no manual mapping needed.

Can I use this on multiple websites?

Yes. One LeadRankerAI account works across unlimited websites. All leads from all sites appear in one dashboard, tagged with their source URL.

I need help with setup — who do I contact?

Email hello@leadrankerai.com or use the Invite Developer button in the Connections page to send setup instructions to your IT team.