Public REST endpoint

LLMRank Public API Check any website's AI visibility score programmatically

Audit pages from your app, internal tooling, monitoring scripts, or SEO dashboards. Send a URL, receive an AI visibility score, category-level breakdowns, and actionable recommendations in JSON.

View code examplesTry the web app
POST /api/auditNo API keyJSON responseFair use: 10 req/min
API quickstart

Endpoint

POST https://llmrank.nanocorp.app/api/audit

Content-Type: application/json

Body

Example
{
  "url": "https://example.com"
}

Category summary example

Example
{
  "score": 67,
  "categories": {
    "technical": 70,
    "content": 65,
    "structure": 80,
    "freshness": 50,
    "authority": 60,
    "llm_readiness": 75
  },
  "recommendations": [
    "Add stronger schema coverage",
    "Improve freshness signals"
  ]
}

The simplified example above is useful when you want a compact category map. The live response adds the audited URL, `overall_score`, per-category weights, detailed audit notes, recommendation counts, mode, and a timestamp.

Endpoint documentation

One request in, six AI visibility dimensions out

Use the public endpoint directly from backend jobs, browser apps, or scripts. The free API returns the core score and category breakdown without authentication.

Request

Method: POST

URL: https://llmrank.nanocorp.app/api/audit

Headers: Content-Type: application/json

Body:JSON with a single `url` field. Optional `mode: "full"` returns the complete recommendation list.

{
  "url": "https://example.com"
}

Usage notes

  • Free to use — no API key required.
  • Fair use guidance: keep usage within 10 requests/minute per client.
  • Use `mode: "full"` only when you need the complete recommendation list.

Actual response shape

The public API returns a verbose JSON payload designed to be directly usable in apps and dashboards, not just a single score.

{
  "url": "https://example.com/",
  "overall_score": 67,
  "categories": [
    {
      "name": "Content Quality",
      "score": 65,
      "weight": 0.3,
      "details": [
        "Single H1 present",
        "Strong heading hierarchy"
      ]
    },
    {
      "name": "Schema Markup",
      "score": 80,
      "weight": 0.2,
      "details": [
        "JSON-LD detected",
        "WebSite schema detected"
      ]
    }
  ],
  "recommendations": [
    "Expand the page with more substantive copy",
    "Expose freshness signals such as dateModified"
  ],
  "total_recommendations": 6,
  "mode": "free",
  "timestamp": "2026-06-02T00:00:00.000Z"
}
FieldType

url

Final audited URL after normalization and redirects.

string

overall_score

Weighted 0-100 AI visibility score for the submitted page.

number

categories[]

Six scored dimensions, each with a name, score, weight, and human-readable details.

array

recommendations[]

Prioritized optimization suggestions. Free mode returns a short subset.

array

total_recommendations

How many total recommendations exist before free-mode truncation.

number

mode

Controls how many recommendations are returned.

"free" | "full"

timestamp

ISO-8601 generation time for the audit response.

string

Code examples

Start with curl, ship with fetch or requests

The endpoint is plain JSON over HTTPS, so it slots into any stack without SDKs.

curl

Example
curl -X POST https://llmrank.nanocorp.app/api/audit \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

JavaScript fetch

Example
const response = await fetch("https://llmrank.nanocorp.app/api/audit", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    url: "https://example.com"
  })
});

if (!response.ok) {
  throw new Error("Audit failed");
}

const data = await response.json();
console.log(data.overall_score);
console.log(data.categories);

Python requests

Example
import requests

response = requests.post(
    "https://llmrank.nanocorp.app/api/audit",
    json={"url": "https://example.com"},
    timeout=20,
)
response.raise_for_status()

data = response.json()
print(data["overall_score"])
print(data["recommendations"])

Use cases

Built for recurring visibility checks

The public audit endpoint is simple enough for hobby projects and structured enough for production monitoring.

Use case 1

Bulk audit your pages

Queue product, landing, and blog URLs to benchmark which pages are already ready for AI engines.

Use case 2

Monitor your score over time

Run the endpoint on a schedule to detect when a release improves or hurts your AI visibility baseline.

Use case 3

Build SEO dashboards

Feed the API into internal dashboards, Sheets, or client reports alongside your existing SEO metrics.

Paid upgrade

Need full report? Get the $29 PDF →

The API is ideal for lightweight programmatic checks. When you need a client-ready PDF, fuller recommendations, and a more decision-ready action plan, use the paid report.

Need full report? Get the $29 PDF →See pricing details