アナリティクスAPIの使い方
Linklyで任意のトラフィックレポートを開きます。
レポートの上部に表示されているAPIリクエストをコピーします。
CSVまたはJSONのいずれかを選択できます。このリンクにはAPIキーが含まれています。
これらのリンクはLinklyのすべてのテーブルとグラフの横にあります。

ChatGPTまたは同等のツールに、これらのリクエストをアプリケーション用のソースコードに変換するよう依頼します。
複雑な統合に時間を費やす必要はありません。
認証
APIキーとワークスペースIDが必要です。これらの詳細はLinkly内で取得できます。
API認証情報の確認方法
Linklyにログインします。
設定をクリックします。
APIキーをクリックします。
トラフィックレポートAPI
Linklyはトラフィックレポート内で自動的にAPIリクエストを生成します。

Linklyのトラフィックレポートは、画面に表示されているデータに基づいてAPIリクエストを自動的に生成します。
これらのリンクにはAPIキーが含まれており、簡単にカスタマイズして独自のアプリケーションで使用できます。
出力形式
アナリティクスAPIは3つの出力形式をサポートしています:
| 形式 | パラメータ | 説明 |
|---|---|---|
| JSON | format=json(デフォルト) | アプリケーション用の構造化データ |
| CSV | format=csv | スプレッドシート用のカンマ区切り値 |
| TSV | format=tsv | タブ区切り値。ブラウザでの表示やスプレッドシートへの貼り付けに最適 |
ピボットモード(マトリックス形式)
デフォルトでは、APIは日付ごとに1行の時系列データを返します。ピボットモードを使用すると、すべてのリンクのトラフィックをマトリックスとして1回のリクエストで取得できます。
任意のトラフィックレポートでデータをエクスポートドロップダウンを使用して、リンク別にデータを素早くエクスポートするか、APIリクエストにpivot=link_idを追加します。

リクエストにpivot=link_idを追加すると、次のようなデータが取得できます:
- 行としての日付(1日あたり1行)
- 列としてのリンク(リンクごとに1列)
CSV/TSVピボット出力例
| My Link | Other Link | |
|---|---|---|
| name | My Link | Other Link |
| full_url | https://linkly.link/abc | https://linkly.link/xyz |
| id | 123 | 456 |
| 2025-12-30 | 45 | 12 |
| 2025-12-31 | 52 | 8 |
| 2026-01-01 | 38 | 15 |
JSONピボット出力例
{
"links": [
{"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
{"id": 456, "name": "Other Link", "full_url": "https://linkly.link/xyz"}
],
"data": [
{"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
{"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
]
}
ピボットモードは次の用途に便利です:
- 複数のリンク間のトラフィック比較
- 分析用のスプレッドシートへのインポート
- 1回の呼び出しですべてのリンクデータを使用するダッシュボードの構築
生のクリックデータ
完全なパラメータ、タイムスタンプ、位置情報を含む、記録した生のクリックデータが利用可能です。
このデータにアクセスするには、下部のタブからエクスポートをクリックし、形式を選択します。これらは、アプリケーションで直接使用できる完全に形成されたAPIリクエストです。


データエクスポートに関する注意事項
- エクスポートするデータ量を減らすために、最初にビューでデータをフィルタリングすることを検討してください。この機能は、現在画面に表示されているレポートを生成するために使用された基礎データをエクスポートします。
- このデータは最大3時間キャッシュされます。このエンドポイントへの繰り返しリクエストでは、リアルタイムのデータは生成されません。
リアルタイムクリック通知
リアルタイムのクリック通知については、Webhooksを参照してください。Webhookは、クリックが発生するとすぐに、クリックに関する詳細情報を指定したURLにPOSTリクエストで送信します。
WebhookはAPI経由でも管理できます - 詳細はOpenAPI仕様を参照してください。
公正使用ポリシー
レート制限
アナリティクスAPIは、ワークスペースごとに1時間あたり50リクエストにレート制限されています。
使用制限
レート制限に加えて、アナリティクスAPIには各請求期間にリセットされる使用制限があります:
| プランタイプ | APIリクエスト | スキャンされたデータ |
|---|---|---|
| 無料 | 100/月 | 10 GB/月 |
| 月額有料 | 2,000/月 | 2 TB/月 |
| 年額有料 | 24,000/年 | 24 TB/年 |
| 月額無制限 | 10,000/月 | 2 TB/月 |
| 年額無制限 | 120,000/年 | 24 TB/年 |
使用量としてカウントされるもの
- APIリクエスト: アナリティクスAPIエンドポイント(
/clicks、/counters、/export)への各呼び出しは1リクエストとしてカウントされます。 - スキャンされたデータ: リクエストを満たすために当社のアナリティクスデータベースによって処理されるデータ量。より大きな日付範囲とより複雑なクエリは、より多くのデータをスキャンします。
制限を超えた場合
使用制限を超えた場合:
- 1APIリクエストは
429 Too Many Requestsエラーを返します - 2制限は次の請求期間の開始時に自動的にリセットされます
- 3リンクは正常に機能し続け、クリックを通常通り追跡します
使用量を削減するためのヒント
ほとんどのユーザーは、ピボットモード(pivot=link_id)を使用することで、1回のAPIリクエストですべてのデータを取得できます。これにより、すべてのリンクのトラフィックを1回の呼び出しでマトリックスとして返します。
- ピボットモードを使用する: 各リンクを個別にクエリする代わりに、
pivot=link_idを追加してすべてのリンクのトラフィックを1回のリクエストで取得します - レスポンスをキャッシュする: 同じデータを繰り返し取得する代わりに、APIレスポンスをローカルに保存します
- より小さな日付範囲を使用する: 必要な日付のみをクエリします
- リクエストをバッチ処理する:
link_idsパラメータを使用して、複数のリンククエリを1つのリクエストに結合します
さらに必要ですか?
より高い制限が必要な場合は、サポートウィジェットを使用してお問い合わせください。
BigQuery統合
大量のアナリティクスニーズに対して、LinklyはBigQuery統合を提供しており、クリックデータへの直接SQLアクセスが可能です。
- ライブデータアクセス - リアルタイム更新でBigQuery内のクリックデータを直接クエリ
- 無制限のクエリ - APIレート制限なし。BigQueryのコンピューティング料金のみ
- カスタムレポート - Looker、Data Studio、Tableauでダッシュボードを構築
- データ統合 - クリックデータを他のビジネスメトリクスと結合
BigQuery統合は、無制限プランのお客様には無料で、他のプランでは月額$100のアドオンとして利用できます。
関連
- リンク短縮API - プログラムでリンクを作成・更新
- Webhooks - リアルタイムクリック通知
- BigQuery統合 - クリックデータへの直接SQLアクセス
- Zapier統合 - ノーコード統合