SEO API 를 당신의 스택에
당신의 SEO 및 AI 가시성 데이터를, 깔끔한 REST 엔드포인트로.
Google Search Console, 순위, AI Tracker 데이터를 당신의 제품, 대시보드, 데이터 웨어하우스로 바로 가져오세요. 대시보드에서 발급한 Bearer 키로 인증하고 REST `/v1`을 호출하면 타입이 지정된 JSON이 반환됩니다 — SEOcrawl AI MCP를 구동하는 것과 동일한 정규 데이터 레이어입니다. GA4, 전체 사이트 감사 내보내기, 멀티테넌트 파트너 OAuth도 곧 순차 제공됩니다.
Bearer 인증 · 60 req/min · MCP와 동일한 데이터 레이어 · 스크래핑 없음
$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
-H "Authorization: Bearer sca_live_…"
{ "data": {
"period": { "from": "2026-06-09", "to": "2026-07-06" },
"metrics": {
"clicks": 2388, "impressions": 811019,
"ctr": 0.00294, "position": 22.87
},
"metrics_diff": { "clicks": 584, … }
} }
한 번 인증하고, REST를 호출하세요.
대시보드에서 Bearer 토큰을 발급해 Authorization 헤더에 넣으세요. 동일한 키가 REST API와 MCP 서버 양쪽에서 작동합니다.
베이스 URL
https://api.seocrawl.ai/v1Authorization 헤더
Authorization: Bearer sca_live_your_token_here# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
-H "Authorization: Bearer sca_live_…"
curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
-H "Authorization: Bearer sca_live_…"
// JavaScript
const res = await fetch(
"https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
{ headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();
# Python
import requests
r = requests.get(
f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
params={"range": "last_28_days"},
headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())하나의 데이터 레이어, 두 개의 표면
모든 REST 엔드포인트는 MCP 도구와 동일한 정규 레이어에서 읽어옵니다 — 그래서 당신의 대시보드와 AI 에이전트는 항상 동일한 수치를 봅니다. 아래 그룹은 v1에서 라이브 상태이며, 커버리지는 계속 확장되고 있습니다.
속성
접근 가능한 Search Console 속성을 나열합니다. 각 속성의 `id`를 모든 데이터 엔드포인트의 경로에 사용하세요.
- GET
/v1/properties라이브
Google Search Console
클릭, 노출, CTR, 평균 게재순위 — 쿼리별, 페이지별, 기간별, 기간 대비 비교로.
- GET
/v1/properties/{id}/gsc/summary라이브 - GET
/v1/properties/{id}/gsc/compare라이브 - GET
/v1/properties/{id}/gsc/top-keywords라이브 - GET
/v1/properties/{id}/gsc/top-pages라이브 - GET
/v1/properties/{id}/gsc/keywords/detail라이브 - GET
/v1/properties/{id}/gsc/pages/detail라이브
AI Tracker
ChatGPT, Claude, Gemini, Perplexity 전반에서 브랜드 언급을 모니터링하는 프롬프트를 읽어옵니다.
- GET
/v1/properties/{id}/ai-tracker/prompts라이브
작업
SEO 작업을 읽고 쓰세요 — 당신의 작업 보드를 자체 프로젝트 관리 스택에 연결할 수 있습니다.
- GET
/v1/properties/{id}/tasks라이브 - POST
/v1/properties/{id}/tasks라이브 - GET
/v1/properties/{id}/tasks/{ticketId}라이브 - PATCH
/v1/properties/{id}/tasks/{ticketId}라이브 - POST
/v1/properties/{id}/tasks/{ticketId}/comments라이브
GA4 & 색인
트래픽, AI 리퍼러, 색인 상태. 연결부는 준비되었고 REST 엔드포인트는 순차 제공 중입니다.
- GET
/v1/properties/{id}/ga4/summary곧 - GET
/v1/properties/{id}/indexation/summary곧
사이트 감사
크롤 health, 온페이지, 기술 요소, 이슈 목록 — 전체 감사 데이터셋을 REST로 노출합니다.
- GET
/v1/properties/{id}/audit/summary곧 - GET
/v1/properties/{id}/audit/issues곧
스크래퍼가 아닌 제품을 위해 설계됨
Bearer 인증, 스코프, 레이트 리밋을 갖춘 진짜 REST API — MCP와 하나의 정규 데이터 레이어를 공유하므로 수치가 어긋나는 일이 없습니다.
깔끔한 REST, 타입이 지정된 JSON
예측 가능한 리소스, 표준 HTTP verb, 타입이 지정된 JSON 응답, RFC 준수 오류(401 unauthenticated, 403 scope_required, 429 with Retry-After). HTML 스크래핑도, 깨지기 쉬운 내보내기도 없습니다.
하나의 정규 데이터 레이어
REST 엔드포인트와 MCP 도구는 동일한 프로바이더 위의 형제로, CI에서 패리티를 테스트합니다. 당신의 대시보드와 AI 에이전트는 항상 동일한 클릭, 노출, 순위를 봅니다.
셀프서비스 키
대시보드에서 Bearer 토큰을 몇 초 만에 발급하고 폐기할 수 있습니다. 동일한 sca_live_ 키가 REST API와 MCP 서버를 모두 인증합니다 — 하나의 자격 증명으로, 두 개의 표면을.
문서화된 레이트 리밋
토큰당 분당 60건, 시간당 1,000건, 명확한 429 + Retry-After 응답과 함께. REST 리밋은 MCP 사용량과 별도 풀이므로 한쪽이 다른 쪽을 고갈시키지 않습니다.
스코프 기반 접근
굵은 단위의 읽기·쓰기 스코프가 모든 엔드포인트를 통제하며, 방화벽에서 표준 step-up 응답과 함께 강제됩니다. 키에는 필요한 권한만 부여하세요.
멀티테넌트, 곧 제공
테넌트별 Google OAuth 플로우로, 파트너가 각 고객의 GSC 속성을 하나의 계정 아래 연결할 수 있습니다 — 엄격한 데이터 격리와 함께. 현재 활발히 개발 중이며, 조기 액세스는 문의해 주세요.
3단계로 시작
제로에서 첫 인증 호출까지, 단 몇 분.
헤더 전송
모든 요청에서 `Authorization: Bearer sca_live_…`를 `https://api.seocrawl.ai/v1`으로 전달하세요. 동일한 키는 MCP 서버에서도 작동합니다.
데이터 가져오기
`GET /v1/properties`를 호출해 속성 `id`를 얻은 뒤, `/v1/properties/{id}/…`를 호출해 GSC 성과, AI Tracker 프롬프트, 작업을 가져오세요 — 그리고 JSON을 당신의 제품, 대시보드, 웨어하우스로 바로 흘려보내세요.
데이터에 접근하는 세 가지 방법
같은 수치, 다른 표면 — 당신의 개발 방식에 맞는 것을 고르세요.
REST API
제품, 대시보드, 데이터 파이프라인을 위해. Bearer 인증, 타입이 지정된 JSON, 레이트 리밋. 지금 이 페이지입니다.
누가 이 API 위에 구축하는가
SEO 및 AI 가시성 데이터를 자사 시스템 안에 두고 싶은 팀을 위해.
SaaS & 파트너
실시간 SEO 지표를 당신의 제품 UI에 임베드하세요. 파이프라인을 직접 구축하지 않고도 사용자에게 Search Console과 AI 가시성 데이터를 제공할 수 있습니다.
에이전시
모든 고객의 데이터를 맞춤형 포털, Looker Studio, 또는 리포팅 레이어로 흘려보내세요 — 하나의 키로, 모든 속성을, 수동 내보내기 없이.
데이터 팀
GSC, 순위, AI Tracker 데이터를 정해진 스케줄로 웨어하우스에 적재하세요. 매출과 조인해 대시보드에 필요한 모델을 구축할 수 있습니다.
개발자
점검과 알림을 자동화하고, 작업을 PM 도구와 동기화하며, AI 가시성 모니터링을 이미 배포 중인 앱에 연결하세요.
자주 묻는 질문
정말 공개 SEO API가 있나요?
네 — Bearer 인증 REST `/v1` API가 라이브 상태이며, Search Console 성과, 속성, AI Tracker 프롬프트, 작업을 다룹니다. 전체 공개 레퍼런스는 api.seocrawl.ai/docs에 게시되어 있습니다. 더 넓은 커버리지(GA4, 전체 사이트 감사 내보내기)와 멀티테넌트 파트너 OAuth는 순차 제공됩니다. 아직 라이브가 아닌 기능이 필요하신가요? 조기 액세스를 문의해 주세요.
인증은 어떻게 하나요?
Bearer 토큰으로 합니다. 대시보드에서 `sca_live_` 키를 발급하고 모든 요청에 `Authorization: Bearer <key>`로 보내세요. 본인 계정에는 OAuth 절차가 없습니다 — 헤더 하나면 됩니다.
MCP와 같은 키인가요?
네. 동일한 토큰이 REST API와 MCP 서버 양쪽을 인증합니다. 둘 다 하나의 정규 데이터 레이어에서 읽어오기 때문입니다. 하나의 자격 증명으로, 두 개의 표면을 — 그리고 그 둘에서 동일한 수치를.
레이트 리밋은 어떻게 되나요?
토큰당 분당 60건, 시간당 1,000건입니다. 초과하면 `Retry-After` 헤더가 포함된 `429`를 받습니다. REST 리밋은 MCP 사용량과 별도로 추적되므로 둘이 같은 예산을 두고 경쟁하지 않습니다.
제 고객의 Search Console 속성을 연결할 수 있나요?
그 멀티테넌트 파트너 플로우 — 테넌트별 Google OAuth로, 각 고객의 GSC 속성을 본인 계정 아래에 엄격한 데이터 격리와 함께 연결하는 기능 — 는 현재 활발히 개발 중입니다. 파트너 연동을 구축 중이시라면 조기 액세스를 위해 연락 주세요.
오늘 어떤 데이터를 가져올 수 있나요?
Search Console 요약과 기간 비교, 상위 키워드와 페이지, 단일 키워드/페이지 상세, 속성 목록, AI Tracker 프롬프트, 그리고 작업에 대한 전체 읽기/쓰기. MCP가 노출하는 것을 REST로 반영합니다.