REST API
Raporlama altyapınız için yapay zeka görünürlüğü ve sıralama takibi API'si
Geoptie'deki görünürlük, prompt, yanıt, alıntı ve rakip verilerini BigQuery'ye, Looker Studio'ya, müşteri panellerine veya kendi ürününüze aktarın. Tek bir bearer anahtar, HTTPS üzerinden JSON ve aylık istek kotası yok.
ChatGPT
Claude
Perplexity
Gemini
AI Overviews- AI Mode
Copilot
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"{
"data": [
{
"id": "3f2a6c1e-0b7d-4e59-9a41-2c8d5e7f9b10",
"name": "Example Brand",
"domain": "example.com",
"engines": ["chatgpt", "claude", "perplexity", "gemini"],
"country": "US"
}
],
"has_more": false,
"next_cursor": null
}v1
kararlı REST API
7
yapay zeka motoru
120/dk
istek, aylık sınır yok
$99
aylık, Profesyonel planı
Pazarlama ekipleri ve ajanslar tarafından tercih ediliyor
Yapay zeka görünürlüğü API'si nedir?
Yapay zeka görünürlüğü API'si, ChatGPT, Claude, Perplexity, Gemini ve Google'ın yapay zeka yanıtları gibi motorların bir markadan nasıl bahsettiğini ve onu nasıl alıntıladığını, kendi sistemlerinizin kullanabileceği veriler olarak döndürür. Aynı zamanda bir yapay zeka sıralama takibi API'si olarak da çalışır: takip edilen her prompt için, her motorda, her gün görünürlük ve konum.
Geoptie'nin REST API'si panelle aynı metrikleri sunar, böylece bir veri ambarındaki, bir BI panelindeki, bir müşteri raporundaki veya bir Slack uyarısındaki rakamlar ekibinizin gördüğüyle örtüşür.
İlk isteğiniz bir dakikadan kısa sürede
Panelde bir anahtar oluşturun ve bearer token olarak gönderin. GET /v1/brands anahtarın çalıştığını doğrular ve diğer tüm endpoint'lerin kullandığı marka kimliklerini döndürür.
Üç adımda kurun
- 1
Bir anahtar oluşturun
Panelde API anahtarları bölümünden, tüm çalışma alanı veya seçtiğiniz markalar için.
- 2
GET /v1/brands çağrısı yapın
Anahtarın çalıştığını doğrular ve diğer tüm endpoint'lerin kullandığı marka kimliklerini döndürür.
- 3
İhtiyacınız olan verileri çekin
Marka ve motor bazında görünürlük, promptlar, yanıtlar, alıntılar ve rakipler.
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"import os, requests
r = requests.get(
"https://api.geoptie.com/v1/brands",
headers={"Authorization": f"Bearer {os.environ['GEOPTIE_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://api.geoptie.com/v1/brands", {
headers: { Authorization: `Bearer ${process.env.GEOPTIE_API_KEY}` },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
console.log(await r.json());Endpoint kataloğu
Markalar
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Promptlar ve yanıtlar
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Alıntılar
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Rakipler
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Öneriler ve denetimler
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
İçerik
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
Güncelleme ve silme işlemleri dahil toplam 48 işlem. Tam referans API dokümantasyonunda.
Canlı ortamda raporlama için tasarlandı
API, panelinizin gösterdiği rakamları doğrudan bir veri ambarına veya müşteri raporuna aktarılabilecek bir yapıda döndürür.
Paneldeki rakamların aynısı
Yeniden birleştirilmesi gereken ham satırlar değil, önceden hesaplanmış görünürlük, konum ve ses payı. Böylece müşteri raporu ekibinizin gördüğüyle örtüşür.
Okuma ve yazma
Aynı API üzerinden promptları takip edin, konuları ve rakipleri yönetin, öneri kuyruğunu işleyin, denetim çalıştırın ve içerik üretin.
Çalışma alanı ve marka bazlı anahtarlar
Bir müşteriye, bir panele veya bir iç ekibe yalnızca kendi markasına erişen bir anahtar verin. İptal işlemi bir dakika içinde geçerli olur.
Hızı ayarlı, öngörülebilir işler
Her yanıtta cursor tabanlı sayfalama, ISO 8601 tarihler ve rate limit başlıkları. Böylece zamanlanmış bir iş 429 hatasına takılmadan kendi hızını ayarlar.
Üzerinde işlem yapılabilir hatalar
Sabit bir hata koduyla standart HTTP durum kodları ve destek ekibinin izleyebilmesi için her yanıtta bir X-Request-Id.
Kararlı sürümleme
v1 kararlıdır. Yeni alanlar önceden bildirim yapılmadan eklenir, geriye dönük uyumsuz değişiklikler ise 90 gün önceden bildirilerek /v2 olarak yayınlanır.
Ekiplerin bu API ile geliştirdikleri
Müşteri panelleri
Ajanslar her müşterinin yapay zeka görünürlüğünü, müşteri başına markaya özel bir anahtarla Looker Studio'ya veya kendi portallarına aktarır.
Veri ambarı senkronizasyonu
Her gece çalışan bir iş, görünürlük, alıntı ve rakip verilerini SEO ve analitik verilerinin yanına, BigQuery'ye veya Snowflake'e kopyalar.
Uyarılar
Zamanlanmış bir kontrol, öncelikli bir prompt bir motorda düştüğünde Slack'e veya e-postaya bildirim gönderir.
Yapay zeka asistanları
Aynı anahtar, Claude Code, Cursor ve Codex için Geoptie MCP sunucusunu da çalıştırır.
Yapay zeka görünürlüğü API'si SSS
Geoptie API'si hangi verileri döndürür?
Hangi planlar API erişimi içerir?
Kimlik doğrulama nasıl çalışır?
API istek limitleri nelerdir?
API üzerinden rakip verilerini çekebilir miyim?
Bir müşteriye yalnızca kendi markası için API erişimi verebilir miyim?
API hangi yapay zeka motorlarını kapsar?
Bir MCP sunucusu da var mı?
Yapay zeka görünürlüğünü diğer verilerinizin yanına koyun
Profesyonel ile başlayın, bir anahtar oluşturun ve ilk isteğiniz markalarınızı bir dakikadan kısa sürede döndürsün.
Başlayın