# 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
-
回答
言及の有無つきのAI回答をすべて取得でき、言及、引用、ファンアウトの詳細も確認できます。
- GET/responses
- GET/responses/details
-
引用とファンアウト
AIが引用するドメインとURL、そして回答中に実行したウェブ検索を取得します。
- GET/entities/citations
- GET/entities/citations/details
- GET/query-fanouts
-
競合
シェア・オブ・ボイスのランキング。ブランドごとの可視性、言及数、平均順位、センチメントです。
- GET/competitors
-
アクションとワークスペース
AIが生成する推奨アクション、タスクボード、モデル、メンバー、タグ、ドメイングループです。
- GET/entities/actions
- POST/entities/actions/update-status
- GET/models
- GET/workspace
- GET/domain-groups
インフラとして設計
APIはベータ版です。エンドポイントは変更される場合があり、変更は更新履歴でお知らせします。
- ベースURL
- 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)
どんな使い方をされているか
プラットフォーム・ホスティング事業者
AIエンジンが顧客のサイトをどう見ているかを、自社のコントロールパネルやSaaS内で表示できます。
代理店
クライアントのダッシュボードや月次レポートに、可視性、引用、競合のデータを反映できます。
SEOツールベンダー
回答のスクレイピング基盤を作らずに、AI可視性モジュールを追加できます。
データ・BIチーム
データウェアハウスへ定期的に取り込み、AI可視性をトラフィックや売上と結合できます。
よくある質問
AI可視性APIとは何ですか?
AI可視性APIは、市場に関する質問にAIアシスタントがどう答えるかを、構造化データとして返します。どのブランドが、どの順位と語り口で言及されるか、どのソースが引用されるか、どの検索が実行されるかがわかります。GeoGenのAPIは、15のエンジンについてこのデータを毎日更新して提供します。
APIはどのエンジンに対応していますか?
アプリと同じ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 をポーリングすると、最新のチェックがいつ完了し、次回がいつ予定されているかを確認できます。
Google AI Overviewsの公式APIはありますか?
Googleは、AI Overviewsの回答に関する公開APIを提供していません。GeoGenは、AI OverviewsとAI Modeをユーザーが見るとおりに読み取り、言及、順位、引用元といった結果を自社のAPIで返します。
データを再販したり、自社製品に組み込んだりできますか?
はい。パートナー契約のもとで可能です。プラットフォームやSEOツールベンダーが、自社製品にGeoGenのデータを組み込んでいます。ボリュームや再配布の条件については、パートナーシップ担当にご相談ください。