REST API
API visibilitas AI dan pelacakan peringkat untuk stack pelaporan Anda
Tarik data visibilitas, prompt, jawaban, kutipan, dan kompetitor dari Geoptie ke BigQuery, Looker Studio, dasbor klien, atau produk Anda sendiri. Satu bearer key, JSON melalui HTTPS, dan tanpa kuota permintaan bulanan.
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
REST API yang stabil
7
mesin AI tercakup
120/menit
permintaan, tanpa batas bulanan
$99
per bulan, paket Profesional
Dipercaya oleh tim pemasaran dan agensi
Apa itu API visibilitas AI?
API visibilitas AI mengembalikan cara mesin AI seperti ChatGPT, Claude, Perplexity, Gemini, dan jawaban AI Google menyebut dan mengutip sebuah merek, dalam bentuk data yang bisa dipakai sistem Anda sendiri. API ini juga berfungsi sebagai API pelacak peringkat AI: visibilitas dan posisi untuk setiap prompt yang dilacak, di setiap mesin, setiap hari.
REST API Geoptie menyajikan metrik yang sama dengan dasbor, sehingga angka di warehouse, dasbor BI, laporan klien, atau peringatan Slack cocok dengan yang dilihat tim Anda.
Permintaan pertama Anda dalam kurang dari semenit
Buat kunci di dasbor dan kirimkan sebagai bearer token. GET /v1/brands membuktikan kunci berfungsi dan mengembalikan ID merek yang digunakan semua endpoint lainnya.
Siap dalam tiga langkah
- 1
Buat kunci
Di dasbor pada menu kunci API, untuk seluruh workspace atau untuk merek tertentu.
- 2
Panggil GET /v1/brands
Ini membuktikan kunci berfungsi dan mengembalikan ID merek yang digunakan semua endpoint lainnya.
- 3
Tarik data yang Anda butuhkan
Visibilitas, prompt, jawaban, kutipan, dan kompetitor, per merek dan per mesin.
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());Katalog endpoint
Merek
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Prompt dan jawaban
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Kutipan
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Kompetitor
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Rekomendasi dan audit
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Konten
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
Total 48 operasi, termasuk pembaruan dan penghapusan. Referensi lengkap ada di dokumentasi API.
Dibuat untuk pelaporan produksi
API mengembalikan angka yang ditampilkan dasbor Anda, dalam format yang langsung masuk ke warehouse atau laporan klien.
Angka yang sama dengan dasbor
Visibilitas, posisi, dan pangsa suara yang sudah dihitung, bukan baris mentah yang harus dirangkai ulang, sehingga laporan klien cocok dengan yang dilihat tim Anda.
Baca dan tulis
Lacak prompt, kelola topik dan kompetitor, kerjakan antrean rekomendasi, jalankan audit, dan buat konten melalui API yang sama.
Kunci per workspace dan per merek
Beri klien, dasbor, atau tim internal kunci yang hanya menjangkau merek mereka sendiri. Pencabutan berlaku dalam satu menit.
Job yang teratur dan dapat diprediksi
Paginasi berbasis cursor, tanggal ISO 8601, dan header rate limit di setiap respons, sehingga job terjadwal bisa mengatur kecepatannya sendiri tanpa terkena 429.
Error yang bisa ditindaklanjuti
Kode status HTTP standar dengan kode error yang stabil, serta X-Request-Id di setiap respons agar tim dukungan bisa menelusurinya.
Versi yang stabil
v1 sudah stabil. Field baru ditambahkan tanpa pemberitahuan, sedangkan perubahan yang tidak kompatibel dirilis sebagai /v2 dengan pemberitahuan 90 hari sebelumnya.
Apa yang dibangun tim dengan API ini
Dasbor klien
Agensi menyalurkan visibilitas AI setiap klien ke Looker Studio atau portal mereka sendiri, dengan satu kunci per merek untuk tiap klien.
Sinkronisasi warehouse
Job malam hari menyalin data visibilitas, kutipan, dan kompetitor ke BigQuery atau Snowflake, berdampingan dengan data SEO dan analitik.
Peringatan
Pengecekan terjadwal mengirim notifikasi ke Slack atau email saat prompt prioritas turun di suatu mesin.
Asisten AI
Kunci yang sama menjalankan server MCP Geoptie untuk Claude Code, Cursor, dan Codex.
FAQ API visibilitas AI
Data apa yang dikembalikan API Geoptie?
Paket mana yang menyertakan akses API?
Bagaimana cara kerja autentikasinya?
Berapa batas rate API?
Bisakah saya menarik data kompetitor melalui API?
Bisakah saya memberi klien akses API hanya ke merek mereka?
Mesin AI apa saja yang dicakup API?
Apakah ada server MCP juga?
Satukan visibilitas AI dengan data Anda lainnya
Mulai dengan paket Profesional, buat kunci, dan permintaan pertama Anda mengembalikan daftar merek dalam kurang dari semenit.
Mulai