Google Search Console API 를 당신의 스택에
당신의 Search Console 실적 데이터를, 깔끔한 REST 엔드포인트로.
클릭수, 노출수, CTR, 평균 게재순위를 검색어·페이지·기간별로, Google Search Console에서 곧바로 당신의 제품, 대시보드, 데이터 웨어하우스로 가져오세요. SEOcrawl AI에서 GSC를 한 번 연결한 뒤 대시보드에서 Bearer 키를 발급하고 REST /v1을 호출하면 끝입니다 — Google OAuth를 직접 만들 필요가 없습니다. SEOcrawl AI MCP를 구동하는 것과 동일한 정규 데이터 레이어라서 수치가 어긋나지 않습니다. 색인 커버리지와 URL 검사는 REST에도 곧 올라가며, MCP에서는 이미 사용할 수 있습니다.
속성을 한 번 확인하고, GSC 데이터를 가져오세요.
대시보드에서 Bearer 토큰을 발급해 Authorization 헤더에 넣으세요. Search Console 속성 id를 한 번만 확인하면, 그다음부터는 REST로 실적을 조회할 수 있습니다. 동일한 키가 REST API와 MCP 서버 양쪽에서 작동합니다.
베이스 URL
https://api.seocrawl.ai/v1Authorization 헤더
Authorization: Bearer sca_live_your_token_hereSearch Console의 모든 지표를, REST로
클릭수, 노출수, CTR, 평균 게재순위를 검색어·페이지·기간·전기 대비로. 모든 엔드포인트는 속성 단위입니다. 먼저 속성 id를 확인한 뒤 해당 Search Console 데이터를 읽으세요. 아래 GSC 그룹은 v1에서 라이브 상태이며, 색인 커버리지와 URL 검사는 오늘 MCP에서 제공되고 REST에는 곧 추가됩니다.
속성
계정에 연결된 Search Console 속성을 나열합니다. 각 속성의 id는 모든 GSC 엔드포인트 경로에 사용됩니다.
- GET
/v1/properties라이브
실적
지정한 기간의 클릭수, 노출수, 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/keywords/detail라이브
페이지
성과가 좋은 URL과 그 Search Console 지표 — 특정 페이지 하나의 일자별 전체 분해까지.
- GET
/v1/properties/{id}/gsc/top-pages라이브 - GET
/v1/properties/{id}/gsc/pages/detail라이브
색인 커버리지
Google이 실제로 색인하는 것: 커버리지 상태와 색인 추이. 오늘은 MCP에서 사용할 수 있고, REST 엔드포인트는 순차 배포 중입니다.
- GET
/v1/properties/{id}/indexation/summary곧
URL 검사
URL 단위 검사 — 특정 페이지의 커버리지, 마지막 크롤, 색인 상태. MCP에서는 이미 사용할 수 있고 REST가 그다음입니다.
- GET
/v1/properties/{id}/url-inspection곧
진짜 Search Console 데이터를, 제품에 맞게
서드파티 추정치가 아니라 당신의 실제 Google Search Console 실적을, Bearer 인증과 사용량 제한을 갖춘 깔끔한 REST API로. MCP와 하나의 정규 데이터 레이어를 공유하므로 수치가 서로 어긋나지 않습니다.
Search Console에서 곧바로
클릭수, 노출수, CTR, 평균 게재순위는 당신 소유의 GSC 속성에서 가져온 값입니다. 모델로 추정하거나 스크래핑한 수치가 아니라 Google이 보고하는 실제 숫자죠. 예측 가능한 리소스, 표준 메서드, 타입이 지정된 JSON, RFC를 따르는 오류 응답.
Google OAuth를 만들 필요 없음
SEOcrawl AI에서 Search Console을 한 번 연결하면, 그다음은 sca_live_ Bearer 키 하나로 읽습니다. Google Cloud 프로젝트, 동의 화면, 토큰 갱신 구현은 건너뛰세요. 키 발급과 폐기는 대시보드에서 몇 초면 됩니다.
정규 데이터 레이어는 하나
REST의 GSC 엔드포인트와 MCP의 GSC 도구는 같은 프로바이더 위에 놓인 형제이고, 그 일치 여부는 CI에서 테스트합니다. 당신의 대시보드와 AI 에이전트는 언제나 동일한 클릭수, 노출수, 게재순위를 봅니다.
검색어·페이지 단위 세분화
속성 전체 합계를 읽어도 되고, 상위 검색어, 상위 페이지, 키워드 하나의 일자별 추세, URL 하나의 히스토리까지 파고들어도 됩니다. Search Console에서 보던 것과 같은 차원을 HTTP로 그대로 지정할 수 있습니다.
기간 비교 기본 내장
range(last_7_days, last_28_days, last_3_months, last_year)나 명시적인 from/to 날짜를 지정하면 기간 비교가 바로 함께 옵니다. 두 번째 호출도, 증감을 맞추기 위한 클라이언트 쪽 날짜 계산도 필요 없습니다.
문서화된 사용량 제한
토큰당 분당 60회, 시간당 1,000회. 초과하면 429 + Retry-After로 명확하게 응답합니다. REST 제한은 MCP 사용량과 별도 풀이라서 한쪽이 다른 쪽의 몫을 잠식하지 않습니다.
시작은 3단계면 충분합니다
아무것도 없는 상태에서 첫 Search Console 호출까지 몇 분이면 됩니다.
키 발급하기
SEOcrawl AI에서 Search Console을 연결한 뒤 API 토큰을 열어 Bearer 토큰을 생성하세요. 한 번만 표시되니 바로 복사해 두세요 — sca_live_로 시작합니다.
속성 확인하기
GET /v1/properties를 Authorization: Bearer sca_live_…와 함께 호출해, 읽으려는 Search Console 속성의 id(UUID)를 받으세요.
GSC 데이터 가져오기
합계는 /v1/properties/{id}/gsc/summary?range=last_28_days로, 그 밖에는 /gsc/top-keywords, /gsc/top-pages, /detail 엔드포인트로 — 받은 JSON을 제품, 대시보드, 웨어하우스에 그대로 흘려보내세요.
Search Console 데이터에 닿는 세 가지 방법
같은 GSC 수치, 다른 표면 — 당신이 만드는 방식에 맞는 쪽을 고르세요.
REST API
제품, 대시보드, 데이터 파이프라인용. Bearer 인증, 타입 지정 JSON, 사용량 제한. 지금 보고 계신 페이지가 이것입니다 — 전체 SEO API는 같은 키로 순위와 AI 가시성 엔드포인트까지 더해 줍니다.
Search Console API 위에 무엇을 만드나
실제 GSC 실적 데이터를 자기 시스템 안에서 쓰고 싶은 팀들입니다.
에이전시
모든 클라이언트의 Search Console 데이터를 자체 포털, Looker Studio, 리포팅 레이어로 흘려보내세요. 키 하나로 모든 속성을 다루고, GSC에서 수동으로 내보낼 일이 없습니다.
SaaS·파트너
실시간 Search Console 지표를 당신 제품의 UI에 그대로 심으세요. Google API를 직접 배선하지 않고도 사용자에게 클릭수, 노출수, 게재순위를 보여 줄 수 있습니다.
데이터 팀
GSC의 클릭수, 노출수, CTR, 게재순위를 스케줄에 맞춰 웨어하우스에 적재하세요. 매출과 조인해 대시보드에 필요한 모델을 만들면 됩니다.
개발자
검색어와 페이지 모니터링을 자동화하고, 순위 하락에 알림을 띄우고, 이미 운영 중인 앱과 워크플로에 Search Console 데이터를 연결하세요.
자주 묻는 질문
이것이 Google의 공식 Search Console API인가요?
아닙니다. 이것은 SEOcrawl AI가 직접 제공하는 Bearer 인증 REST API로, 당신이 이미 계정에 연결해 둔 Search Console 데이터를 읽습니다. SEOcrawl AI에서 GSC를 한 번 연결하면 그다음부터는 sca_live_ 키 하나로 클릭수, 노출수, CTR, 게재순위를 가져올 수 있습니다 — Google Cloud 프로젝트도, OAuth 동의 화면도, 토큰 갱신 로직도 직접 만들 필요가 없습니다. 수치는 당신의 진짜 Search Console 수치이고, API와 인증만 저희 것입니다.
오늘 가져올 수 있는 Search Console 데이터는 무엇인가요?
기간 합계(클릭수, 노출수, CTR, 평균 게재순위), 전기 대비 비교, 지표가 붙은 상위 검색어와 상위 페이지, 키워드 하나 또는 페이지 하나의 일자별 상세, 그리고 연결된 속성 목록입니다. 색인 커버리지와 실시간 URL 검사는 지금 MCP에서 사용할 수 있고, 해당 REST 엔드포인트는 그다음으로 배포됩니다. 조회하기보다 계정을 읽어 보고 싶다면 Google Search Console 감사가 같은 데이터를 프롬프트 하나로 다룹니다.
인증은 어떻게 하나요?
Bearer 토큰으로 합니다. 대시보드에서 sca_live_ 키를 발급하고, 모든 요청에 Authorization: Bearer <key>로 실어 보내세요. 본인 계정이라면 OAuth 절차 없이 헤더 하나면 끝납니다.
어떤 기간을 지원하나요?
모든 GSC 엔드포인트는 range(last_7_days, last_28_days, last_3_months, last_year) 또는 명시적인 from/to 쌍을 받습니다. gsc/compare 엔드포인트는 같은 구간을 직전 기간과 비교해 돌려주므로, 두 번째 호출 없이 증감을 얻을 수 있습니다.
사용량 제한은 어떻게 되나요?
토큰당 분당 60회, 시간당 1,000회입니다. 이를 넘기면 Retry-After 헤더와 함께 429가 돌아옵니다. REST 제한은 MCP 사용량과 별도로 집계되므로 둘이 같은 예산을 두고 경쟁하지 않습니다.
MCP와 같은 키, 같은 데이터인가요?
네. 동일한 sca_live_ 토큰이 REST API와 MCP 서버 양쪽을 인증하고, 둘 다 하나의 정규 데이터 레이어에서 읽습니다 — 그래서 REST로 가져온 Search Console 수치는 AI 에이전트가 MCP로 보는 수치와 완전히 같습니다. 자격 증명은 하나, 표면은 둘입니다.
