Social Counter

Count the number of curated social items. For a complete list of available endpoints, please see the Livefyre API Reference section.

The Social Counter API returns counts for matched curation rules in a given collection for intervals over a period of time.

NOTE

This API is available only for Twitter hashtags.

Social Counter API:

  • Resource
  • Rule Types
  • Response

Resource

GET https://{networkName}.bootstrap.fyre.co/api/v3.0/stats.collections.curate/{query}.json
  • networkName: Your Livefyre provided network name. For example: labs in labs.fyre.co.

  • query: The url-safe base64 encoded hash of all the site, article ID, rule-type tuples for which count information should be fetched (pre-encoded)

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

    Query is limited to 10 site, article ID, rule-type tuples. (The previous example would contain 3 tuples.)

  • from (optional) specifies the relative or absolute time period to graph; from specifies the beginning and defaults to 24 hours ago, if omitted.

  • until (optional) specifies the relative or absolute time period to graph; until specifies the beginning and defaults to the current time (now), if omitted.

Relative Time

Abbreviation Unit
s Seconds
min Minutes
h Hours
d Days
w Weeks
mon 30 Days (Month)
y 365 Days (Year)

Example:

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

Absolute Time

FORMAT: HH:MM_YYYYMMDD

Abbreviation Meaning
HH Hours (in 24h clock format)
MM Minutes
YYYY 4-Digit Year
MM Month
DD Day

Example:

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

Rule Types

Value Type
2 Twitter

Example:

To obtain counts over the last minute for site 123456 and article ID some-article-id and rule-type 2, for example: 123456:some-article-id;2:

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

Example Response:

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

On this page