Linklyの分析API

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

関連: リンク短縮API | Webhooks

始める前に

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

時間を節約して、私たちに任せてください。当社のAPIは完全にマシンで利用可能です。

認可

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

トラフィックレポートAPI

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

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

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

出力形式

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

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

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

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

リクエストにpivot=link_idを追加して、以下のデータを取得します。

• 日付が行（1日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を追加して、各リンクを個別にクエリするのではなく、単一のリクエストですべてのリンクのトラフィックを取得します。
• レスポンスをキャッシュ: APIレスポンスをローカルに保存して、同じデータを繰り返しフェッチしません。
• より小さい日付範囲を使用: 必要な日付のみをクエリします。
• リクエストをバッチ: link_idsパラメータを使用して、複数のリンククエリを単一のリクエストに組み合わせます。

さらに必要ですか？

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

BigQuery統合

大容量の分析ニーズについては、LinklyはBigQuery統合を提供します。これはクリックデータへの直接SQLアクセスを提供します。

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

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

BigQuery統合の詳細を確認 →

関連

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