ソーシャルカウンタ

キュレーションされたソーシャルアイテムの数をカウントします。 使用可能なエンドポイントの完全なリストについては、Livefyre APIリファレンスの節を参照してください。

SocialカウンターAPIは、特定のコレクション内の一致したキュレーションルールに対するカウントを一定期間の間隔で返します。

メモ

このAPIは、Twitterのハッシュタグに対してのみ利用できます。

ソーシャルカウンタAPI:

  • リソース
  • ルールタイプ
  • 応答

リソース

GET https://{networkName}.bootstrap.fyre.co/api/v3.0/stats.collections.curate/{query}.json
  • networkName:Livefyre が提供するネットワーク名。次に例を示します。labs in labs.fyre.co.

  • クエリ: すべてのサイトのURLセーフベース64エンコードされたハッシュ。記事ID、ルールタイプのタプル。カウント情報を取得(事前にエンコード)

    {site ID}:{article ID};{rule-type},  {article ID};{rule-type}|{site ID}:{article ID};{rule-type}
    
    メモ

    クエリは、10個のサイト、記事ID、ルールタイプのタプルに制限されます。 (前の例では、3つのタプルが含まれています)。

  • (optional) fromグラフに対する相対期間または絶対期間を指定します。fromは最初を指定し、省略した場合はデフォルトで24時間前に設定します。

  • グラフの相対期間または絶対期間を (optional) untill:指定します。untilは開始を指定し、省略した場合は現在時間(現在)をデフォルトにします。

相対時間

略語 単位
s
min
h 時間
d
w 週間
mon 30日(月)
y 365日(年)

例:

https://labs-t402.bootstrap.fyre.co/api/v3.0/stats.collections.curate/MTIzNDU2OnNvbWUtYXJ0aWNsZS1pZDsy.json&from=-7d&until=-6d

絶対時間

形式:HH:MM_YYYYMMDD

略語 意味
HH 時間(24時間形式)
MM
YYYY 4桁表記の年
MM
DD

例:

https://labs-t402.bootstrap.fyre.co/api/v3.0/stats.collections.curate/MTIzNDU2OnNvbWUtYXJ0aWNsZS1pZDsy.json&from=04:00_20130709 

ルールタイプ

タイプ
2 Twitter

例:

サイト123456、記事ID some-article-id、ルールタイプ2の直近の1分間のカウントを取得するには、次のように指定します。123456:some-article-id;2:

curl -XGET "https://labs-t402.bootstrap.fyre.co/api/v3.0/stats.collections.curate/MTIzNDU2OnNvbWUtYXJ0aWNsZS1pZDsy.json&from=-1min" 

応答の例:

{ 
    "status": "ok", 
    "code": 200, 
    "data": { 
        "123456": { 
            "some-article-id": { 
                "2": [ 
                    [ 
                        2, 
                        1374770460 
                    ], 
                    [ 
                        4, 
                        1374770470 
                    ], 
                    [ 
                        3, 
                        1374770480 
                    ], 
                    [ 
                        1, 
                        1374770490 
                    ], 
                    [ 
                        0, 
                        1374770500 
                    ], 
                    [ 
                        7, 
                        1374770510 
                    ] 
                ] 
            } 
        } 
    } 
}

このページ