Developer API v1 & Anthropic MCP Endpoint

SEO & AEO API: أتمتة سير عمل البحث والذكاء الاصطناعي الخاص بك

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. واجهة REST API واحدة وخادم MCP واحد، بنفس المفتاح.

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"]
  }'
مجموعات البيانات الأساسية

محرك البيانات الذي ستعمل عليه سير عملك

اجمع بيانات SERP التقليدية من Google مع مقاييس الاقتباس لمحركات الذكاء الاصطناعي في الوقت الفعلي وسجلات برامج الزحف.

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.

ابدأ باستخدام الواجهة البرمجية (API)

مصمم لخطوط أنابيب الأتمتة وسير عمل الذكاء الاصطناعي

اكتشف كيف تستخدم وكالات التسويق، وفرق تحسين محركات البحث للشركات، ومهندسو الذكاء الاصطناعي واجهة برمجة التطبيقات الخاصة بنا لتوسيع نطاق عملياتهم.

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)

استعلم AI Rank Lab من داخل أي مساعد ذكاء اصطناعي

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

إعداد JSON لـ Anthropic MCPHTTP / SSE قابلة للتدفق
{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}
مستكشف الواجهة البرمجية (API) التفاعلي

استكشف فئات نقاط نهاية الواجهة البرمجية (API) الأساسية

افحص حمولات الطلبات الفعلية وهياكل استجابات JSON الحية.

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

نص الطلب (JSON):

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

مخرجات الاستجابة (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"
        }
      ]
    }
  }
}
حلول مخصصة

اجلب بيانات SEO و AEO إلى نظامك

سواء كنت تبني خطوط أنابيب لإعداد تقارير العملاء أو فرق وكلاء ذكاء اصطناعي مستقلة، فإن واجهة برمجة التطبيقات الخاصة بنا تتناسب مع نظامك.

وكالات تحسين محركات البحث والتسويق

أتمتة عمليات تدقيق العملاء ذات العلامة البيضاء، وتتبع حصة الصوت من اقتباسات AEO، وإنشاء لوحات معلومات تقارير PDF / Data Studio تلقائية دون عناء.

فرق تحسين محركات البحث للشركات

راقب تغيرات عالم الكلمات المفتاحية، وقارن فجوات استشهادات نماذج اللغة الكبيرة (LLM) للمنافسين عبر 54 سوق بحث على أجهزة سطح المكتب والجوال، وزوّد مسارات علم البيانات الداخلية.

المطورون ومهندسو الذكاء الاصطناعي

زوّد مسارات RAG بنتائج بحث الويب في الوقت الفعلي، ودقّق حركة مرور برامج زحف بوتات الذكاء الاصطناعي (GPTBot، ClaudeBot)، واربط الأدوات بـ LangChain أو CrewAI عبر MCP.

الأسئلة الشائعة للمطورين

الأسئلة الشائعة

إرشادات فنية حول المصادقة، الرصيد، نقاط النهاية، وحدود المعدل.

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.

ابدأ البناء باستخدام واجهة برمجة تطبيقات SEO و AEO الخاصة بـ AI Rank Lab اليوم

أنشئ حسابك في ثوانٍ. يتضمن 100 رصيد مجاني لإجراء عمليات بحث مباشرة في صفحات نتائج محركات البحث (SERP)، وفحوصات رؤية العلامة التجارية لتحسين تجربة البحث المدعومة بالذكاء الاصطناعي (AEO)، وتحليلات سجل زيارات البوتات.