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	広告媒体 naver
keyword	検索キーワード onepiece
visit_count	アクセス数 200
visit_rate	アクセス率 20.2
purchase_count	購入件数 1053
purchase_rate	購入率 15.5
order_amount	売上高 360000
order_amount_per_visitor	アクセス1名当たりの売上高 1800
order_amount_per_buyer	購入1名当たりの売上高 1900

List all adeffect addetails cafe24

GET /adeffect/addetails

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /carts/action

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /members/sales

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /pages/view

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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	商品名 Tシャツ
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 cafe24

GET /products/categorydetails

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /products/sales

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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

閲覧数

Data Product Hits Analysis API cafe24

GET /products/view

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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_date	注文日 2024-06-04
order_id	注文番号 20240201-0000000
ad	広告媒体 ad
keyword	検索キーワード keyword
medium	媒体 medium
campaign	キャンペーン campaign
content	コンテンツ content
payment_method	決済方法 card
order_amount	売上高 218200

List all sales orderdetails cafe24

GET /sales/orderdetails

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
shop_no	ショップ番号ショップ番号 DEFAULT 1
start_date Required	開始日 2023-01-01
end_date Required	終了日 2023-02-01
device_type	デバイスタイプ pc: PC mobile: モバイル total: すべて
orderId	注文番号 20240201-0000000 DEFAULT 20240602-0017928
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 cafe24

GET /sales/paymethods

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /sales/pervisitors

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /sales/times

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitors/dailyactive

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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

PV(ページビュー)

List all visitors pageview cafe24

GET /visitors/pageview

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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: PV(ページビュー) 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 cafe24

GET /visitors/unique

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitors/view

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitpaths/adkeywordsales

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitpaths/ads

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitpaths/adsales

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitpaths/domains

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitpaths/domainsales

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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	検索エンジン NAVER
visit_count	アクセス数 200
purchase_count	購入件数 1053
purchase_rate	購入率 15.5
order_amount	売上高 360000
order_amount_per_visitor	アクセス1名当たりの売上高 1800
order_amount_per_buyer	購入1名当たりの売上高 1900

List all visitpaths keyworddetails cafe24

GET /visitpaths/keyworddetails

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitpaths/keywords

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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 cafe24

GET /visitpaths/keywordsales

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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

URL

cafe24.com

visit_count

アクセス数

1000

List all visitpaths urls cafe24

GET /visitpaths/urls

GET

基本スペック

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

要求スペック

Parameter	Description
mall_id Required	ショップID サンプルID
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