Developer Documentation

⚡ Quick Start

Get up and running in under a minute. Here are three ways to start using LeadAuditPro programmatically.

# Search for leads
curl -X POST \
  https://www.leadauditpro.com/api/v1/searches \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"plumber","location":"Miami, FL"}'

# Audit a website
curl https://www.leadauditpro.com/api/quick-audit?url=example.com

<script
  src="https://www.leadauditpro.com
/static/embed.js"
  data-partner="YOUR_ID">
</script>

🔌 REST API

Authentication

All API requests require an X-API-Key header. You can generate API keys from your dashboard.

curl -H "X-API-Key: lap_abc123..." \
  https://www.leadauditpro.com/api/v1/searches

Base URL

https://www.leadauditpro.com/api/v1

Endpoints

Rate Limits

• Pro plan: 100 requests/min
• Agency & Enterprise: 500 requests/min

Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.

Response Format

All responses are JSON. List endpoints support pagination via ?page= and ?per_page= query parameters.

{
  "data": [...],
  "page": 1,
  "per_page": 20,
  "total": 143
}

🔎 Quick Audit API

Run an instant SEO audit on any URL. No authentication required for basic usage.

Endpoint

GET /api/quick-audit?url={url}

Rate Limits

• Anonymous: 5 audits per day (by IP)
• With API key: Unlimited (subject to plan limits)

Example Request

curl "https://www.leadauditpro.com/api/quick-audit?url=example.com"

Example Response

{
  "url": "https://example.com",
  "score": 72,
  "grade": "C+",
  "pass_count": 18,
  "total": 25,
  "checks": [
    {
      "name": "Title Tag",
      "pass": true,
      "message": "Title tag is present and within optimal length."
    },
    {
      "name": "Meta Description",
      "pass": false,
      "message": "Meta description is missing."
    }
  ]
}

CORS is enabled, so you can call this endpoint directly from client-side JavaScript.

🔨 Embed Widget

Add a free SEO audit tool to any website with a single line of HTML. Visitors enter their URL and get an instant audit — and you capture the lead.

Installation

<script src="https://www.leadauditpro.com/static/embed.js"
  data-partner="YOUR_PARTNER_ID"></script>

Customization

See the full embed documentation for advanced options and examples.

🌐 Chrome Extension

Audit any webpage instantly from your browser toolbar. The LeadAuditPro Chrome Extension gives you one-click SEO scores, detailed check results, and the ability to save audits to your account.

• One-click audit on any page you visit
• SEO score, grade, and detailed breakdown
• Save results to your LeadAuditPro dashboard

Download the Chrome Extension →

🔔 Webhooks

Get notified in real-time when events happen in your account. Configure webhook URLs from your dashboard settings.

Supported Events

Payload Format

{
  "event": "search.completed",
  "timestamp": "2026-03-28T12:00:00Z",
  "data": {
    "search_id": 4521,
    "keyword": "plumber",
    "location": "Miami, FL",
    "result_count": 47
  }
}

Webhooks are sent as POST requests with a Content-Type: application/json header. A X-Signature header is included for verification.

🔑 Getting Your API Key

1. Sign up for a free account at leadauditpro.com/register
2. Go to your Dashboard
3. Navigate to API Keys
4. Click Create New Key and give it a name

Your key will start with lap_ and should be kept secret. Never expose it in client-side code — use it only in server-to-server requests.