واجهة API للظهور في الذكاء الاصطناعي

إجابات الذكاء الاصطناعي، كبيانات. واجهة واحدة.

وصول برمجي إلى كيفية ذكر ChatGPT وGoogle AI Overviews وGemini وPerplexity وClaude و10 محركات أخرى لأي علامة تجارية وترتيبها والاستشهاد بها، وهي بيانات يومية نفسها التي تشغّل تطبيق GeoGen.

احصل على مفتاح API اقرأ التوثيق

أنشئ مفتاح مساحة العمل من التطبيق: الإعدادات ← مساحات العمل ← مساحة عملك ← مفاتيح API.

# Visibility trend for one tracked brand, last 7 days
$ curl "https://api.geogen.io/v1/trends/visibility?entityId=$ENTITY_ID&period=7d" \
    -H "Authorization: Bearer $GEOGEN_API_KEY"

{
  "success": true,
  "data": [
    { "date": "2026-10-05", "score": 71.2 },
    { "date": "2026-10-06", "score": 73.9 },
    { "date": "2026-10-07", "score": 78.4 }
  ]
}

import os, requests

r = requests.get(
    "https://api.geogen.io/v1/competitors",
    params={"entityId": os.environ["ENTITY_ID"]},
    headers={"Authorization": f"Bearer {os.environ['GEOGEN_API_KEY']}"},
)
for row in r.json()["data"]:
    print(row["rank"], row["name"], row["visibility"])

$ npm install -g @geogenio/cli
$ geogen login
$ geogen competitors --entity $ENTITY_ID --json | jq '.[0]'

ما الذي يمكنك الاستعلام عنه

الكيانات والمطالبات

أنشئ العلامات المتتبَّعة والمطالبات التي تُشغَّل عليها وأدرها.
- GET/entities
- POST/entities
- PATCH/entities
- GET/entities/check-domain
- GET/entities/prompts
- POST/entities/addprompt
- PATCH/entities/updateprompt
- DELETE/entities/deleteprompt
الظهور والاتجاهات

اتجاهات الظهور والمشاعر والاستشهادات اليومية لكل علامة، قابلة للتصفية بحسب النموذج والوسم والمطالبة.
- GET/trends/visibility
- GET/trends/sentiment
- GET/trends/citations
- GET/entities/tracking-status
الإجابات

كل إجابة للذكاء الاصطناعي مع حالة الذكر، إضافة إلى التفاصيل الكاملة: الذكر والاستشهادات والتفرعات.
- GET/responses
- GET/responses/details
الاستشهادات والتفرعات

النطاقات والروابط التي يستشهد بها الذكاء الاصطناعي، وعمليات البحث على الويب التي أجراها أثناء الإجابة.
- GET/entities/citations
- GET/entities/citations/details
- GET/query-fanouts
المنافسون

لوحة صدارة حصة الحضور: الظهور والذكر ومتوسط الترتيب والمشاعر لكل علامة.
- GET/competitors
الإجراءات ومساحة العمل

توصيات مولَّدة بالذكاء الاصطناعي، ولوحة المهام، والنماذج والأعضاء والوسوم ومجموعات النطاقات.
- GET/entities/actions
- POST/entities/actions/update-status
- GET/models
- GET/workspace
- GET/domain-groups

مبنية كالبنية التحتية

الواجهة في مرحلة تجريبية (beta): قد تتطور نقاط الوصول، وتُعلن التغييرات في سجل التحديثات.

العنوان الأساسي: https://api.geogen.io/v1
المصادقة: مفتاح مساحة العمل (wsk_…) عبر Authorization: Bearer أو X-API-Key
الصيغة: JSON مع ترقيم الصفحات بـ total / limit / offset
حدود المعدل: 100 قراءة في الدقيقة و20 كتابة في الدقيقة لكل مفتاح؛ وأعلى عند الطلب
الحداثة: تُعاد كل مطالبة يوميًا؛ استعلم دوريًا عن /entities/tracking-status لمعرفة البيانات الجديدة
المواصفات: OpenAPI 3 على docs.geogen.io/openapi.json

ماذا تبني الفرق عليها

المنصات ومزودو الاستضافة
أرِ العملاء كيف ترى محركات الذكاء الاصطناعي مواقعهم، داخل لوحة التحكم أو منتج SaaS لديك.
الوكالات
غذِّ لوحات العملاء والتقارير الشهرية بالظهور والاستشهادات والمنافسين.
مزودو أدوات السيو
أضف وحدة للظهور في الذكاء الاصطناعي دون بناء خط لجمع الإجابات.
فرق البيانات وBI
جدول عمليات السحب إلى مستودع بياناتك واربط الظهور في الذكاء الاصطناعي بالزيارات والإيرادات.

البيانات نفسها عبر ثلاث واجهات

أداة geogen CLI

كل إمكانيات API من الطرفية، مع الخيار --json في كل أمر للسكربتات وCI.

البيانات نفسها عبر ثلاث واجهات

خادم MCP

دع Claude وCursor وWindsurf وGitHub Copilot ووكلاء OpenAI يستعلمون عن ظهورك في الذكاء الاصطناعي بلغة بسيطة.

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

ما واجهة API للظهور في الذكاء الاصطناعي؟

تعيد واجهة API للظهور في الذكاء الاصطناعي بيانات منظمة عن كيفية إجابة مساعدات الذكاء الاصطناعي عن أسئلة سوق ما: أي العلامات تذكرها، وفي أي ترتيب وبأي نبرة، وأي المصادر تستشهد بها، وأي عمليات بحث تجريها. وتتيح واجهة GeoGen هذا لـ 15 محركًا، وتُحدَّث يوميًا.

ما المحركات التي تغطيها الواجهة؟

المحركات الـ 15 نفسها في التطبيق: ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Perplexity, Microsoft Copilot, Mistral, Brave Leo, Claude Haiku تُقرأ كما يراها المستخدمون، وDeepSeek, MiMo, Grok, Qwen, Claude Sonnet, Claude Opus تُستعلم مباشرة من النموذج. ويسردها الطلب GET /models.

كيف أصادق الطلبات؟

أنشئ مفتاح API لمساحة العمل من التطبيق (الإعدادات ← مساحات العمل ← مساحة عملك ← مفاتيح API) وأرسله بالصيغة Authorization: Bearer wsk_… أو في ترويسة X-API-Key. وأبقِ المفاتيح على جهة الخادم.

ما مدى حداثة البيانات؟

تُشغَّل كل مطالبة كل يوم على كل محرك في الباقة. استعلم دوريًا عن GET /entities/tracking-status لتعرف متى انتهى آخر فحص ومتى موعد التالي.

هل توجد واجهة API رسمية لـ Google AI Overviews؟

لا تقدم Google واجهة API عامة لإجابات AI Overviews. تقرأ GeoGen كلًّا من AI Overviews وAI Mode كما يراهما المستخدمون وتعيد النتائج، من ذكر وترتيب ومصادر مستشهَد بها، عبر واجهتها.

هل يمكنني إعادة بيع البيانات أو دمجها في منتجي؟

نعم، بموجب اتفاقية شراكة. تدمج المنصات ومزودو أدوات السيو بيانات GeoGen في منتجاتها؛ تحدَّث إلى فريق الشراكات عن شروط الحجم وإعادة التوزيع.

كن العلامة التي يوصي بها الذكاء الاصطناعي.

ابدأ تتبع ما تقوله عنك ChatGPT وGoogle AI Overviews وGemini وPerplexity و9 محركات ذكاء اصطناعي أخرى، وستظهر النتائج خلال دقائق.

ابدأ الآن احجز عرضًا تجريبيًا