GeoptieGeoptie Logo

REST API

리포팅 환경을 위한 AI 가시성 및 순위 추적 API

Geoptie의 가시성, 프롬프트, 답변, 인용, 경쟁사 데이터를 BigQuery, Looker Studio, 고객용 대시보드 또는 자체 제품으로 가져오세요. bearer 키 하나, HTTPS 기반 JSON, 월 요청 할당량 없음.

시작하기API 문서 보기
데이터 출처
  • ChatGPT
  • Claude
  • Perplexity
  • Gemini
  • AI Overviews
  • AI Mode
  • Copilot
curl -sS "https://api.geoptie.com/v1/brands" \
  -H "Authorization: Bearer $GEOPTIE_API_KEY"
응답 · 200
{
  "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

  • 7

    지원 AI 엔진

  • 120/분

    요청, 월 한도 없음

  • $99

    월 요금, 프로페셔널 플랜

마케팅 팀과 에이전시가 신뢰하는 솔루션

AKQA
Amgen
ARM Worldwide
Mazda
Capgemini
Decathlon
Dentsu
HCLTech
HSAD
Infineon
Redbrain
Verizon
Webrepublic
Wpromote
AKQA
Amgen
ARM Worldwide
Mazda
Capgemini
Decathlon
Dentsu
HCLTech
HSAD
Infineon
Redbrain
Verizon
Webrepublic
Wpromote

AI 가시성 API란 무엇인가요?

AI 가시성 API는 ChatGPT, Claude, Perplexity, Gemini, Google AI 답변 같은 AI 엔진이 브랜드를 어떻게 언급하고 인용하는지를 자체 시스템에서 활용할 수 있는 데이터로 제공합니다. AI 순위 추적 API로도 쓸 수 있어, 추적 중인 모든 프롬프트의 가시성과 순위를 엔진별로 매일 확인할 수 있습니다.

Geoptie REST API는 대시보드와 동일한 지표를 제공하므로 웨어하우스, BI 대시보드, 고객 리포트, Slack 알림의 수치가 팀이 보는 수치와 일치합니다.

1분 안에 첫 요청 보내기

대시보드에서 키를 만들고 bearer 토큰으로 보내세요. GET /v1/brands로 키가 작동하는지 확인하고, 다른 모든 엔드포인트에서 쓰는 브랜드 ID를 받을 수 있습니다.

3단계로 설정하기

  1. 1

    키 만들기

    대시보드의 API 키 메뉴에서 워크스페이스 전체 또는 선택한 브랜드용으로 만듭니다.

  2. 2

    GET /v1/brands 호출하기

    키가 작동하는지 확인하고, 다른 모든 엔드포인트에서 쓰는 브랜드 ID를 반환합니다.

  3. 3

    필요한 데이터 가져오기

    가시성, 프롬프트, 답변, 인용, 경쟁사 데이터를 브랜드별, 엔진별로 가져옵니다.

curl -sS "https://api.geoptie.com/v1/brands" \
  -H "Authorization: Bearer $GEOPTIE_API_KEY"

엔드포인트 목록

브랜드

  • GET/v1/brands
  • POST/v1/brands
  • GET/v1/brands/{id}
  • GET/v1/brands/{id}/visibility

프롬프트와 답변

  • GET/v1/brands/{id}/prompts
  • POST/v1/brands/{id}/prompts
  • GET/v1/prompts/{id}/responses
  • GET/v1/prompts/{id}/mentions

인용

  • GET/v1/brands/{id}/citations
  • GET/v1/brands/{id}/citations/urls
  • GET/v1/brands/{id}/citations/domains
  • GET/v1/brands/{id}/citations/trends

경쟁사

  • GET/v1/brands/{id}/competitors
  • GET/v1/brands/{id}/competitors/trends
  • POST/v1/brands/{id}/tracked-competitors
  • POST/v1/brands/{id}/ignored-competitors

추천 사항과 감사

  • GET/v1/brands/{id}/recommendations
  • POST/v1/brands/{id}/recommendations/generate
  • POST/v1/audit-reports
  • GET/v1/audit-reports/{id}

콘텐츠

  • POST/v1/brands/{id}/generations
  • POST/v1/brands/{id}/generations/{generationId}/draft
  • POST/v1/brands/{id}/optimizations
  • GET/v1/brands/{id}/topics

수정 및 삭제를 포함해 총 48개 작업을 제공합니다. 전체 레퍼런스는 API 문서에서 확인하세요.

실무 리포팅을 위한 설계

API는 대시보드에 표시되는 수치를 웨어하우스나 고객 리포트에 바로 넣을 수 있는 형태로 반환합니다.

대시보드와 같은 수치

다시 조합해야 하는 원시 데이터가 아니라 미리 계산된 가시성, 순위, 보이스 점유율을 제공하므로 고객 리포트가 팀이 보는 수치와 일치합니다.

읽기와 쓰기

같은 API로 프롬프트를 추적하고, 토픽과 경쟁사를 관리하고, 추천 사항을 처리하고, 감사를 실행하고, 콘텐츠를 생성하세요.

워크스페이스 키와 브랜드 범위 키

고객, 대시보드, 사내 팀에 해당 브랜드에만 접근하는 키를 발급하세요. 키 취소는 1분 안에 적용됩니다.

속도가 조절되는 예측 가능한 작업

모든 응답에 커서 페이지네이션, ISO 8601 날짜, rate limit 헤더가 포함되어 예약 작업이 429 없이 스스로 속도를 조절합니다.

바로 대응할 수 있는 오류

표준 HTTP 상태 코드와 안정적인 오류 코드를 제공하며, 모든 응답에 지원팀이 추적할 수 있는 X-Request-Id가 포함됩니다.

안정적인 버전 관리

v1은 안정 버전입니다. 새 필드는 사전 공지 없이 추가되며, 호환성을 깨는 변경은 90일 전에 공지한 뒤 /v2로 출시됩니다.

팀들이 API로 만드는 것

고객용 대시보드

에이전시는 고객마다 브랜드 범위 키를 발급해 각 고객의 AI 가시성 데이터를 Looker Studio나 자체 포털로 보냅니다.

웨어하우스 동기화

야간 작업이 가시성, 인용, 경쟁사 데이터를 BigQuery나 Snowflake로 복사해 SEO 및 분석 데이터와 함께 둡니다.

알림

중요한 프롬프트가 특정 엔진에서 하락하면 예약된 점검이 Slack이나 이메일로 알려 줍니다.

AI 어시스턴트

같은 키로 Claude Code, Cursor, Codex용 Geoptie MCP 서버도 사용할 수 있습니다.

Professional과 Enterprise에 포함

가장 인기 있는

프로페셔널

$99/월

  • 브랜드 10개와 프롬프트 100개
  • REST API 및 MCP 서버
  • 화이트라벨 리포트
  • 팀원 무제한
시작하기

엔터프라이즈

$399/월

  • 무제한 브랜드와 프롬프트 400개
  • REST API 및 MCP 서버
  • 화이트라벨 리포트
  • 팀원 무제한
시작하기

모든 플랜 비교

AI 가시성 API FAQ

Geoptie API는 어떤 데이터를 반환하나요?
대시보드에 표시되는 모든 데이터입니다. 시간별 및 엔진별 브랜드 가시성, 추적 프롬프트, 엔진이 반환한 답변 전문, 답변에 언급된 브랜드, 인용된 페이지와 도메인, 경쟁사 보이스 점유율, 토픽, 추천 사항, 감사 리포트, 생성된 콘텐츠를 제공합니다.
어떤 플랜에 API 액세스가 포함되나요?
프로페셔널(월 $99)과 엔터프라이즈(월 $399)입니다. 하나의 키로 REST API와 MCP 서버를 모두 사용할 수 있습니다. Starter에는 API 액세스가 포함되지 않습니다.
인증은 어떻게 하나요?
모든 요청은 Authorization 헤더에 API 키를 bearer 토큰으로 담아 보냅니다. 키는 대시보드에서 만들며, 워크스페이스 전체 또는 선택한 브랜드를 대상으로 하고, 한 번만 표시됩니다. 통합마다 키를 따로 만들어 두면 다른 통합에 영향을 주지 않고 취소할 수 있습니다.
API 요청 한도는 어떻게 되나요?
지원되는 모든 플랜에서 키당 분당 120회 요청이며 월간 요청 할당량은 없습니다. 일부 엔드포인트에는 별도 한도가 있습니다. 답변 전문 조회는 시간당 600회로 제한되고, 모델을 실행하는 엔드포인트는 분당 몇 회, 동시 2개까지 허용됩니다.
API로 경쟁사 데이터를 가져올 수 있나요?
네. 경쟁사 엔드포인트는 같은 프롬프트에서 경쟁사와 비교한 브랜드 성과, 시간에 따른 경쟁사 추이, 개별 경쟁사 상세 정보를 반환합니다. API로 경쟁사를 추적, 수정, 무시할 수도 있습니다.
고객에게 해당 브랜드에만 API 액세스를 줄 수 있나요?
네. 브랜드 범위 키는 선택한 브랜드에만 접근하며, 범위 밖의 모든 요청은 404를 반환합니다. 고객용 대시보드, 외부 협력사, 한 브랜드의 데이터만 필요한 사내 팀에 적합합니다.
API는 어떤 AI 엔진을 지원하나요?
ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews, Google AI Mode, Microsoft Copilot입니다. 각 브랜드는 7개 중 원하는 4개를 추적하며, 현재 선택은 브랜드 객체에 포함되어 반환됩니다.
MCP 서버도 있나요?
네. Geoptie MCP 서버는 같은 키와 같은 한도를 사용하며, Claude Code, Cursor, Codex 및 기타 MCP 클라이언트가 대화 중에 데이터를 조회하고 작업할 수 있게 해 줍니다.

AI 가시성을 다른 데이터와 나란히 두세요

Professional로 시작해 키를 만들면 1분 안에 첫 요청으로 브랜드 목록을 받을 수 있습니다.

시작하기