分析APIを使い始める方法
Linkly内の任意のトラフィックレポートを開きます。
レポートの上部に表示されているAPIリクエストをコピーします。
データ出力形式はCSVです。このリンクには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行のタイムシリーズデータを返します。ピボットモードを使用すると、すべてのリンクのトラフィックをマトリックスとして1つのリクエストで取得できます。
任意のトラフィックレポートのデータをエクスポートドロップダウンを使用してリンク別にデータをすばやくエクスポートするか、APIリクエストにpivot=link_idを追加します。
リクエストにpivot=link_idを追加して、次のデータを取得します：
- 行として日付（1日あたり1行）
- 列としてリンク（リンクごとに1列）
CSV/TSVピボット出力の例
| マイリンク | その他のリンク | |
|---|---|---|
| name | マイリンク | その他のリンク |
| 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": "マイリンク", "full_url": "https://linkly.link/abc"},
{"id": 456, "name": "その他のリンク", "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リクエストを送信します。詳細な情報が含まれます。
WebhooksはAPI経由で管理することもできます。詳細はOpenAPI仕様を参照してください。
フェアユースポリシー
レート制限
分析APIはワークスペースあたり時間あたり50リクエストに制限されています。
使用制限
レート制限に加えて、分析APIには各請求期間ごとにリセットされる使用制限があります：
| プランタイプ | APIリクエスト | スキャンされたデータ |
|---|---|---|
| Free | 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統合はUnlimitedプランのお客様は無料で、他のプランでは$100/月のアドオンとして利用可能です。
関連
- リンク短縮API - プログラム的にリンクを作成および更新する
- Webhooks - リアルタイムクリック通知
- BigQuery統合 - クリックデータへの直接SQLアクセス
- Zapier統合 - ノーコード統合