# 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를 폴링하여 확인
- 스펙
- docs.geogen.io/openapi.json의 OpenAPI 3
팀들이 만드는 것
플랫폼 및 호스팅 사업자
컨트롤 패널이나 SaaS 안에서 AI 엔진이 고객 사이트를 어떻게 보는지 보여 주십시오.
대행사
고객사 대시보드와 월간 리포트를 가시성, 인용, 경쟁사 데이터로 채우십시오.
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 키를 만들고(Settings → Workspaces → 해당 워크스페이스 → API Keys) Authorization: Bearer wsk_… 또는 X-API-Key 헤더로 전송하십시오. 키는 서버 측에서만 보관하십시오.
데이터는 얼마나 최신인가요?
모든 프롬프트는 요금제에 포함된 모든 엔진에서 매일 실행됩니다. GET /entities/tracking-status를 폴링하면 최근 점검이 끝난 시점과 다음 점검 예정 시각을 알 수 있습니다.
공식 Google AI 개요 API가 있나요?
Google은 AI 개요 답변에 대한 공개 API를 제공하지 않습니다. GeoGen은 AI 개요와 AI Mode를 사용자가 보는 방식 그대로 읽고, 언급, 순위, 인용 출처를 API로 반환합니다.
데이터를 재판매하거나 제품에 내장할 수 있나요?
네, 파트너 계약에 따라 가능합니다. 플랫폼과 SEO 도구 업체가 GeoGen 데이터를 자사 제품에 내장하고 있습니다. 물량과 재배포 조건은 파트너십 팀에 문의하십시오.