Api documentation

Metric

Receiving metrics for selected date range

Request

GET http://api.truesocialmetrics.com/gamma/metric/f84b188cdb114f7f67428c5c54ba5660?from=1392029313&to=1392634103&source=twitter&api_user=x@x.com&api_key=2999cccf4896592ebafc8cecdee529

or the same with CURL

curl http://api.truesocialmetrics.com/gamma/metric/f84b188cdb114f7f67428c5c54ba5660?from=1392029313&to=1392634103&source=twitter&$TT_AUTH

f84b188cdb114f7f67428c5c54ba5660 - account id, from Account list
twitter - unique source id, from Source list
from=1392029313 to=1392634103 - daterange for analyze in unix timestamp format (notice: from < to).

Insted of using from:to for daterange you can use string representation from_str:to_str
1. YYYYMMDD format e.q. "20140730"
2. Mocks - "today", "yesterday", "monday", "april"
3. Shift pointers - "last monday", "last friday", "-1 month", "-2 weeks", "-4 days"

GET http://api.truesocialmetrics.com/gamma/metric/f84b188cdb114f7f67428c5c54ba5660?from_str=-1%20month&to_str=yesterday&source=twitter&api_user=x@x.com&api_key=2999cccf4896592ebafc8cecdee529

Response

Data is not ready yet, you can re-call api in 2-5 seconds.

{
    "status": "in process",
    "id": "f84b188cdb114f7f67428c5c54ba5660",
    "response": {
        "posts": 0,
        "replies": 0,
        "reshares": 0,
        "favorites": 0,
        "followers": 0,
        "conversation_rate": "0.00",
        "amplification_rate": "0.00",
        "applause_rate": "0.00"
    }
}

Analyzing is done.

{
    "status": "ok",
    "id": "f84b188cdb114f7f67428c5c54ba5660",
    "response": {
        "posts": 18,
        "replies": 1,
        "reshares": 40,
        "favorites": 20,
        "followers": 1234,
        "conversation_rate": "0.06",
        "amplification_rate": "2.22",
        "applause_rate": "1.11"
    }
}