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

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

/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(複数)に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)を使用して、1つの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統合 - ノーコード統合