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統合はEnterpriseプランに含まれています。詳細はお問い合わせください。

BigQuery統合の詳細を確認 →

関連

• リンク短縮API - プログラムでリンクを作成および更新する
• Webhooks - リアルタイムクリック通知
• BigQuery統合 - クリックデータへのダイレクトSQLアクセス
• Zapier統合 - ノーコード統合