Linklyの分析API

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

関連: リンク短縮API | Webhooks

開始する前に

Linklyはインターフェース内でAPIリクエストを生成し、アプリケーションにコピーして貼り付けることができます。

時間を節約して、難しい部分は私たちに任せてください。当社のAPIは完全にマシンが読み取り可能です。

認証

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

トラフィックレポートAPI

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

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

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

出力形式

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

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

デフォルトでは、APIは日付ごとに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時間キャッシュされます。このエンドポイントへの繰り返しリクエストはリアルタイムデータを生成しません。

グループ化されたカウント

/counters/{dimension}エンドポイントは、country、platform、destination、referer、isp、link_idなどの単一のディメンションでグループ化されたクリック合計を返します。結果はクリック数でソートされ、最高数が最初です。

最大10,000の値が返されます。 destination、referer、remote_ip、ispなどの高カーディナリティディメンションは、ビジーなワークスペースではそれより多くの異なる値を持つことができます。その場合、クリック数で上位10,000を受け取り、残りは返されません。

totalフィールドは常にすべてのグループ（返されないものを含む）全体のクリック数です。つまり、トランケートされた結果ではcount値の合計はtotalより少なくなります。つまり、count / totalとして計算されたパーセンテージは正確です。

上位10,000ではなく完全な値のセットが必要な場合は、生のクリックデータをエクスポートして自分で集約するか、BigQuery統合を使用します。

リアルタイムクリック通知

リアルタイムクリック通知については、Webhooksを参照してください。Webhookはクリックが発生するとすぐに指定されたURL(s)にPOSTリクエストを送信し、クリックに関する詳細情報を含みます。

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

公正な使用方針

レート制限

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

使用制限

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

使用にカウントされるもの

• APIリクエスト: 分析APIエンドポイント（/clicks、/counters、/export）への各コールは1つのリクエストとしてカウントされます。APIキーで行われたリンクエクスポート（/links/export）も1つのリクエストとしてカウントされます。
• スキャンされたデータ: リクエストを実行するために分析データベースで処理されるデータの量。より大きな日付範囲と複雑なクエリはより多くのデータをスキャンします。

制限を超えた場合の動作

有料プランのワークスペースがすべてのAPIリクエストを使用した場合、統合を継続して動作させるために自動的にAPIパックがサブスクリプションに追加され、ワークスペースのメンバーに通知するメールが送信されます。APIパックは、削除するまで各請求期間にエクストラAPIリクエストを追加します。

APIリクエストは以下の場合に代わりに429 Too Many Requestsエラーを返します。

1. 1
   ワークスペースが無料またはスタータープランにあり、APIパックを追加できない
2. 2
   ワークスペースのサブスクリプションがキャンセルに設定されているか、支払いが期限切れである
3. 3
   ワークスペースがスキャンされたデータの許容量をすべて使用している — APIパックはリクエストを追加し、データは追加しません

使用制限は各請求期間の開始時にリセットされ、いずれにせよリンクは正常に動作し、クリックを追跡し続けます。

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

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

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

さらに必要な場合

お支払いページのAdd-onsの下でいつでも自分でAPIパックを追加できます。各パックは毎請求期間にエクストラAPIリクエストを追加します。ページには確認前にプランの価格が表示されます。

APIパックはレート制限を変更しません。より高いレート制限が必要な場合は、サポートウィジェットを使用して私たちに連絡してください。

BigQuery統合

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

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

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

BigQuery統合について詳しく知る →

関連

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