Fans Metrics Summary by Country

Audience geographic metrics for each Fanpage


Get metrics for your audience, grouped by country

Entry-point

/account/:account/project/:project/facebook/fans/stat-summary/country?
  since=:START_DATE
  until=:END_DATE
  ids=:PROFILES
  timezone=:TIMEZONE
Parameters Description Sample
ACCOUNT_ID Account Id provided by /authentication 724
PROJECT_ID Project Id provided by /projects 3
START_DATE Beginning of period, date in format yyyy-MM-dd (inclusive) 2015-01-19
END_DATE End of period, date in format yyyy-MM-dd (exclusive) 2015-02-17
PROFILES A list of fanpage ids separated by comma 84917688371,108586582757
TIMEZONE A timezone -- check the complete list here America/Argentina/Buenos_Aires

Sample Request

export ACCOUNT_ID=724
export PROJECT_ID=3

curl  -H"X-Auth-Token:${TOKEN}" 'https://api.quantum.socialmetrix.com/account/724/project/3/facebook/fans/stat-summary/country?since=2015-01-19&until=2015-02-17&timezone=America%2FArgentina%2FBuenos_Aires&ids=84917688371,108586582757'

Sample Response

{
  "query": {
    "id": "/facebook/fans/stat-summary/country",
    "filters": {
      "timezone": "America/Los_Angeles",
      "ids": [
        "84917688371",
        "108586582757"
      ],
      "owner": null,
      "type": null,
      "interactionType": null,
      "countries": null,
      "since": "2015-01-19",
      "until": "2015-02-17"
    }
  },
  "results": [
    {
      "id": "84917688371",
      "data": [
        {
          "id": "JO",
          "data": {
            "totalFans": 98561,
            "newFans": 1050,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "BR",
          "data": {
            "totalFans": 2284594,
            "newFans": 11018,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "EC",
          "data": {
            "totalFans": 530910,
            "newFans": 225,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "VN",
          "data": {
            "totalFans": 435411,
            "newFans": 2062,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "TH",
          "data": {
            "totalFans": 455333,
            "newFans": 1569,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "GB",
          "data": {
            "totalFans": 192908,
            "newFans": 2078,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "TN",
          "data": {
            "totalFans": 129193,
            "newFans": 750,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "RO",
          "data": {
            "totalFans": 443934,
            "newFans": -890,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "CA",
          "data": {
            "totalFans": 102053,
            "newFans": 830,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "NP",
          "data": {
            "totalFans": 177076,
            "newFans": 1562,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "TR",
          "data": {
            "totalFans": 663091,
            "newFans": 866,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "DZ",
          "data": {
            "totalFans": 164469,
            "newFans": 1615,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "HU",
          "data": {
            "totalFans": 136573,
            "newFans": -110,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "VE",
          "data": {
            "totalFans": 567659,
            "newFans": -346,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "FR",
          "data": {
            "totalFans": 97857,
            "newFans": 513,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "BG",
          "data": {
            "totalFans": 113889,
            "newFans": -31,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "SV",
          "data": {
            "totalFans": 117991,
            "newFans": 38,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "DO",
          "data": {
            "totalFans": 146830,
            "newFans": -219,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "SY",
          "data": {
            "totalFans": 105239,
            "newFans": 433,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "BD",
          "data": {
            "totalFans": 462632,
            "newFans": 8421,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "ID",
          "data": {
            "totalFans": 849955,
            "newFans": 4623,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "BO",
          "data": {
            "totalFans": 108903,
            "newFans": 36,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "KH",
          "data": {
            "totalFans": 105979,
            "newFans": 544,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "UY",
          "data": {
            "totalFans": 108038,
            "newFans": -183,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "MA",
          "data": {
            "totalFans": 205909,
            "newFans": 2792,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "MX",
          "data": {
            "totalFans": 2575493,
            "newFans": 395,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "US",
          "data": {
            "totalFans": 4112667,
            "newFans": 7542,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "AR",
          "data": {
            "totalFans": 1022485,
            "newFans": -356,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "IN",
          "data": {
            "totalFans": 3443900,
            "newFans": 45337,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "MY",
          "data": {
            "totalFans": 451512,
            "newFans": 290,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "IQ",
          "data": {
            "totalFans": 118672,
            "newFans": 1227,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "IT",
          "data": {
            "totalFans": 107976,
            "newFans": 206,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "PT",
          "data": {
            "totalFans": 93153,
            "newFans": 0,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "PL",
          "data": {
            "totalFans": 303199,
            "newFans": -147,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "RS",
          "data": {
            "totalFans": 121610,
            "newFans": -157,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "GT",
          "data": {
            "totalFans": 154121,
            "newFans": 134,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "PH",
          "data": {
            "totalFans": 1673029,
            "newFans": 8018,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "PK",
          "data": {
            "totalFans": 730512,
            "newFans": 9040,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "CR",
          "data": {
            "totalFans": 116888,
            "newFans": -20,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "PE",
          "data": {
            "totalFans": 619904,
            "newFans": 42,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "EG",
          "data": {
            "totalFans": 635501,
            "newFans": 8646,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "LK",
          "data": {
            "totalFans": 93414,
            "newFans": 0,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "CO",
          "data": {
            "totalFans": 959566,
            "newFans": -324,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "SA",
          "data": {
            "totalFans": 96051,
            "newFans": 1225,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "TW",
          "data": {
            "totalFans": 195677,
            "newFans": -165,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "CL",
          "data": {
            "totalFans": 510195,
            "newFans": -670,
            "lastDayUniqueUsers": 0
          }
        }
      ]
    },
    {
      "id": "108586582757",
      "data": [
        {
          "id": "HN",
          "data": {
            "totalFans": 75506,
            "newFans": 1350,
            "lastDayUniqueUsers": 154
          }
        },
        {
          "id": "EC",
          "data": {
            "totalFans": 345384,
            "newFans": 3943,
            "lastDayUniqueUsers": 718
          }
        },
        {
          "id": "RO",
          "data": {
            "totalFans": 1676,
            "newFans": 9,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "DZ",
          "data": {
            "totalFans": 2345,
            "newFans": 11,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "VE",
          "data": {
            "totalFans": 850118,
            "newFans": 9814,
            "lastDayUniqueUsers": 910
          }
        },
        {
          "id": "DO",
          "data": {
            "totalFans": 121353,
            "newFans": 692,
            "lastDayUniqueUsers": 172
          }
        },
        {
          "id": "DE",
          "data": {
            "totalFans": 2517,
            "newFans": 64,
            "lastDayUniqueUsers": 5
          }
        },
        {
          "id": "ID",
          "data": {
            "totalFans": 2319,
            "newFans": 34,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "UY",
          "data": {
            "totalFans": 87119,
            "newFans": 506,
            "lastDayUniqueUsers": 111
          }
        },
        {
          "id": "MA",
          "data": {
            "totalFans": 2019,
            "newFans": 28,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "AR",
          "data": {
            "totalFans": 1025100,
            "newFans": 8475,
            "lastDayUniqueUsers": 1913
          }
        },
        {
          "id": "MX",
          "data": {
            "totalFans": 1972205,
            "newFans": 21996,
            "lastDayUniqueUsers": 4465
          }
        },
        {
          "id": "US",
          "data": {
            "totalFans": 129366,
            "newFans": 1761,
            "lastDayUniqueUsers": 202
          }
        },
        {
          "id": "IN",
          "data": {
            "totalFans": 5012,
            "newFans": 96,
            "lastDayUniqueUsers": 3
          }
        },
        {
          "id": "AU",
          "data": {
            "totalFans": 1016,
            "newFans": 0,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "IQ",
          "data": {
            "totalFans": 1645,
            "newFans": 10,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "IR",
          "data": {
            "totalFans": 1013,
            "newFans": 0,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "AZ",
          "data": {
            "totalFans": 1086,
            "newFans": 10,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "IT",
          "data": {
            "totalFans": 6791,
            "newFans": 96,
            "lastDayUniqueUsers": 9
          }
        },
        {
          "id": "MT",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 1
          }
        },
        {
          "id": "PT",
          "data": {
            "totalFans": 1654,
            "newFans": 13,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "NG",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 3
          }
        },
        {
          "id": "NI",
          "data": {
            "totalFans": 58841,
            "newFans": 1092,
            "lastDayUniqueUsers": 89
          }
        },
        {
          "id": "ES",
          "data": {
            "totalFans": 64234,
            "newFans": 39,
            "lastDayUniqueUsers": 87
          }
        },
        {
          "id": "PR",
          "data": {
            "totalFans": 17759,
            "newFans": 122,
            "lastDayUniqueUsers": 32
          }
        },
        {
          "id": "NL",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 3
          }
        },
        {
          "id": "EG",
          "data": {
            "totalFans": 2359,
            "newFans": 12,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "PY",
          "data": {
            "totalFans": 111863,
            "newFans": 1743,
            "lastDayUniqueUsers": 297
          }
        },
        {
          "id": "AN",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 1
          }
        },
        {
          "id": "JP",
          "data": {
            "totalFans": 1916,
            "newFans": 18,
            "lastDayUniqueUsers": 3
          }
        },
        {
          "id": "BR",
          "data": {
            "totalFans": 303136,
            "newFans": 3058,
            "lastDayUniqueUsers": 218
          }
        },
        {
          "id": "GB",
          "data": {
            "totalFans": 9335,
            "newFans": 80,
            "lastDayUniqueUsers": 15
          }
        },
        {
          "id": "TN",
          "data": {
            "totalFans": 1233,
            "newFans": 7,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "CA",
          "data": {
            "totalFans": 3728,
            "newFans": 62,
            "lastDayUniqueUsers": 4
          }
        },
        {
          "id": "TR",
          "data": {
            "totalFans": 7800,
            "newFans": -39,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "FR",
          "data": {
            "totalFans": 8364,
            "newFans": 15,
            "lastDayUniqueUsers": 7
          }
        },
        {
          "id": "SV",
          "data": {
            "totalFans": 89692,
            "newFans": 1280,
            "lastDayUniqueUsers": 220
          }
        },
        {
          "id": "BD",
          "data": {
            "totalFans": 1960,
            "newFans": 54,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "BO",
          "data": {
            "totalFans": 132185,
            "newFans": 2174,
            "lastDayUniqueUsers": 322
          }
        },
        {
          "id": "CZ",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 1
          }
        },
        {
          "id": "SE",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 1
          }
        },
        {
          "id": "KR",
          "data": {
            "totalFans": 1960,
            "newFans": -1,
            "lastDayUniqueUsers": 1
          }
        },
        {
          "id": "CV",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 1
          }
        },
        {
          "id": "CU",
          "data": {
            "totalFans": 1539,
            "newFans": -1,
            "lastDayUniqueUsers": 3
          }
        },
        {
          "id": "SR",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "GT",
          "data": {
            "totalFans": 167171,
            "newFans": 3283,
            "lastDayUniqueUsers": 488
          }
        },
        {
          "id": "CH",
          "data": {
            "totalFans": 0,
            "newFans": 0,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "PH",
          "data": {
            "totalFans": 3050,
            "newFans": 31,
            "lastDayUniqueUsers": 2
          }
        },
        {
          "id": "CD",
          "data": {
            "totalFans": 2561,
            "newFans": 15,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "PK",
          "data": {
            "totalFans": 1382,
            "newFans": 12,
            "lastDayUniqueUsers": 0
          }
        },
        {
          "id": "PE",
          "data": {
            "totalFans": 633674,
            "newFans": 7873,
            "lastDayUniqueUsers": 1255
          }
        },
        {
          "id": "CR",
          "data": {
            "totalFans": 142263,
            "newFans": 1673,
            "lastDayUniqueUsers": 331
          }
        },
        {
          "id": "CO",
          "data": {
            "totalFans": 993093,
            "newFans": 13295,
            "lastDayUniqueUsers": 2094
          }
        },
        {
          "id": "PA",
          "data": {
            "totalFans": 38594,
            "newFans": 576,
            "lastDayUniqueUsers": 53
          }
        },
        {
          "id": "CL",
          "data": {
            "totalFans": 446786,
            "newFans": 4342,
            "lastDayUniqueUsers": 1070
          }
        }
      ]
    }
  ]
}