Total Fans by Country

Audience geographical distribution for each Fanpage


Group fans by country

Entry-point

/account/:account/project/:project/facebook/fans/total/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/total/country?since=2015-01-19&until=2015-02-17&timezone=America%2FArgentina%2FBuenos_Aires&ids=84917688371,'

Sample Response

{
  "query": {
    "id": "/facebook/fans/total/country",
    "filters": {
      "timezone": "America/Argentina/Buenos_Aires",
      "ids": [
        "84917688371",
        "108586582757"
      ],
      "owner": null,
      "type": null,
      "interactionType": null,
      "countries": null,
      "since": "2015-01-19",
      "until": "2015-02-17"
    }
  },
  "results": [
    {
      "id": "84917688371",
      "data": [
        {
          "id": "US",
          "count": 4112667
        },
        {
          "id": "IN",
          "count": 3443900
        },
        {
          "id": "MX",
          "count": 2575493
        },
        {
          "id": "BR",
          "count": 2284594
        },
        {
          "id": "PH",
          "count": 1673029
        },
        {
          "id": "AR",
          "count": 1022485
        },
        {
          "id": "CO",
          "count": 959566
        },
        {
          "id": "ID",
          "count": 849955
        },
        {
          "id": "PK",
          "count": 730512
        },
        {
          "id": "TR",
          "count": 663091
        },
        {
          "id": "EG",
          "count": 635501
        },
        {
          "id": "PE",
          "count": 619904
        },
        {
          "id": "VE",
          "count": 567659
        },
        {
          "id": "EC",
          "count": 530910
        },
        {
          "id": "CL",
          "count": 510195
        },
        {
          "id": "BD",
          "count": 462632
        },
        {
          "id": "TH",
          "count": 455333
        },
        {
          "id": "MY",
          "count": 451512
        },
        {
          "id": "RO",
          "count": 443934
        },
        {
          "id": "VN",
          "count": 435411
        },
        {
          "id": "PL",
          "count": 303199
        },
        {
          "id": "MA",
          "count": 205909
        },
        {
          "id": "TW",
          "count": 195677
        },
        {
          "id": "GB",
          "count": 192908
        },
        {
          "id": "NP",
          "count": 177076
        },
        {
          "id": "DZ",
          "count": 164469
        },
        {
          "id": "GT",
          "count": 154121
        },
        {
          "id": "DO",
          "count": 146830
        },
        {
          "id": "HU",
          "count": 136573
        },
        {
          "id": "TN",
          "count": 129193
        },
        {
          "id": "RS",
          "count": 121610
        },
        {
          "id": "IQ",
          "count": 118672
        },
        {
          "id": "SV",
          "count": 117991
        },
        {
          "id": "CR",
          "count": 116888
        },
        {
          "id": "BG",
          "count": 113889
        },
        {
          "id": "BO",
          "count": 108903
        },
        {
          "id": "UY",
          "count": 108038
        },
        {
          "id": "IT",
          "count": 107976
        },
        {
          "id": "KH",
          "count": 105979
        },
        {
          "id": "SY",
          "count": 105239
        },
        {
          "id": "CA",
          "count": 102053
        },
        {
          "id": "JO",
          "count": 98561
        },
        {
          "id": "FR",
          "count": 97857
        },
        {
          "id": "SA",
          "count": 96051
        },
        {
          "id": "LK",
          "count": 93414
        }
      ]
    },
    {
      "id": "108586582757",
      "data": [
        {
          "id": "MX",
          "count": 1972205
        },
        {
          "id": "AR",
          "count": 1025100
        },
        {
          "id": "CO",
          "count": 993093
        },
        {
          "id": "VE",
          "count": 850118
        },
        {
          "id": "PE",
          "count": 633674
        },
        {
          "id": "CL",
          "count": 446786
        },
        {
          "id": "EC",
          "count": 345384
        },
        {
          "id": "BR",
          "count": 303136
        },
        {
          "id": "GT",
          "count": 167171
        },
        {
          "id": "CR",
          "count": 142263
        },
        {
          "id": "BO",
          "count": 132185
        },
        {
          "id": "US",
          "count": 129366
        },
        {
          "id": "DO",
          "count": 121353
        },
        {
          "id": "PY",
          "count": 111863
        },
        {
          "id": "SV",
          "count": 89692
        },
        {
          "id": "UY",
          "count": 87119
        },
        {
          "id": "HN",
          "count": 75506
        },
        {
          "id": "ES",
          "count": 64234
        },
        {
          "id": "NI",
          "count": 58841
        },
        {
          "id": "PA",
          "count": 38594
        },
        {
          "id": "PR",
          "count": 17759
        },
        {
          "id": "GB",
          "count": 9335
        },
        {
          "id": "FR",
          "count": 8364
        },
        {
          "id": "TR",
          "count": 7800
        },
        {
          "id": "IT",
          "count": 6791
        },
        {
          "id": "IN",
          "count": 5012
        },
        {
          "id": "CA",
          "count": 3728
        },
        {
          "id": "PH",
          "count": 3050
        },
        {
          "id": "CD",
          "count": 2561
        },
        {
          "id": "DE",
          "count": 2517
        },
        {
          "id": "EG",
          "count": 2359
        },
        {
          "id": "DZ",
          "count": 2345
        },
        {
          "id": "ID",
          "count": 2319
        },
        {
          "id": "MA",
          "count": 2019
        },
        {
          "id": "BD",
          "count": 1960
        },
        {
          "id": "KR",
          "count": 1960
        },
        {
          "id": "JP",
          "count": 1916
        },
        {
          "id": "RO",
          "count": 1676
        },
        {
          "id": "PT",
          "count": 1654
        },
        {
          "id": "IQ",
          "count": 1645
        },
        {
          "id": "CU",
          "count": 1539
        },
        {
          "id": "PK",
          "count": 1382
        },
        {
          "id": "TN",
          "count": 1233
        },
        {
          "id": "AZ",
          "count": 1086
        },
        {
          "id": "AU",
          "count": 1016
        }
      ]
    }
  ]
}