non-print

API Index

Introduction

Cafe24 Analytics API (Beta)

Cafe24 Analytics APIは、Cafe24ショップのユーザー行動データ提供によってデータ提供サービスを制作する、Cafe24の承認を得た協力会社にのみ提供されるAPIです｡

当APIを通して取得した情報を事前に承認を得ていないチャンネル(またはメディア)および目的のために使用することはできませんのでご注意ください。

2023年以前のデータはEC Admin > 統計 > アクセス統計のデータを基に提供され、2023年以降のデータはEC Admin > 統計 > Cafe24 アナリティクスのデータを基に提供されます。

Cafe24 Analytics APIは、OAuth 2.0基盤の認証システムと標準HTTP Request Method、リソースの予測が可能なエンドポイントURL、HTTPコード基盤のエラーメッセージを提供します。

Request/Response Format

APIのリクエストおよびレスポンスはJSON Formatに対応しています。
個人情報保護のため、Cafe24 Analytics APIはHTTPSプロトコルにのみ対応しています。
Dates属性は ISO_8601 フォーマットで提供されます。：YYYY-MM-DDTHH:MM:SS+09:00

要求例題(検索)

正常応答例題

{
  "resource": {
      "key": "value",
      "key": "value"
   }
}

エラー応答例題

{
  "error": {
      "code": "error code",
      "message": "error message",
      "more_info": {
      }
  }
}

Method

各リソースはReadに対応しており、標準HTTP MethodでAPIを使用することができます。

GET：該当するリソースの情報を照会(Read)します。

Cafe24 Analytics API Intro

Cafe24 Analytics APIはショップのユーザー行動データ照会に適したAPIです。 Cafe24 Analytics APIでは、該当のリソースに対するほぼ全ての情報を照会することができます。また、Cafe24 Analytics APIを使用するには、OAuth 2.0方式による別途の認証が必要となります。

  使用例  
 PV(ページビュー) : https://ca-api.cafe24data.com/visitors/pageview?mall_id=몰아이디&shop_no=1&start_date=2023-02-01&end_date=2023-02-10
アクセス数 : https://ca-api.cafe24data.com/visitors/view?mall_id=몰아이디&shop_no=1&start_date=2023-02-01&end_date=2023-02-10 

API Status Code

Code	発生事例	エラーの解決方法
200	GETに成功した場合
401	1) Access Tokenがない状況で呼び出しを行った場合 2) Access Tokenが有効ではない場合 Access Tokenが満了された場合 4) クライアントが把握できない場合(不明なクライアント)	有効なクライアントIDが使用されたかどうかを確認します。
403	Access Tokenはあるが、該当のScopeに対する権限がない場合	APIのScopeまたはショップの設定を確認し、APIの呼び出し権限があるかどうかを把握します。
403	httpsプロトコルではない場合	httpsプロトコルでAPIリクエストが行われたかどうかを確認します。
404	1) API URLを間違って呼び出した場合 2) リソースが見つからない場合 3) {#id}がない場合	APIドキュメントを参考に、エンドポイントURLに問題があるかどうかを確認します。
422	照会・処理リクエストを行う際の値が既定の仕様(スペック)と異なる場合 1) 必須パラメーターの漏れ 2) 既定の仕様(スペック)と異なる場合	APIドキュメントを参考に、必須パラメーターの入力漏れや無効な値の入力があるかどうかを確認します。
429	クライアントのAPIリクエストによってバケット(Bucket)のトークンがすべて消費された場合	APIリクエスト数が上限を超えないよう、しばらく時間をおいてから再度リクエストを行います。
500	内部サーバーエラーまたは不明なエラーが発生した場合	Cafe24 Developersまでお問い合わせください。
503	サーバーが過負荷でダウンした場合	Cafe24 Developersまでお問い合わせください。
503	サーバーが過負荷でダウンした場合/APIを使用できない場合	Cafe24 Developersまでお問い合わせください。
504	リクエストの処理に時間がかかり、タイムアウトとなった場合	一時的なエラーが発生した場合です。しばらく時間をおいてから再度試してください。

How to use GET API

Cafe24 Analytics APIは多様なデータ照会方法を提供しています。

API照会と関連し、各種パラメーターを使用してデータの呼び出しを行う様々な方法について説明いたします。

1. 検索条件の追加

検索を行う際に、エンドポイントにパラメーターを追加すると検索条件を追加することができます。

複数の条件に一致する結果を検索したい場合、「&」を使用して検索条件を追加することができます。

  検索条件の追加  
 例) 特定のショップにおいて、特定の期間中に発生したPV数を照会する場合
GET https://ca-api.cafe24data.com/visitors/pageview?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01

例) 特定のショップにおいて、特定の期間中に発生したドメインごとのアクセス数を照会する場合
GET https://ca-api.cafe24data.com/visitpaths/domains?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01

例) 特定のショップにおいて、特定の期間中に発生した商品別の売上高・販売件数を照会する場合
GET https://ca-api.cafe24data.com/products/sales?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01

例) 特定のショップにおいて、特定の期間中に発生した時間帯別の購入者数・購入件数・売上高を照会する場合
GET https://ca-api.cafe24data.com/sales/times?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01 

2. Pagination

検索結果は基本的に100件まで照会できます。

照会された結果が多い場合は、「offset」パラメーターを利用して100件ずつ追加照会を行うことが可能です。

  Pagination  
 例) 100件のPVを照会する場合
GET https://ca-api.cafe24data.com/visitors/pageview?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01

例) 101件目~200件目のPVを照会する場合
GET hhttps://ca-api.cafe24data.com/visitors/pageview?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01&offset=100

例) 201件目~300件目のPVを照会する場合
GET hhttps://ca-api.cafe24data.com/visitors/pageview?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01&offset=200

例) 301件目~400件目のPVを照会する場合
GET hhttps://ca-api.cafe24data.com/visitors/pageview?mall_id=nelly&start_date=2023-01-01&end_date=2023-02-01&offset=300 

API Limit

CA APIでは「トークンバケット(Token Bucket)」アルゴリズムが使用されています。

「トークンバケット(Token Bucket)」とは、バケット(Bucket)に「リクエスト数上限」分のトークン(Token)を設定しておいて、リクエストが発生する度に1つのトークンが消費されるうようにし、バケットに使用可能なトークンが残っていない状態になるとリクエストを制限するアルゴリズムです。バケットのトークンは1秒に2個ずつ増加されます。

アプリが1秒に2回ずつのAPIリクエストを発生させる場合は、制限されることなく持続的に使用できます。一時的に1秒以内に「リクエスト数上限」を超える呼び出しが発生する場合は、429エラー(Too Many Request)が返されます。 HeaderのResponse Headerにて「x-ratelimit-remaining」でバケットに残っているトークンを確認し、429エラーを防止することが可能です。

 Response Header
> X-RateLimit-Remaining: 9
> X-RateLimit-Requested-Tokens: 1
> X-RateLimit-Burst-Capacity: 10
> X-RateLimit-Replenish-Rate: 2 

Authentication

アクセストークンは、ショッピングモール（EC Admin API）が発行するトークンとして使用できます。

Get Authentication Code

トークン発行要求時に使われたcodeは再使用できず、コード発行後1分が経過すると満了します。

{mallid} : ショップのIDを入力します。
{client_id} : 開発者センターで作成したアプリのclient_idを入力します。
{state} : 偽変造を防止するために入力する値にコード返還時に同じ値が返還されます。
{redirect_uri} : 開発者センターで作成したアプリのRedirect URLを入力します。
{scope} : アクセストークンでアクセスするリソースサーバーの権限を入力することができます。

アクセストークンの発行のためにはまずアクセスコードを要求しなければなりません。アクセスコードはクライアントがウェブアプリケーションの形態である場合に利用されます。コードの要求はcURLではなくウェブブラウザーで行わなければなりません。

  例示コード(要求)  
 GET 'https://{mallid}.cafe24api.com/api/v2/oauth/authorize?response_type=code&client_id={client_id}&state={state}&redirect_uri={redirect_uri}&scope={scope}' 
  例示コード(応答)  
 HTTP/1.1 302 Found
Location: {redirect_uri}?code={authorize_code}&state={state} 

Get Access Token

発行された認証コードを使用し、実際にAPIを呼び出しできるユーザートークン(Access Token、Refresh Token)を取得することができます。

{mallid}：該当のショップIDを入力してください。
{client_id}：Cafe24 Developersで作成したアプリのclient_idを入力してください。
{client_secret}：Cafe24 Developersで作成したアプリのclient_secretを入力してください。
{code}：発行されたコードを入力してください。
{redirect_uri}：Cafe24 Developersで作成したアプリのRedirect URLを入力してください。

access_token：アクセストークン。クライアントがリソースサーバーにアクセスする際に使用されます。

refresh_token：アクセストークンの満了後、再発行のために使用されるトークンです。

例示コード(要求)

例示コード(応答)

HTTP/1.1 200 OK
{
    "access_token": "0iqR5nM5EJIq..........",
    "expires_at": "2021-03-01T14:00:00.000",
    "refresh_token": "JeTJ7XpnFC0P..........",
    "refresh_token_expires_at": "2021-03-15T12:00:00.000",
    "client_id": "BrIfqEKoPxeE..........",
    "mall_id": "yourmall",
    "user_id": "test",
    "scopes": [
        "mall.analytics",
        "...etc...",
    ],
    "issued_at": "2021-03-01T12:00:00.000"
}

Get Access Token using refresh token

アクセストークンは、発行から2時間が経過すると使用不可になります。アクセストークンが満了された場合、リソースサーバーにアクセスするには再発行が必要となります。その場合、すでにアクセストークンを発行した状態であれば、refresh_tokenを使用してアクセストークンの再発行を行うことが可能です。

refresh tokenの有効期限は2週間であり、refresh tokenが満了される前にリクエストを行うと、更新されたaccess tokenと更新されたrefresh tokenが一緒に返されます。更新されたrefresh tokenが返された後は、既存のrefresh tokenは満了になり、使用不可となります。

発行された認証コードを使用し、実際にAPIを呼び出しできるユーザートークン(Access Token、Refresh Token)を取得することができます。

{mallid}：該当のショップIDを入力してください。
{domain}：該当のショップのドメインを入力してください。
{client_id}：Cafe24 Developersで作成したアプリのclient_idを入力してください。
{client_secret}：Cafe24 Developersで作成したアプリのclient_secretを入力してください。
{refresh_token}：トークンの発行時に返されたrefresh_tokenを入力してください。

access_token：アクセストークン。クライアントがリソースサーバーにアクセスする際に使用されます。

refresh_token：アクセストークンの満了後、再発行のために使用されるトークンです。

例示コード(要求)

例示コード(応答)

HTTP/1.1 200 OK
{
    "access_token": "21EZes0dGSfN..........",
    "expires_at": "2021-03-01T15:50:00.000",
    "refresh_token": "xLlhWztQHBik............",
    "refresh_token_expires_at": "2021-03-15T13:50:00.000",
    "client_id": "BrIfqEKoPxeE..........",
    "mall_id": "yourmall",
    "user_id": "test",
    "scopes": [
        "mall.analytics",
        "...etc...",
    ],
    "issued_at": "2021-03-01T13:50:00.000"
}

Revoke Access Token

特定のアクセストークンを取り消すことができます。

アクセストークンが取り消された場合、要求されたアクセストークンのリフレッシュトークンも同時に取り消されます。

{mallid} : ショップのIDを入力します。
{domain}: ショップのドメインを入力します。
{client_id} : 開発者センターで作成したアプリのclient_idを入力します。
{client_secret}: 開発者センターで作成したアプリのclient_secretを入力します。
{token} : 取り消すアクセストークンを入力してください。

例示コード(要求)

例示コード(応答)

HTTP/1.1 200 OK

Analytics

Adeffect addetails

Endpoints

GET /adeffect/addetails

Adeffect addetails properties

Attribute	Description
ad	광고매체 네이버
keyword	검색어 onepiece
visit_count	방문수 200
visit_rate	방문비율 20.2
purchase_count	구매건수 1053
purchase_rate	구매율 15.5
order_amount	매출액 360000
order_amount_per_visitor	방문당매출 1800
order_amount_per_buyer	구매당매출 1900

List all adeffect addetails

GET /adeffect/addetails

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 ad : 광고매체 keyword : 조회수 visit_count : 담긴수 purchase_count : 구매건수 DEFAULT ad
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Carts action

Endpoints

GET /carts/action

Carts action properties

Attribute	Description
product_no	상품번호 100
product_name	상품명 셔츠
count	조회수 200
add_cart_count	담긴수 30000
add_cart_rate	담김율 30

List all carts action

GET /carts/action

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 product_name : 상품명 count : 조회수 add_cart_count : 담긴수 add_cart_rate : 담김율 DEFAULT count
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Members sales

Endpoints

GET /members/sales

Members sales properties

Attribute	Description
member_order_count	회원 구매건수 1000
member_order_amount	회원 매출액 90000
nonmember_order_count	비회원 구매건수 2000
nonmember_order_amount	비회원 매출액 80000

List all members sales

GET /members/sales

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100

Request Copy

Response Copy

Pages view

Endpoints

GET /pages/view

Pages view properties

Attribute	Description
url	url cafe24.com
count	접속수 1000
visit_count	방문자수 2000
first_visit_count	처음접속수 3000

List all pages view

GET /pages/view

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 url : url count : 조회수 visit_count : 방문자수 first_visit_count : 처음접속수 DEFAULT count
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Products categorydetails

Endpoints

GET /products/categorydetails

Products categorydetails properties

Attribute	Description
product_no	상품번호 98766789
product_name	상품명 티셔츠
product_code	상품코드 P00BDFAW
category_name	카테고리명 상의
category_no	카테고리번호 1591
sales_count_per_category	카테고리별 판매건수 1000
sales_item_per_category	카테고리별 판매물품수 2000
sales_price_per_category	카테고리별 상품판매금액 30000
carts_count_per_category	카테고리별 담긴수 40000

List all products categorydetails

GET /products/categorydetails

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 product_no : 상품번호 product_name : 상품명 order_count : 판매건수 order_product_count : 판매물품수 order_amount : 매출액 DEFAULT product_name
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Products sales

Endpoints

GET /products/sales

Products sales properties

Attribute	Description
product_no	상품번호 98766789
product_name	상품명 셔츠
order_count	판매건수 3
order_product_count	판매물품수 2
order_amount	매출액 30000

List all products sales

GET /products/sales

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 product_no : 상품번호 product_name : 상품명 order_count : 판매건수 order_product_count : 판매물품수 order_amount : 매출액 DEFAULT order_amount
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Products view

Endpoints

GET /products/view

Products view properties

Attribute

Description

product_no

상품번호

98766789

product_name

상품명

셔츠

count

조회수

List all products view

GET /products/view

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 product_no : 상품번호 product_name : 상품명 count : 조회수 DEFAULT count
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Sales orderdetails

Endpoints

GET /sales/orderdetails

Sales orderdetails properties

Attribute	Description
order_id	주문번호 20240201-0000000
ad	광고매체 ad
keyword	검색어 keyword
payment_method	결제수단 card
order_amount	매출액 218200

List all sales orderdetails

GET /sales/orderdetails

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 order_id : 주문번호 ad : 광고매체 keyword : 검색어 payment_method : 결제수단 order_amount : 매출액 DEFAULT order_id
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Sales paymethods

Endpoints

GET /sales/paymethods

Sales paymethods properties

Attribute	Description
payment_method	결제수단 c
buyers_count	구매자수 100
order_count	구매건수 200
order_amount	매출액 집계 30000

List all sales paymethods

GET /sales/paymethods

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 payment_method : 결제수단 buyers_count : 구매자수 order_count : 구매건수 order_amount : 매출액 DEFAULT order_amount
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Sales pervisitors

Endpoints

GET /sales/pervisitors

Sales pervisitors properties

Attribute	Description
order_amount_per_visitor	방문 1인당 매출액 10000
order_amount_per_buyer	구매 1인당 매출액 20000

Attribute

Description

order_amount_per_visitor

방문 1인당 매출액

10000

order_amount_per_buyer

구매 1인당 매출액

20000

List all sales pervisitors

GET /sales/pervisitors

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100

Request Copy

Response Copy

Sales times

Endpoints

GET /sales/times

Sales times properties

Attribute	Description
hour	시간 1
buyers_count	구매자수 100
order_count	구매건수 200
order_amount	매출액 30000

List all sales times

GET /sales/times

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 hour : 시간대 buyers_count : 구매자수 order_count : 구매건수 order_amount : 매출액 DEFAULT hour
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Visitors dailyactive

Endpoints

GET /visitors/dailyactive

Visitors dailyactive properties

Attribute

Description

date

날짜

2023-01-01

user_count

사용자수

List all visitors dailyactive

GET /visitors/dailyactive

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 date : 날짜 user_count : 사용자수 DEFAULT date
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Visitors pageview

Endpoints

GET /visitors/pageview

Visitors pageview properties

Attribute

Description

date

날짜

2023-01-01

hour

시간

page_view

페이지뷰

List all visitors pageview

GET /visitors/pageview

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
format_type	데이터 형식 day: 일별 hour: 시간별 DEFAULT day
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 date : 날짜 page_view : 페이지뷰 DEFAULT date
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Visitors unique

Endpoints

GET /visitors/unique

Visitors unique properties

Attribute

Description

date

날짜

2023-01-01

unique_visit_count

순방문자수

List all visitors unique

GET /visitors/unique

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 date : 날짜 unique_visit_count : 순방문자수 DEFAULT date
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Visitors view

Endpoints

GET /visitors/view

Visitors view properties

Attribute	Description
date	날짜 2023-01-01
hour	시간 1
visit_count	방문자수 32
first_visit_count	처음방문자수 20
re_visit_count	재방문자수 12

List all visitors view

GET /visitors/view

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
format_type	데이터 형식 day: 일별 hour: 시간별 DEFAULT day
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 date : 날짜 visit_count : 방문자수 first_visit_count : 처음방문자수 re_visit_count : 재방문자수 DEFAULT date
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Visitpaths adkeywordsales

Endpoints

GET /visitpaths/adkeywordsales

Visitpaths adkeywordsales properties

Attribute	Description
ad	광고매체명 ad
keyword	검색어 keyword
order_count	구매건수 1000
order_amount	매출액 10000

List all visitpaths adkeywordsales

GET /visitpaths/adkeywordsales

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 keyword : 검색어 order_count : 구매건수 order_amount : 매출액 DEFAULT ad
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Visitpaths ads

Endpoints

GET /visitpaths/ads

Visitpaths ads properties

Attribute

Description

광고매체명

visit_count

방문자수

List all visitpaths ads

GET /visitpaths/ads

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 ad : 광고매체명 visit_count : 방문수 DEFAULT visit_count
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Visitpaths adsales

Endpoints

GET /visitpaths/adsales

Visitpaths adsales properties

Attribute

Description

광고매체명

order_count

구매건수

1000

order_amount

매출액

10000

List all visitpaths adsales

GET /visitpaths/adsales

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 ad : 광고매체명 order_count : 구매건수 order_amount : 매출액 DEFAULT order_amount
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Visitpaths domains

Endpoints

GET /visitpaths/domains

Visitpaths domains properties

Attribute

Description

domain

도메인

cafe24.com

visit_count

방문자수

1000

List all visitpaths domains

GET /visitpaths/domains

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 domain : 도메인 visit_count : 방문수 DEFAULT visit_count
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Visitpaths domainsales

Endpoints

GET /visitpaths/domainsales

Visitpaths domainsales properties

Attribute

Description

domain

도메인

cafe24.com

order_count

구매건수

1000

order_amount

매출액

10000

List all visitpaths domainsales

GET /visitpaths/domainsales

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 domain : 도메인 order_count : 구매건수 order_amount : 매출액 DEFAULT order_amount
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Visitpaths keyworddetails

Endpoints

GET /visitpaths/keyworddetails

Visitpaths keyworddetails properties

Attribute	Description
keyword	검색어 onepiece
engine	검색엔진 네이버
visit_count	방문수 200
purchase_count	구매건수 1053
purchase_rate	구매율 15.5
order_amount	매출액 360000
order_amount_per_visitor	방문당매출 1800
order_amount_per_buyer	구매당매출 1900

List all visitpaths keyworddetails

GET /visitpaths/keyworddetails

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 keyword : 검색어 engine: 검색엔진 purchase_count : 구매건수 order_amount : 매출액 DEFAULT keyword
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT asc

Request Copy

Response Copy

Visitpaths keywords

Endpoints

GET /visitpaths/keywords

Visitpaths keywords properties

Attribute

Description

keyword

검색어

keyword

visit_count

방문자수

1000

List all visitpaths keywords

GET /visitpaths/keywords

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 keyword : 검색어 visit_count : 방문수 DEFAULT visit_count
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Visitpaths keywordsales

Endpoints

GET /visitpaths/keywordsales

Visitpaths keywordsales properties

Attribute

Description

keyword

검색어

keyword

order_count

구매건수

1000

order_amount

매출액

10000

List all visitpaths keywordsales

GET /visitpaths/keywordsales

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 keyword : 검색어 order_count : 구매건수 order_amount : 매출액 DEFAULT order_amount
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy

Visitpaths urls

Endpoints

GET /visitpaths/urls

Visitpaths urls properties

Attribute

Description

url

cafe24.com

visit_count

방문자수

1000

List all visitpaths urls

GET /visitpaths/urls

GET

基本スペック

Property	Description
SCOPE	접속통계の읽기권한 (mall.read_analytics)
呼び出し件数制限	0

要求スペック

Parameter	Description
mall_id Required	몰 아이디 샘플 아이디
shop_no	샵 번호 샵 번호 DEFAULT 1
start_date Required	시작일 2023-01-01
end_date Required	종료일 2023-02-01
device_type	디바이스 타입 pc: pc mobile: 모바일 total: 전체
limit	응답 갯수 최소: 50 최대: 1000 기본: 100 DEFAULT 100
offset	오프셋 DEFAULT 0
sort	정렬 값 url : url visit_count : 방문수 DEFAULT visit_count
order	정렬 순서 desc: 내림차순 asc: 오름차순 DEFAULT desc

Request Copy

Response Copy