Developer API v1 & Anthropic MCP Endpoint

SEO & AEO API: Automatizza i tuoi flussi di lavoro di ricerca e IA

Direct programmatic access to live Google SERPs and AI Overviews, AI citation checks across ChatGPT, Perplexity, Claude and Gemini, backlinks and domain authority, keyword metrics, site audits, and real-time AI bot crawler tracking. Un'unica API REST e un server MCP, la stessa chiave.

POST /api/v1/ai-citation-check
curl -X POST "https://www.airanklab.com/api/v1/ai-citation-check" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-api-secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "best AEO audit tools 2026",
    "domain": "airanklab.com",
    "engines": ["ChatGPT", "Perplexity", "Claude", "Gemini"]
  }'
Dataset Principali

Il motore di dati su cui si baseranno i tuoi flussi di lavoro

Combina i dati tradizionali delle SERP di Google con metriche di citazione di motori IA in tempo reale e log dei crawler bot.

Country + Device

Live Search Engine SERPs

Fetch live Google SERPs — organic positions, featured snippets, People Also Ask, related searches — plus Google AI Overview and AI Mode answers with every source they cite, by country, language and device.

4 AI Engines

AI Search Visibility (AEO/GEO)

Ask ChatGPT, Perplexity, Claude and Gemini the same question in one call and get back who mentions you, who cites you, from which URLs, and which competitors won the answer instead.

Any Domain

Backlinks & Domain Authority

Pull the full backlink profile of any domain: authority rank, referring domains, individual links with anchors and spam scores, anchor-text distribution, monthly trend, and bulk authority for up to 100 domains.

Real-time Logs

AI Bot Crawler Log Analytics

Inspect live server logs of GPTBot, ClaudeBot, PerplexityBot, Bytespider, and Googlebot traffic to protect IP or ensure indexation.

Instant Keyword Vol

Keyword Universe & SERP Intent

Query monthly search volumes, keyword difficulty (KD), CPC, intent classification (Informational vs Commercial), and AI Overview presence.

Full Technical Health

Site Audits & Core Web Vitals

Programmatically diagnose web pages for technical SEO blockers, Core Web Vitals (LCP, CLS, INP), JSON-LD schema, and llms.txt compatibility.

Zero-Credit Reads

Google Analytics 4 & Search Console

Fetch Google Search Console performance data, keyword clicks, impressions, and GA4 traffic metrics combined with AI search visibility.

Metti l'API al Lavoro

Progettato per pipeline di automazione e flussi di lavoro di IA

Scopri come agenzie di marketing, team SEO aziendali e ingegneri IA utilizzano la nostra API per scalare le operazioni.

Use Case #1

Monitor Brand Visibility Across AI Search Engines

Track ChatGPT, Perplexity, Gemini & Claude citations at scale

Feed buyer-intent questions into one call and get a per-engine verdict: mentioned, cited, the exact source URLs, and which competitors were recommended instead.

const res = await fetch("https://www.airanklab.com/api/v1/ai-citation-check", {
  method: "POST",
  headers: {
    "x-api-key": process.env.AIRANKLAB_API_KEY,
    "x-api-secret": process.env.AIRANKLAB_API_SECRET,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    prompt: "top enterprise marketing software",
    domain: "acmecorp.com",
    competitors: ["rival.com"]
  })
});

// Tool calls are async: poll the job for the result
const { data } = await res.json();
const job = await pollJob(data.jobId);
console.log(job.result.summary.citationRate, job.result.summary.citedIn);
Use Case #2

Automate Technical Audits & URL Pipelines

Turn full site audits into structured diagnostic feeds

Run an audit on every publish or deployment to catch schema errors, thin answers or failing Core Web Vitals before they reach production.

const start = await fetch("https://www.airanklab.com/api/v1/seo-aeo-geo-audit", {
  method: "POST",
  headers: {
    "x-api-key": process.env.AIRANKLAB_API_KEY,
    "x-api-secret": process.env.AIRANKLAB_API_SECRET,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ url: "https://example.com/blog/mcp-setup" })
});

const { data } = await start.json();          // 202 + jobId
const job = await pollJob(data.jobId);        // GET /jobs/{jobId}

if (job.result.aeo.score < 85) {
  triggerSlackAlert(`AEO score dropped: ${job.result.aeo.score}`);
}
Use Case #3

Audit Backlinks & Track AI Crawler Visits

Link authority on demand, bot traffic in real time

Pull any domain’s backlink profile for competitive research, and read your own GPTBot / ClaudeBot / PerplexityBot visit logs to confirm the AI engines are actually crawling you.

# Backlink profile of any domain (async, 15 credits)
curl -X POST "https://www.airanklab.com/api/v1/backlinks-overview" \
  -H "x-api-key: YOUR_KEY" -H "x-api-secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"target":"competitor.com","includeHistory":true}'

# AI bot visits to your own domain (free, returns immediately)
curl "https://www.airanklab.com/api/v1/tracking/stats?domain=example.com" \
  -H "x-api-key: YOUR_KEY" -H "x-api-secret: YOUR_SECRET"
Model Context Protocol (MCP)

Interroga AI Rank Lab da qualsiasi assistente IA

In addition to REST API endpoints, AI Rank Lab provides a hosted Server MCP at POST /api/v1/mcp. Connect Claude Code, Cursor, Windsurf, or custom LangChain/CrewAI agents in seconds.

Configurazione JSON Anthropic MCPHTTP / SSE in streaming
{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}
Esploratore API Interattivo

Esplora le Categorie di Endpoint API Principali

Ispeziona i payload delle richieste e le strutture delle risposte JSON in tempo reale.

AI Search Visibility (AEO)

Ask ChatGPT, Perplexity, Claude and Gemini the same question at once and see which of them cite your domain. 100 credits per engine.

POST /ai-citation-check

Corpo della Richiesta (JSON):

{
  "prompt": "best AEO rank tracker",
  "domain": "airanklab.com",
  "engines": ["ChatGPT", "Perplexity", "Claude", "Gemini"],
  "competitors": ["rival.com"]
}

Output della Risposta (200 OK):

// GET /jobs/{jobId} once the job completes
{
  "success": true,
  "data": {
    "status": "completed",
    "result": {
      "domain": "airanklab.com",
      "summary": {
        "citedIn": ["ChatGPT", "Perplexity"],
        "mentionedIn": ["ChatGPT", "Perplexity", "Gemini"],
        "notFoundIn": ["Claude"],
        "citationRate": 50,
        "visibilityScore": 63,
        "competitors": [
          { "domain": "rival.com", "citedIn": ["Gemini"], "citationRate": 25 }
        ]
      },
      "results": [
        {
          "engine": "ChatGPT",
          "cited": true,
          "citedUrls": ["https://airanklab.com/seo-aeo-geo-audit-tool"],
          "mentionPosition": 1,
          "sentiment": "positive"
        }
      ]
    }
  }
}
Soluzioni Personalizzate

Integra i dati SEO e AEO nel tuo stack

Che tu stia costruendo pipeline di reporting per clienti o squadre di agenti IA autonomi, la nostra API si adatta al tuo stack.

Agenzie SEO e di Marketing

Automatizza audit in white-label per i clienti, traccia la quota di voce delle citazioni AEO e genera dashboard di reporting PDF / Data Studio automatizzati senza sforzo.

Team SEO Aziendali

Monitora i cambiamenti nell'universo delle keyword, confronta le lacune nelle citazioni degli LLM dei competitor in 54 mercati di ricerca su desktop e mobile, e alimenta le pipeline interne di data science.

Sviluppatori e Ingegneri AI

Alimenta le pipeline RAG con risultati di ricerca web in tempo reale, analizza il traffico dei crawler bot AI (GPTBot, ClaudeBot) e connetti gli strumenti a LangChain o CrewAI tramite MCP.

FAQ per Sviluppatori

Domande Frequenti

Guida tecnica su autenticazione, crediti, endpoint e limiti di frequenza.

The AI Rank Lab REST API provides programmatic access to our entire search engine & AI intelligence platform. You can programmatically fetch keyword research, SERP rankings, Google AI Overview features, AI search brand citations (ChatGPT, Gemini, Perplexity, Claude), AI bot crawler logs, technical site audits, and Google Analytics 4 / Search Console metrics.

Inizia a costruire oggi stesso con l'API SEO & AEO di AI Rank Lab

Crea il tuo account in pochi secondi. Include 100 crediti gratuiti per eseguire ricerche SERP in tempo reale, controlli di visibilità del brand AEO e analisi dei log delle visite dei bot.