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リンクにつき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を参照してください。Webhooksは、クリックが発生するとすぐに、クリックに関する詳細情報とともに、指定されたURLにPOSTリクエストを送信します。

API経由でWebhooksを管理することもできます - 詳細は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はクリックデータへのSQL直接アクセスを提供するBigQuery統合を提供しています。

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

BigQuery統合は、無制限プランのお客様は無料、他のプランは月額100ドルのアドオンとして利用可能です。

BigQuery統合の詳細はこちら →

関連

Track 1000 monthly clicks with all features included.

No credit card required