Linklyの分析API

Linkly分析APIを使用してプログラム的にクリックデータとトラフィックレポートをエクスポートします。

関連項目: リンク短縮API | Webhooks

始める前に

Linklyはインターフェース内でAPIリクエストを生成し、アプリケーションにコピー&ペーストできるようにします。

時間を節約し、面倒な作業は私たちに任せましょう。当社のAPIは完全にマシンで処理可能です。

認証

APIキーとワークスペースIDが必要です。これらの詳細はLinkly内から取得できます。

トラフィックレポートAPI

Linklyはトラフィックレポート内でAPIリクエストを自動的に生成します。

Linklyのトラフィックレポートは自動的にAPIリクエストを生成します。 画面に表示されているデータに基づいています。

これらのリンクにはAPIキーが含まれており、簡単にカスタマイズして独自のアプリケーションで使用できます。

出力形式

分析APIは3つの出力形式をサポートしています。

ピボットモード（マトリックス形式）

デフォルトでは、APIは1日ごとに1行のタイムシリーズデータを返します。ピボットモードを使用すると、すべてのリンクのトラフィックを1つのマトリックスで単一のリクエストで取得できます。

任意のトラフィックレポートのデータをエクスポートドロップダウンを使用してリンク別にデータをすばやくエクスポートするか、APIリクエストにpivot=link_idを追加します。

リクエストにpivot=link_idを追加すると、以下のデータが得られます。

• 日付を行として (1日につき1行)
• リンクを列として (リンクごとに1列)

CSV/TSVピボット出力例

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リクエストを送信し、クリックに関する詳細情報を含みます。

APIを介してWebhookを管理することもできます。詳細についてはOpenAPI仕様を参照してください。

利用規約

レート制限

分析APIはワークスペースごとに1時間あたり50リクエストに制限されています。

使用量制限

レート制限に加えて、分析APIには各請求期間でリセットされる使用量制限があります。

使用量としてカウントされるもの

• APIリクエスト: 分析APIエンドポイント(/clicks、/counters、/export)への各呼び出しは1リクエストとしてカウントされます。
• スキャンデータ: リクエストを処理するために当社の分析データベースによって処理されるデータの量。より大きな日付範囲と、より複雑なクエリはより多くのデータをスキャンします。

制限を超えた場合はどうなるか

使用量制限を超えた場合:

1. 1
   APIリクエストは429 Too Many Requestsエラーを返します
2. 2
   次の請求期間の開始時に制限は自動的にリセットされます
3. 3
   リンクは引き続き正常に機能し、クリックを追跡します

使用量を削減するためのヒント

ほとんどのユーザーはピボットモード(pivot=link_id)を使用して、すべてのデータを単一のAPIリクエストで取得できます。これは、1回のコールですべてのリンクのトラフィックをマトリックスで返します。

• ピボットモードを使用: pivot=link_idを追加して、各リンクを個別に照会する代わりに、1つのリクエストですべてのリンクのトラフィックを取得します
• 応答をキャッシュ: 同じデータを繰り返して取得する代わりに、APIレスポンスをローカルに保存します
• より小さな日付範囲を使用: 必要な日付のみを照会します
• バッチリクエスト: link_idsパラメータを使用して、複数のリンククエリを1つのリクエストに結合します

さらに必要ですか？

より高い制限が必要な場合は、サポートウィジェットを使用してお問い合わせください。

BigQuery統合

大量の分析ニーズに対応するために、LinklyはBigQuery統合を提供しており、クリックデータへの直接SQLアクセスを提供します。

• ライブデータアクセス - BigQueryでクリックデータをリアルタイム更新で直接照会します
• 無制限のクエリ - APIレート制限なし。BigQueryコンピュートのコストのみを支払います
• カスタムレポーティング - Looker、Data Studio、またはTableauでダッシュボードを構築します
• データ統合 - クリックデータを他のビジネスメトリクスと結合します

BigQuery統合はEnterpriseプランに含まれています。詳細はお問い合わせください。

BigQuery統合の詳細を確認 →

関連

• リンク短縮API - プログラム的にリンクを作成および更新する
• Webhooks - リアルタイムクリック通知
• BigQuery統合 - クリックデータへの直接SQLアクセス
• Zapier統合 - ノーコード統合