REST API
API keterlihatan AI dan penjejakan kedudukan untuk sistem pelaporan anda
Tarik data keterlihatan, prompt, jawapan, petikan dan pesaing daripada Geoptie ke BigQuery, Looker Studio, papan pemuka pelanggan atau produk anda sendiri. Satu bearer key, JSON melalui HTTPS, dan tiada 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
enjin AI diliputi
120/minit
permintaan, tiada had bulanan
$99
sebulan, pelan Profesional
Dipercayai oleh pasukan pemasaran dan agensi
Apakah API keterlihatan AI?
API keterlihatan AI memulangkan cara enjin AI seperti ChatGPT, Claude, Perplexity, Gemini dan jawapan AI Google menyebut dan memetik sesuatu jenama, sebagai data yang boleh digunakan oleh sistem anda sendiri. Ia juga berfungsi sebagai API penjejak kedudukan AI: keterlihatan dan kedudukan bagi setiap prompt yang dijejak, pada setiap enjin, setiap hari.
REST API Geoptie menyampaikan metrik yang sama seperti papan pemuka, jadi angka dalam gudang data, papan pemuka BI, laporan pelanggan atau amaran Slack sepadan dengan apa yang dilihat pasukan anda.
Permintaan pertama anda dalam masa kurang seminit
Cipta kunci dalam papan pemuka dan hantar sebagai bearer token. GET /v1/brands membuktikan kunci berfungsi dan memulangkan ID jenama yang digunakan oleh setiap endpoint lain.
Sedia dalam tiga langkah
- 1
Cipta kunci
Dalam papan pemuka di bawah kunci API, untuk seluruh ruang kerja atau untuk jenama terpilih.
- 2
Panggil GET /v1/brands
Ia membuktikan kunci berfungsi dan memulangkan ID jenama yang digunakan oleh setiap endpoint lain.
- 3
Tarik data yang anda perlukan
Keterlihatan, prompt, jawapan, petikan dan pesaing, mengikut jenama dan enjin.
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
Jenama
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Prompt dan jawapan
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Petikan
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Pesaing
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Cadangan dan audit
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Kandungan
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
Sejumlah 48 operasi, termasuk kemas kini dan pemadaman. Rujukan penuh tersedia dalam dokumentasi API.
Dibina untuk pelaporan produksi
API memulangkan angka yang dipaparkan papan pemuka anda, dalam bentuk yang terus sesuai untuk gudang data atau laporan pelanggan.
Angka yang sama seperti papan pemuka
Keterlihatan, kedudukan dan bahagian suara yang telah dikira terlebih dahulu, bukan baris mentah untuk dicantum semula, jadi laporan pelanggan sepadan dengan apa yang dilihat pasukan anda.
Baca dan tulis
Jejak prompt, urus topik dan pesaing, uruskan baris gilir cadangan, jalankan audit dan jana kandungan melalui API yang sama.
Kunci ruang kerja dan kunci mengikut jenama
Beri pelanggan, papan pemuka atau pasukan dalaman kunci yang hanya mencapai jenama mereka sendiri. Pembatalan berkuat kuasa dalam masa seminit.
Tugas yang teratur dan boleh dijangka
Penomboran halaman berasaskan cursor, tarikh ISO 8601 dan pengepala had kadar pada setiap respons, jadi tugas berjadual boleh mengatur kadarnya sendiri tanpa terkena 429.
Ralat yang boleh diambil tindakan
Kod status HTTP standard dengan kod ralat yang stabil, serta X-Request-Id pada setiap respons untuk dijejak oleh pasukan sokongan.
Versi yang stabil
v1 adalah stabil. Medan baharu ditambah tanpa notis, dan perubahan yang tidak serasi dikeluarkan sebagai /v2 dengan notis 90 hari.
Apa yang dibina pasukan dengannya
Papan pemuka pelanggan
Agensi menyalurkan keterlihatan AI setiap pelanggan ke Looker Studio atau portal mereka sendiri, dengan satu kunci mengikut jenama bagi setiap pelanggan.
Penyegerakan gudang data
Tugas setiap malam menyalin data keterlihatan, petikan dan pesaing ke BigQuery atau Snowflake, bersebelahan data SEO dan analitik.
Amaran
Semakan berjadual menghantar mesej ke Slack atau e-mel apabila prompt keutamaan menurun pada sesuatu enjin.
Pembantu AI
Kunci yang sama menggerakkan pelayan MCP Geoptie untuk Claude Code, Cursor dan Codex.
Soalan lazim API keterlihatan AI
Apakah data yang dipulangkan oleh API Geoptie?
Pelan manakah yang menyertakan akses API?
Bagaimanakah pengesahan berfungsi?
Apakah had kadar API?
Bolehkah saya menarik data pesaing melalui API?
Bolehkah saya memberi pelanggan akses API kepada jenama mereka sahaja?
Enjin AI manakah yang diliputi API?
Adakah pelayan MCP juga tersedia?
Letakkan keterlihatan AI bersama data anda yang lain
Mula dengan Profesional, cipta kunci, dan permintaan pertama anda memulangkan jenama anda dalam masa kurang seminit.
Mula