Social Analytics API v1
Introduction Campaigns Report Entries Users

Users

GET
/campaigns/campaign-id/users

Get all campaign users.

Query parameters

count Set the number of users to return per response
sort Set the criteria for sorting users. Possible values: followers, following, score, username, user_id, item_score_sum, posts_published, posted_items_count
reverse Reverse the order of returned users
user_type Return only users of selected type. Possible values: instagram, twitter, facebook
start_date Return users who have contibuted after this date
end_date Return users who have contibuted before this date
GET https://analytics-api.flockler.com/v1/campaigns/92/users 
{
  "meta": {
    "total_count": 40,
    "count": 9
  },
  "pagination": {
    "base": "https://analytics-api.flockler.com/v1/campaigns/92/users?api_key=618d58d76fcbcbba5333506d6a72ae83&count=9",
    "older": "https://analytics-api.flockler.com/v1/campaigns/92/users?api_key=618d58d76fcbcbba5333506d6a72ae83&count=9&page=2"
  },
  "users": [
    {
      "id": "1729802i",
      "user_id": "-5870383566588633544",
      "username": "rekorderligcider_aus",
      "fullname": "Rekorderlig",
      "bio": "Find us wherever you are in Australia. Enjoy responsibly.",
      "profile_url": "https://instagram.com/rekorderligcider_aus",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/caf56586880729c215697019c4b99e11/5B00FB17/t51.2885-19/s150x150/21148993_890697164413224_8901075547774255104_a.jpg",
      "followers": 18290,
      "following": 7123,
      "posts_published": 1023,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 241.0,
      "stat1_count": 0,
      "stat2_count": 1,
      "stat3_count": 0,
      "items_stat1_sum": 41,
      "items_stat2_sum": 1,
      "items_stat3_sum": 0
    },
    {
      "id": "1729931i",
      "user_id": "278097582946528959",
      "username": "thehopfactory",
      "fullname": "The Hop Factory",
      "bio": "Craft Beer Bar 🍺 || Restaurant 🍴 || Events & Functions 🎉 Tag us #thehopfactory 📸 \nPh: 02 4929 4854",
      "profile_url": "https://instagram.com/thehopfactory",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/428a99719d8e95ea9a672c73390ad4b1/5AE102A9/t51.2885-19/s150x150/26073866_324407664713082_3565100989172154368_n.jpg",
      "followers": 3354,
      "following": 1429,
      "posts_published": 1756,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 240.0,
      "stat1_count": 2,
      "stat2_count": 0,
      "stat3_count": 0,
      "items_stat1_sum": 85,
      "items_stat2_sum": 1,
      "items_stat3_sum": 0
    },
    {
      "id": "1729942i",
      "user_id": "-390185443126090850",
      "username": "mcgaughsflagstaff",
      "fullname": "McGaughs Flagstaff",
      "bio": "A Craft Beer Store & More\n218 S. San Francisco St.\n Flagstaff, AZ. 86001\n Tel. 928-226-0100\nwww.mcgaughsflagstaff.com",
      "profile_url": "https://instagram.com/mcgaughsflagstaff",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/f124670844c9ba955748e8199fe7574b/5B05375D/t51.2885-19/s150x150/13686920_285292095164290_1447399342_a.jpg",
      "followers": 3621,
      "following": 3246,
      "posts_published": 5855,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 228.0,
      "stat1_count": 1,
      "stat2_count": 1,
      "stat3_count": 0,
      "items_stat1_sum": 38,
      "items_stat2_sum": 9,
      "items_stat3_sum": 0
    },
    {
      "id": "1729868i",
      "user_id": "-3997229771421733192",
      "username": "jamieiri",
      "fullname": "Jamie Richards",
      "bio": "Ex-cocktail barman working in advertising. Drinks | London🍸🌃",
      "profile_url": "https://instagram.com/jamieiri",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/e102fb693edc1a73212ca8d6bc5f8d11/5AFF9AF6/t51.2885-19/s150x150/20634071_266861870466403_3536807140490477568_a.jpg",
      "followers": 353,
      "following": 197,
      "posts_published": 172,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 92.59,
      "stat1_count": 0,
      "stat2_count": 0,
      "stat3_count": 0,
      "items_stat1_sum": 62,
      "items_stat2_sum": 4,
      "items_stat3_sum": 0
    },
    {
      "id": "1729967i",
      "user_id": "7825580775390098685",
      "username": "sidrasomarroza",
      "fullname": "Sidra Somarroza",
      "bio": "🍎Sidra/Cider/Cidre\n🍎Cantabria (Spain)\n🍎sidra@somarroza.es\n👉Cider maker: @misscidermaker",
      "profile_url": "https://instagram.com/sidrasomarroza",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/e83b9d12a4d30c3451ee9ecf9c7d7e24/5AE80ED0/t51.2885-19/s150x150/10838929_1666801150245694_955658752_a.jpg",
      "followers": 628,
      "following": 525,
      "posts_published": 219,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 88.84,
      "stat1_count": 0,
      "stat2_count": 0,
      "stat3_count": 0,
      "items_stat1_sum": 65,
      "items_stat2_sum": 1,
      "items_stat3_sum": 0
    },
    {
      "id": "1729800i",
      "user_id": "6305880885808630561",
      "username": "reemapere",
      "fullname": "Reema Pereira",
      "bio": "📍Indian 🇮🇳, Born and Raised in Dubai 🇦🇪, currently in UK 🇬🇧 | 👩🏻‍💻Environmental Scientist | 👻 reemapere",
      "profile_url": "https://instagram.com/reemapere",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/8ef10a57f0c3f4c5812bbadc23dbe0f2/5AEB0B55/t51.2885-19/s150x150/14676714_218977675204796_7169785109908815872_a.jpg",
      "followers": 1181,
      "following": 929,
      "posts_published": 419,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 86.43,
      "stat1_count": 1,
      "stat2_count": 0,
      "stat3_count": 0,
      "items_stat1_sum": 51,
      "items_stat2_sum": 0,
      "items_stat3_sum": 0
    },
    {
      "id": "1729914i",
      "user_id": "-1635229010689390943",
      "username": "livingspacemag",
      "fullname": "Livingspace Magazine",
      "bio": "Livingspace is a decor, DIY and lifestyle magazine with everything you need to know about the latest decor, gardening and entertaining trends.",
      "profile_url": "https://instagram.com/livingspacemag",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/d9522ea6637830c0e417e4dac3e37e3c/5B20FE41/t51.2885-19/s150x150/26155203_1815991738445308_4981946434526904320_n.jpg",
      "followers": 1381,
      "following": 68,
      "posts_published": 740,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 74.43,
      "stat1_count": 0,
      "stat2_count": 0,
      "stat3_count": 0,
      "items_stat1_sum": 33,
      "items_stat2_sum": 0,
      "items_stat3_sum": 0
    },
    {
      "id": "1730154i",
      "user_id": "7312318122859546032",
      "username": "piggy5uh",
      "fullname": "Piggy",
      "bio": "London Eats 🇬🇧",
      "profile_url": "https://instagram.com/piggy5uh",
      "profile_picture_url": "https://scontent-cdg2-1.cdninstagram.com/vp/b82467199d6e8fa831caefaf8fefbe6b/5AF6257A/t51.2885-19/11906329_960233084022564_1448528159_a.jpg",
      "followers": 1080,
      "following": 536,
      "posts_published": 328,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 70.21,
      "stat1_count": 0,
      "stat2_count": 0,
      "stat3_count": 0,
      "items_stat1_sum": 81,
      "items_stat2_sum": 1,
      "items_stat3_sum": 0
    },
    {
      "id": "1729843i",
      "user_id": "-8221627585700737631",
      "username": "mokai_official",
      "fullname": "MOKAÏ",
      "bio": "The content of this profile is for consumers of legal drinking age only. #DiamantKampagne 💎 Læs mere:",
      "profile_url": "https://instagram.com/mokai_official",
      "profile_picture_url": "https://scontent.cdninstagram.com/vp/18b70fd3366a53297a78b5df7d9c51e0/5B202CE6/t51.2885-19/s150x150/14718046_109610506181833_3305844943435595776_a.jpg",
      "followers": 6092,
      "following": 1,
      "posts_published": 771,
      "posted_items_count": 1,
      "post_count": 1,
      "user_type": "instagram",
      "score": 10.0,
      "item_score_sum": 300.0,
      "stat1_count": 0,
      "stat2_count": 0,
      "stat3_count": 0,
      "items_stat1_sum": 100,
      "items_stat2_sum": 0,
      "items_stat3_sum": 0
    }
  ]
}
Field Data type Description values
bio string This user's bio
followers integer The amount of followers of this user. Only available for Twitter entries. Facebook and Instagram don't publish this information for privacy reasons.
following integer The amount of users this user is following. Only available for Twitter entries. Facebook and Instagram don't publish this information for privacy reasons.
fullname string Full name of this user. Not available for Instagram users due to privacy reasons.
id string ID of this entry
posted_items_count integer Amount of posts by this user related to this campaign
posts_published integer Total amount of posts this user has made. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information.
profile_picture_url string URL of this user's profile picture. Only available for Twitter entries and some Facebook entries. Instagram and Facebook partially restrict 3rd party access to this information.
profile_url string URL of this user's profile in the originating service
username string Username of this user
user_id string ID of this user in the originating service (e.g. Twitter) Global IDs not available for Facebook users due to 3rd party restrictions.
user_type string Type of this user twitter, instagram, facebook
score float Score calculated for this user based on the amount of content related to this campaign.
stat1 none Not available.
stat2 integer Campaign-related replies given. Only available for Twitter users
GET
/campaigns/campaign-id/users/id

Get single user.

GET https://analytics-api.flockler.com/v1/campaigns/92/users/1729931i 
{
  "id": "1729931i",
  "user_id": "278097582946528959",
  "username": "thehopfactory",
  "fullname": "The Hop Factory",
  "bio": "Craft Beer Bar 🍺 || Restaurant 🍴 || Events & Functions 🎉 Tag us #thehopfactory 📸 \nPh: 02 4929 4854",
  "profile_url": "https://instagram.com/thehopfactory",
  "profile_picture_url": "https://scontent.cdninstagram.com/vp/428a99719d8e95ea9a672c73390ad4b1/5AE102A9/t51.2885-19/s150x150/26073866_324407664713082_3565100989172154368_n.jpg",
  "followers": 3354,
  "following": 1429,
  "posts_published": 1756,
  "posted_items_count": 1,
  "user_type": "instagram",
  "score": 10.0,
  "stat1_count": 2,
  "stat2_count": 0,
  "stat3_count": 0,
  "items_stat1_sum": 85,
  "items_stat2_sum": 1,
  "items_stat3_sum": 0
}
Field Data type Description values
bio string This user's bio
followers integer The amount of followers of this user. Only available for Twitter entries. Facebook and Instagram don't publish this information for privacy reasons.
following integer The amount of users this user is following. Only available for Twitter entries. Facebook and Instagram don't publish this information for privacy reasons.
fullname string Full name of this user. Not available for Instagram users due to privacy reasons.
id string ID of this entry
posted_items_count integer Amount of posts by this user related to this campaign
posts_published integer Total amount of posts this user has made. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information.
profile_picture_url string URL of this user's profile picture. Only available for Twitter entries and some Facebook entries. Instagram and Facebook partially restrict 3rd party access to this information.
profile_url string URL of this user's profile in the originating service
username string Username of this user
user_id string ID of this user in the originating service (e.g. Twitter) Global IDs not available for Facebook users due to 3rd party restrictions.
user_type string Type of this user twitter, instagram, facebook
score float Score calculated for this user based on the amount of content related to this campaign.
stat1 none Not available.
stat2 integer Campaign-related replies given. Only available for Twitter users
GET
/campaigns/campaign-id/users/user-type/user-id

Get single user by external service id. This endpoint redirects (302) to the /campaigns/:campaign-id/users/:id endpoint.

GET https://analytics-api.flockler.com/v1/campaigns/92/users/instagram/503239627 
{
  "error": "Invalid id"
}
Field Data type Description values
bio string This user's bio
followers integer The amount of followers of this user. Only available for Twitter entries. Facebook and Instagram don't publish this information for privacy reasons.
following integer The amount of users this user is following. Only available for Twitter entries. Facebook and Instagram don't publish this information for privacy reasons.
fullname string Full name of this user. Not available for Instagram users due to privacy reasons.
id string ID of this entry
posted_items_count integer Amount of posts by this user related to this campaign
posts_published integer Total amount of posts this user has made. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information.
profile_picture_url string URL of this user's profile picture. Only available for Twitter entries and some Facebook entries. Instagram and Facebook partially restrict 3rd party access to this information.
profile_url string URL of this user's profile in the originating service
username string Username of this user
user_id string ID of this user in the originating service (e.g. Twitter) Global IDs not available for Facebook users due to 3rd party restrictions.
user_type string Type of this user twitter, instagram, facebook
score float Score calculated for this user based on the amount of content related to this campaign.
stat1 none Not available.
stat2 integer Campaign-related replies given. Only available for Twitter users