블로그 방문 통계 - 네이버 마케팅
1. 네이버 블로그 방문 통계 조회naver. blog. owner_ stats. report
MCP 도구 이름 naver__
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
연결한 내 네이버 블로그의 방문 통계를 조회합니다.통계 지표 한 가지와 기준일을 정하면 그 날까지 15일의 날짜별 수치를 돌려주고 유입 경로는 기준일 하루치이며, 조회 전용이라 블로그의 글이나 설정은 바뀌지 않습니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| provider | string | - | Y | 호출할 기관입니다.
| |
| action | string | - | Y | 호출할 작업입니다.
| |
| account_ | string | 36 | 조건부 | 등록한 자격증명을 가리키는 아이디입니다. 생략하면 이 계정이 그 기관에 등록한 자격증명 중 대표로 지정한 것이 쓰입니다. 대표가 없으면 등록한 자격증명이 하나뿐일 때만 자동으로 선택되고, 둘 이상이면 직접 지정해야 합니다. 등록한 자격증명이 없거나 하나를 고르지 못하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다. | |
| params | object | - | Y | 작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다. | |
| encrypted_ | object | - | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| metric | string | - | Y | 조회할 방문 통계 지표입니다. visit/visit, visit/uv, visit/cv, daily/cv, user/referer/total 다섯 중 하나를 그대로 보내며 그 밖의 값이면 작업이 실패하며 error.code 는 VALIDATION_INVALID_FIELD 입니다 | |
| start_ | string | 10 | Y | 조회 기준일. 이 날까지 15일의 날짜별 수치를 돌려주고, 유입 경로는 이 날 하루치입니다 | |
| output_ | array | - | N | 이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다. metric 이 visit/visit 일 때만 쓸 수 있습니다. 그 밖의 요청에 넣으면 작업을 만들지 않고 HTTP 400 VALIDATION_INVALID_FIELD 로 거절하며 error.message 는 「이 요청은 파일 형식을 고를 수 없습니다. output_formats 를 빼고 다시 요청해 주세요.」 입니다 |
curl --request POST \
--url 'https://api.xdata.kr/v1/jobs' \
--header 'Authorization: Basic {base64(client_id:client_secret)}' \
--header 'X-Env-Scope: real_test' \
--header "Idempotency-Key: report-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "naver",
"action": "naver.blog.owner_stats.report",
"account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
"params": {
"metric": "<필수>",
"start_date": "<필수>"
}
}'Response
- 이 API 가 돌려주는 데이터: 통계 지표 식별자, 지표 열 정보, 날짜별 수치, 집계 시각
응답 필드를 이름별로 정리한 표는 아직 문서에 없습니다. 돌려주는 데이터의 종류는 위에 적혀 있습니다.
{
"job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
"status": "QUEUED",
"env_scope": "real_test",
"provider": "naver",
"action": "naver.blog.owner_stats.report",
"submitted_at": "2026-05-27T12:34:56+09:00"
}