LinklyのアナリティクスAPI

LinklyのアナリティクスAPIを使用して、クリックデータとトラフィックレポートをプログラムでエクスポートできます。

関連: リンク短縮API | Webhooks

始める前に

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

時間を節約し、私たちに面倒な作業を任せてください。当社のAPIは完全に機械で利用できます。

アナリティクスAPIの使い方

1

Linklyで任意のトラフィックレポートを開きます。

2

レポートの上部に表示されているAPIリクエストをコピーします。

CSVまたはJSONのいずれかを選択できます。このリンクにはAPIキーが含まれています。

これらのリンクはLinklyのすべてのテーブルとグラフの横にあります。

レポートの上部に表示されているAPIリクエストをコピーします。
レポートの上部に表示されているAPIリクエストをコピーします。
3

ChatGPTまたは同等のツールに、これらのリクエストをアプリケーション用のソースコードに変換するよう依頼します。

複雑な統合に時間を費やす必要はありません。

認証

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

API認証情報の確認方法

1

Linklyにログインします。

2

設定をクリックします。

3

APIキーをクリックします。

トラフィックレポートAPI

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

Linkly's Traffic Reports API
Linkly's Traffic Reports API

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

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

出力形式

アナリティクスAPIは3つの出力形式をサポートしています:

形式パラメータ説明
JSONformat=json(デフォルト)アプリケーション用の構造化データ
CSVformat=csvスプレッドシート用のカンマ区切り値
TSVformat=tsvタブ区切り値。ブラウザでの表示やスプレッドシートへの貼り付けに最適

ピボットモード(マトリックス形式)

デフォルトでは、APIは日付ごとに1行の時系列データを返します。ピボットモードを使用すると、すべてのリンクのトラフィックをマトリックスとして1回のリクエストで取得できます。

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

Export Data dropdown
Export Data dropdown

リクエストにpivot=link_idを追加すると、次のようなデータが取得できます:

  • 行としての日付(1日あたり1行)
  • 列としてのリンク(リンクごとに1列)

CSV/TSVピボット出力例

My LinkOther Link
nameMy LinkOther Link
full_urlhttps://linkly.link/abchttps://linkly.link/xyz
id123456
2025-12-304512
2025-12-31528
2026-01-013815

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リクエストです。

Export Raw Data
Export Raw Data
Raw Click Data Example
Raw Click Data Example

データエクスポートに関する注意事項

  • エクスポートするデータ量を減らすために、最初にビューでデータをフィルタリングすることを検討してください。この機能は、現在画面に表示されているレポートを生成するために使用された基礎データをエクスポートします。
  • このデータは最大3時間キャッシュされます。このエンドポイントへの繰り返しリクエストでは、リアルタイムのデータは生成されません。

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

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

WebhookはAPI経由でも管理できます - 詳細は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リクエストとしてカウントされます。
  • スキャンされたデータ: リクエストを満たすために当社のアナリティクスデータベースによって処理されるデータ量。より大きな日付範囲とより複雑なクエリは、より多くのデータをスキャンします。

制限を超えた場合

使用制限を超えた場合:

  1. 1APIリクエストは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統合は、無制限プランのお客様には無料で、他のプランでは月額$100のアドオンとして利用できます。

BigQuery統合の詳細を見る →

関連

月500クリックまで追跡、すべての機能を含む。

クレジットカードは不要です