Search performance of your site — clicks, impressions, CTR
google-search-console.performanceGet your site's Google Search performance — clicks, impressions, CTR and top queries
- 가격
- free정가 기준
- 성공률
- 100%최근 30일 · 23,864회
- 지연 시간 p50
- 161 msp95 610 ms
- 마지막 검증
- 2026. 7. 28.동작 확인됨
POSThttps://toolswitch.dev/v1/tools/google-search-console.performanceBeta- 플랫폼 할당량 사용
- 동기 응답
- 공개 데이터 읽기
파라미터
request shape previously live-verified via the registry entry's examples. Query data is retained 16 months
| 파라미터 | 유형 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 경로 파라미터 | ||||
siteUrl | 문자열 | 필수 | Raw property id accepted — treg encodes it: 'sc-domain:example.com' for a domain property, or 'https://example.com/' (with trailing slash) for a URL-prefix one. treg's connection picker lists both forms | sc-domain:example.com |
| 요청 본문(JSON) | ||||
type | 문자열 | 선택 | web (default) | image | video | news | discover | googleNews | web |
endDate | 문자열 | 필수 | 2026-06-28 | |
rowLimit | 정수 | 선택 | 1–25000, default 1000 | 100 |
startRow | 정수 | 선택 | pagination offset | 0 |
dataState | 문자열 | 선택 | final (default) | all — 'all' includes fresh, still-incomplete data | final |
startDate | 문자열 | 필수 | YYYY-MM-DD; data lags ~2 days, so 'today' is always empty | 2026-06-01 |
dimensions | 배열 | 선택 | any of query, page, country, device, date, searchAppearance. OMIT for a site TOTAL — summing a dimension does NOT equal the total, because rows below the privacy threshold are withheld | ["query"] |
dimensionFilterGroups | 배열 | 선택 | filters, e.g. [{"filters":[{"dimension":"page","operator":"contains","expression":"/blog/"}]}] | |
- 경로 파라미터
siteUrl문자열필수Raw property id accepted — treg encodes it: 'sc-domain:example.com' for a domain property, or 'https://example.com/' (with trailing slash) for a URL-prefix one. treg's connection picker lists both forms
예시:
sc-domain:example.com- 요청 본문(JSON)
type문자열선택web (default) | image | video | news | discover | googleNews
예시:
webendDate문자열필수예시:
2026-06-28rowLimit정수선택1–25000, default 1000
예시:
100startRow정수선택pagination offset
예시:
0dataState문자열선택final (default) | all — 'all' includes fresh, still-incomplete data
예시:
finalstartDate문자열필수YYYY-MM-DD; data lags ~2 days, so 'today' is always empty
예시:
2026-06-01dimensions배열선택any of query, page, country, device, date, searchAppearance. OMIT for a site TOTAL — summing a dimension does NOT equal the total, because rows below the privacy threshold are withheld
예시:
["query"]dimensionFilterGroups배열선택filters, e.g. [{"filters":[{"dimension":"page","operator":"contains","expression":"/blog/"}]}]
코드 예제
$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.
curl -X POST 'https://toolswitch.dev/v1/tools/google-search-console.performance' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"endDate":"2026-07-21","rowLimit":2,"startDate":"2026-07-01"}'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/google-search-console.performance",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("{\"endDate\":\"2026-07-21\",\"rowLimit\":2,\"startDate\":\"2026-07-01\"}"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/google-search-console.performance", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("{\"endDate\":\"2026-07-21\",\"rowLimit\":2,\"startDate\":\"2026-07-01\"}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());게이트웨이 API는 Beta이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 free이며 서비스 수수료가 포함되어 있습니다.