アナリティクス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リンクにつき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を参照してください。Webhooksは、クリックが発生するとすぐに、クリックに関する詳細情報とともに、指定されたURLにPOSTリクエストを送信します。
API経由でWebhooksを管理することもできます - 詳細は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はクリックデータへのSQL直接アクセスを提供するBigQuery統合を提供しています。
- ライブデータアクセス - BigQueryでリアルタイム更新によりクリックデータを直接クエリ
- 無制限のクエリ - APIレート制限なし; BigQueryコンピュートの料金のみ支払います
- カスタムレポート - Looker、Data Studio、またはTableauでダッシュボードを構築
- データ統合 - クリックデータを他のビジネス指標と結合
BigQuery統合は、無制限プランのお客様は無料、他のプランは月額100ドルのアドオンとして利用可能です。
関連
- リンク短縮API - プログラムでリンクを作成および更新
- Webhooks - リアルタイムクリック通知
- BigQuery統合 - クリックデータへのSQL直接アクセス
- Zapier統合 - ノーコード統合