Entries
GET
/campaigns/campaign-id/entries
Get all campaign entries.
Query parameters
count |
Set the number of entries to return per response |
|---|---|
sort |
Set the criteria for sorting entries. Possible values: published_at (default), score, item_id, stat1 (likes), stat2 (comments/replies), stat3 (shares/retweets) |
reverse |
Reverse the order of returned entries |
item_type |
Return only items of selected type. Possible values: instagram, twitter, facebook |
start_date |
Return entries posted after this date |
end_date |
Return entries posted before this date |
Examples
GET https://analytics-api.flockler.com/v1/campaigns/92/entries
{
"meta": {
"total_count": 40,
"count": 9
},
"pagination": {
"base": "https://analytics-api.flockler.com/v1/campaigns/92/entries?api_key=618d58d76fcbcbba5333506d6a72ae83&count=9",
"older": "https://analytics-api.flockler.com/v1/campaigns/92/entries?api_key=618d58d76fcbcbba5333506d6a72ae83&count=9&page=2"
},
"entries": [
{
"id": "77533i",
"item_id": "1278122143431192819_1737814539",
"item_url": "https://www.instagram.com/p/BG8zVFSxvDz/",
"image_url": "https://media-api.flockler.com/instagram/image/1278122143431192819",
"text": "Event ahead! On your way down to the Truffle Kerfuffle this weekend, why not checkout what's happening at the @bridgetowninthewinter festival? π»",
"post_type": null,
"published_at": "2016-06-22T08:27:34.000Z",
"username": "thecidery_",
"item_type": "instagram",
"flockler_article_id": 4334955,
"flockler_article_ids": [
4334955
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T10:52:20.797Z",
"last_data_update_failure_reason": {
"code": "ActiveRecord::RecordNotFound",
"message": null,
"details": "Couldn't find Campaign without an ID"
},
"stat1": 24,
"stat2": 1,
"stat3": 0,
"score": 21.76,
"analytics_user_id": "1730095i",
"user_id": "-7318524203791262316",
"user_profile_url": "https://instagram.com/thecidery_",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/dd07714c8b48639532de589f9d267077/5AE65F9C/t51.2885-19/11192902_1609492269297612_1661701381_a.jpg",
"followers": 431,
"following": 167,
"posts_published": 52,
"incomplete": false,
"users_in_photo": [
{
"user": {
"id": "-4534316605032252740",
"username": "fontyspool",
"fullname": "Fontys Pool Manjimup",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/11176421_1418999708409365_1678972231_a.jpg"
},
"position": {
"x": 0.1921875,
"y": 0.8375
}
},
{
"user": {
"id": "1052982107080453405",
"username": "trufflekerfuffle",
"fullname": "Truffle Kerfuffle",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/11374479_840704552688393_45958078_a.jpg"
},
"position": {
"x": 0.696875,
"y": 0.625
}
}
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77535i",
"item_id": "1278120636388245068_3026905286",
"item_url": "https://www.instagram.com/p/BG8y_JwBH5M/",
"image_url": "https://media-api.flockler.com/instagram/image/1278120636388245068",
"text": "#Repost @thehopfactory\nγ»γ»γ»\nThe heat is on!!! Come and warm up, have a π and a πΊand watch the game with us. πππ #cocktails #jugs #burgers #cider #craftbeer #finefood #goodtimes #thehopfactory #newcastle #darbyst #darbystreet #staycraftynewcastle",
"post_type": null,
"published_at": "2016-06-22T08:24:34.000Z",
"username": "darbystreetnewcastle2300",
"item_type": "instagram",
"flockler_article_id": 4334951,
"flockler_article_ids": [
4334951
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T11:59:16.012Z",
"last_data_update_failure_reason": {
"code": "Koala::Facebook::ServerError",
"message": null,
"details": "type: OAuthException, code: 2, message: An unexpected error has occurred. Please retry your request later. [HTTP 500]"
},
"stat1": 30,
"stat2": 2,
"stat3": 0,
"score": 28.22,
"analytics_user_id": "1730097i",
"user_id": "2592853652767203463",
"user_profile_url": "https://instagram.com/darbystreetnewcastle2300",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/3f4c2a6902d3f0ed9a9b03de62229af5/5AE715F1/t51.2885-19/s150x150/26155756_1768481073455079_987639278882258944_n.jpg",
"followers": 4146,
"following": 96,
"posts_published": 16539,
"incomplete": false,
"users_in_photo": [
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77534i",
"item_id": "1278117535531754800_238831112",
"item_url": "https://www.instagram.com/p/BG8ySB2kWUw/",
"image_url": "https://media-api.flockler.com/instagram/image/1278117535531754800",
"text": "Settling in to watch QLD dominate game 2 with my Strongbow and footy socks. @spa50 is cheffing us some mad burgers while I'm a being a lazy bitch. ππΊπ #origin2016 #queenslander #QLD #origin #NRL #cider #strongbow #maroons #burgers #bestboyfriend #chefboyfriend #dinnergoals #thickthighssavelives #chubby #curvy #chunkymonkey #girl #bbw #chubbygirl",
"post_type": null,
"published_at": "2016-06-22T08:18:25.000Z",
"username": "brookebelynda",
"item_type": "instagram",
"flockler_article_id": 4334835,
"flockler_article_ids": [
4334835
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T13:02:18.537Z",
"last_data_update_failure_reason": {
"code": "ActiveRecord::RecordNotFound",
"message": null,
"details": "Couldn't find Campaign without an ID"
},
"stat1": 14,
"stat2": 1,
"stat3": 0,
"score": 13.26,
"analytics_user_id": "1730096i",
"user_id": "-7116633022822145843",
"user_profile_url": "https://instagram.com/brookebelynda",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/ce7562be27a0df2d7181b32ce3162996/5AE98A9E/t51.2885-19/s150x150/13774665_943923672385070_1569892009_a.jpg",
"followers": 400,
"following": 975,
"posts_published": 413,
"incomplete": false,
"users_in_photo": [
{
"user": {
"id": "-1330927603885370994",
"username": "spa50",
"fullname": "William",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/s150x150/13437405_994523073976582_1536062095_a.jpg"
},
"position": {
"x": 0.41296297,
"y": 0.49074075
}
},
{
"user": {
"id": "-7116633022822145843",
"username": "brookebelynda",
"fullname": "Brooke Fiddy",
"profile_picture_url": "https://scontent.cdninstagram.com/vp/ce7562be27a0df2d7181b32ce3162996/5AE98A9E/t51.2885-19/s150x150/13774665_943923672385070_1569892009_a.jpg"
},
"position": {
"x": 0.63962835,
"y": 0.3570346
}
}
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77538i",
"item_id": "1278110711617716426_37946567",
"item_url": "https://www.instagram.com/p/BG8wuulmIDK/",
"image_url": "https://media-api.flockler.com/instagram/image/1278110711617716426",
"text": "State of origin 2 time!!! No better place to go than the first bar I went to my first time in Melbourne!! #cider #SOO2",
"post_type": null,
"published_at": "2016-06-22T08:04:51.000Z",
"username": "em_ily_94",
"item_type": "instagram",
"flockler_article_id": 4334715,
"flockler_article_ids": [
4334715
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T13:02:18.537Z",
"last_data_update_failure_reason": {
"code": "ActiveRecord::RecordNotFound",
"message": null,
"details": "Couldn't find Campaign without an ID"
},
"stat1": 10,
"stat2": 1,
"stat3": 0,
"score": 9.86,
"analytics_user_id": "1730116i",
"user_id": "2258549470730364185",
"user_profile_url": "https://instagram.com/em_ily_94",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/a3abdde9c191ea7e26df364534cb8c17/5B20CEF7/t51.2885-19/s150x150/21568694_533843936962015_9170044919748755456_n.jpg",
"followers": 303,
"following": 396,
"posts_published": 291,
"incomplete": false,
"users_in_photo": [
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77539i",
"item_id": "1278109521122885780_2110686215",
"item_url": "https://www.instagram.com/p/BG8wdZ2kwCU/",
"image_url": "https://media-api.flockler.com/instagram/image/1278109521122885780",
"text": "Amazing & delicious hot apple cider tastes like apple crumble. Shame there's no booze in it, hey @elromat #thosegirls #queenvicwinternightmarket #cider #cinnamon #delicious #winterwarmer #wednesdaynightsout #queenvictoriamarkets #melbourne #melbournelyf #picoftheday",
"post_type": null,
"published_at": "2016-06-22T08:02:29.000Z",
"username": "amyb_hurtyg",
"item_type": "instagram",
"flockler_article_id": 4334614,
"flockler_article_ids": [
4334614
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T10:52:20.797Z",
"last_data_update_failure_reason": {
"code": "ActiveRecord::RecordNotFound",
"message": null,
"details": "Couldn't find Campaign without an ID"
},
"stat1": 16,
"stat2": 1,
"stat3": 0,
"score": 14.96,
"analytics_user_id": "1730134i",
"user_id": "6627357989598944005",
"user_profile_url": "https://instagram.com/amyb_hurtyg",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/76603c3f353ee44f6bee0299fc4bee56/5AE41BEF/t51.2885-19/s150x150/21909224_1673290312742978_2390342990364147712_n.jpg",
"followers": 299,
"following": 475,
"posts_published": 910,
"incomplete": false,
"users_in_photo": [
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77541i",
"item_id": "1278107987124404917_2693147287",
"item_url": "https://www.instagram.com/p/BG8wHFNI8K1/",
"image_url": "https://media-api.flockler.com/instagram/image/1278107987124404917",
"text": "Stilton parfait, cider jelly and oat tuille.... #vegetarian #starter #Stilton #parfait #cider #jelly #FoodPest #food #foodpost #foodpic #foodfoodfood #foodporn #foodies #foodlove #foodblog #foodstyle #foodstyleguide #revuud #foodietribe #foodgasm #instafood #instagram #igaddict #photooftheday",
"post_type": null,
"published_at": "2016-06-22T07:59:26.000Z",
"username": "foodpests",
"item_type": "instagram",
"flockler_article_id": 4334612,
"flockler_article_ids": [
4334612
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T11:59:16.012Z",
"last_data_update_failure_reason": {
"code": "Koala::Facebook::ServerError",
"message": null,
"details": "type: OAuthException, code: 2, message: An unexpected error has occurred. Please retry your request later. [HTTP 500]"
},
"stat1": 49,
"stat2": 0,
"stat3": 0,
"score": 41.65,
"analytics_user_id": "1730144i",
"user_id": "6698894080124318691",
"user_profile_url": "https://instagram.com/foodpests",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/89005613600a989f3b5167fc37289370/5AE29BB7/t51.2885-19/s150x150/13391202_628844687292222_1252358789_a.jpg",
"followers": 1014,
"following": 3008,
"posts_published": 540,
"incomplete": false,
"users_in_photo": [
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77542i",
"item_id": "1278106187665349265_16945357",
"item_url": "https://www.instagram.com/p/BG8vs5VBZqR/",
"image_url": "https://media-api.flockler.com/instagram/image/1278106187665349265",
"text": "Totally need to this again #cider #wine #pizza #pies @hannahlouisereek @emma_westall @tillyedwardsxx @lydiakathrynn",
"post_type": null,
"published_at": "2016-06-22T07:55:52.000Z",
"username": "_ellie.griffin__",
"item_type": "instagram",
"flockler_article_id": 4334552,
"flockler_article_ids": [
4334552
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T13:02:18.537Z",
"last_data_update_failure_reason": {
"code": "ActiveRecord::RecordNotFound",
"message": null,
"details": "Couldn't find Campaign without an ID"
},
"stat1": 13,
"stat2": 1,
"stat3": 0,
"score": 12.41,
"analytics_user_id": "1730151i",
"user_id": "-4244122708377912825",
"user_profile_url": "https://instagram.com/_ellie.griffin__",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/6156e2daff0f1d1590cde2e7423a54df/5AF3130F/t51.2885-19/s150x150/25037998_325115897985186_7600146545274519552_n.jpg",
"followers": 1715,
"following": 7499,
"posts_published": 2635,
"incomplete": false,
"users_in_photo": [
{
"user": {
"id": "8780852973857856014",
"username": "hannahlouisereek",
"fullname": "Hannah-Louise ReekπΈ",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/s150x150/12907354_1534511813517444_1423465675_a.jpg"
},
"position": {
"x": 0.934640519320965,
"y": 0.893428063943162
}
},
{
"user": {
"id": "4884901270127337327",
"username": "emma_westall",
"fullname": "Emma",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/10985997_854463924610583_219685088_a.jpg"
},
"position": {
"x": 0.2,
"y": 0.760213143872114
}
},
{
"user": {
"id": "8509830789720439496",
"username": "lydiakathrynn",
"fullname": "Lydia",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/s150x150/15535323_1338258892891936_3979428409678757888_a.jpg"
},
"position": {
"x": 0.404,
"y": 0.761989342806394
}
},
{
"user": {
"id": "-4244122708377912825",
"username": "_ellie.griffin__",
"fullname": "Ellie Griffin",
"profile_picture_url": "https://scontent.cdninstagram.com/vp/6156e2daff0f1d1590cde2e7423a54df/5AF3130F/t51.2885-19/s150x150/25037998_325115897985186_7600146545274519552_n.jpg"
},
"position": {
"x": 0.934640519320965,
"y": 0.687388987566607
}
}
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77543i",
"item_id": "1278105681521735776_1783530189",
"item_url": "https://www.instagram.com/p/BG8vlh8gvhg/",
"image_url": "https://media-api.flockler.com/instagram/image/1278105681521735776",
"text": "#pork #ribs #cider #Japanese #style #soho #London #londoneats #instafood #koya #foodblog #foodgasm #foodie #foodporn #fooddiary #instadaily #eat #eatwell #clean #cook #chef #restaurantsoflondon #foodpics #foodstagram #wasabi",
"post_type": null,
"published_at": "2016-06-22T07:54:52.000Z",
"username": "piggy5uh",
"item_type": "instagram",
"flockler_article_id": 4334551,
"flockler_article_ids": [
4334551
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T11:59:16.012Z",
"last_data_update_failure_reason": {
"code": "ActiveRecord::RecordNotFound",
"message": null,
"details": "Couldn't find Campaign without an ID"
},
"stat1": 81,
"stat2": 1,
"stat3": 0,
"score": 70.21,
"analytics_user_id": "1730154i",
"user_id": "7312318122859546032",
"user_profile_url": "https://instagram.com/piggy5uh",
"user_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,
"incomplete": false,
"users_in_photo": [
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
},
{
"id": "77512i",
"item_id": "1278103209476772891_2001962452",
"item_url": "https://www.instagram.com/p/BG8vBjrJlQb/",
"image_url": "https://media-api.flockler.com/instagram/image/1278103209476772891",
"text": "#captaincool #brother #friend #goodmates #goodtimes #tree #shelter #infromtherain #nature #protector #thegreatoutdoors #beer #cider #festival #weekend #vibes #chillin #highlife #420 #leaves #freedom #happiness #onelove #nattyhead #smile #peace",
"post_type": null,
"published_at": "2016-06-22T07:49:57.000Z",
"username": "zionroots",
"item_type": "instagram",
"flockler_article_id": 4334488,
"flockler_article_ids": [
4334488
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T11:59:16.012Z",
"last_data_update_failure_reason": {
"code": "Koala::Facebook::ServerError",
"message": null,
"details": "type: OAuthException, code: 2, message: An unexpected error has occurred. Please retry your request later. [HTTP 500]"
},
"stat1": 37,
"stat2": 4,
"stat3": 0,
"score": 36.89,
"analytics_user_id": "1729803i",
"user_id": "-6577792498387365916",
"user_profile_url": "https://instagram.com/zionroots",
"user_profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/s150x150/14515628_368026430252783_6574110125622034432_a.jpg",
"followers": 312,
"following": 720,
"posts_published": 845,
"incomplete": false,
"users_in_photo": [
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
}
]
}
Fields
| Field | Data type | Description | values |
|---|---|---|---|
| flockler_article_id | integer | ID of this entry in Flockler API | |
| followers | integer | The amount of followers for the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| following | integer | The amount of users being followed by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| id | string | ID of this entry | |
| image_url | string | URL of the image in the entry. Empty for text-only entries. Facebook URLs will expire after a while | |
| item_id | string | ID of this entry in the originating service (e.g. Twitter) | |
| item_url | string | URL of this entry in the originating service | |
| item_type | string | Type of this entry. | instagram, twitter, facebook |
| published_at | datetime | Entry publish time | |
| posts_published | integer | Total amount of posts made by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| text | string | Text content of this entry | |
| user_id | integer | ID of the user who posted this entry. Global IDs not available for Facebook users due to 3rd party restrictions. | |
| username | string | Username of the user who posted this entry | |
| user_profile_url | string | URL of the posting user's profile in the originating service. | |
| user_profile_picture_url | string | URL of the posting user's profile picture in the originating service. Only available for Twitter entries and some Facebook entries. Instagram and Facebook partially restrict 3rd party access to this information. | |
| users_in_photo | none | Not available. | |
| score | float | Score calculated for this entry based on likes, comments and popularity of posting user. | |
| stat1 | integer | The amount of likes on this entry. | |
| stat2 | integer | The amount of comments or replies on this entry. | |
| stat3 | integer | The amount of shares or retweets on this entry. Not available for Instagram entries. No such concept exists on Instagram. |
GET
/campaigns/campaign-id/entries/id
Get single entry.
Examples
GET https://analytics-api.flockler.com/v1/campaigns/92/entries/77533i
{
"id": "77533i",
"item_id": "1278122143431192819_1737814539",
"item_url": "https://www.instagram.com/p/BG8zVFSxvDz/",
"image_url": "https://media-api.flockler.com/instagram/image/1278122143431192819",
"text": "Event ahead! On your way down to the Truffle Kerfuffle this weekend, why not checkout what's happening at the @bridgetowninthewinter festival? π»",
"post_type": null,
"published_at": "2016-06-22T08:27:34.000Z",
"username": "thecidery_",
"item_type": "instagram",
"flockler_article_id": 4334955,
"flockler_article_ids": [
4334955
],
"last_successful_data_update_at": null,
"last_data_update_attempt_at": "2021-08-16T10:52:20.797Z",
"last_data_update_failure_reason": {
"code": "ActiveRecord::RecordNotFound",
"message": null,
"details": "Couldn't find Campaign without an ID"
},
"stat1": 24,
"stat2": 1,
"stat3": 0,
"score": 21.76,
"analytics_user_id": "1730095i",
"user_id": "-7318524203791262316",
"user_profile_url": "https://instagram.com/thecidery_",
"user_profile_picture_url": "https://scontent.cdninstagram.com/vp/dd07714c8b48639532de589f9d267077/5AE65F9C/t51.2885-19/11192902_1609492269297612_1661701381_a.jpg",
"followers": 431,
"following": 167,
"posts_published": 52,
"incomplete": false,
"users_in_photo": [
{
"user": {
"id": "-4534316605032252740",
"username": "fontyspool",
"fullname": "Fontys Pool Manjimup",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/11176421_1418999708409365_1678972231_a.jpg"
},
"position": {
"x": 0.1921875,
"y": 0.8375
}
},
{
"user": {
"id": "1052982107080453405",
"username": "trufflekerfuffle",
"fullname": "Truffle Kerfuffle",
"profile_picture_url": "http://scontent.cdninstagram.com/t51.2885-19/11374479_840704552688393_45958078_a.jpg"
},
"position": {
"x": 0.696875,
"y": 0.625
}
}
],
"engagement_count": 0,
"impressions_count": 0,
"reach_count": 0,
"saved_count": 0
}
Fields
| Field | Data type | Description | values |
|---|---|---|---|
| flockler_article_id | integer | ID of this entry in Flockler API | |
| followers | integer | The amount of followers for the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| following | integer | The amount of users being followed by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| id | string | ID of this entry | |
| image_url | string | URL of the image in the entry. Empty for text-only entries. Facebook URLs will expire after a while | |
| item_id | string | ID of this entry in the originating service (e.g. Twitter) | |
| item_url | string | URL of this entry in the originating service | |
| item_type | string | Type of this entry. | instagram, twitter, facebook |
| published_at | datetime | Entry publish time | |
| posts_published | integer | Total amount of posts made by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| text | string | Text content of this entry | |
| user_id | integer | ID of the user who posted this entry. Global IDs not available for Facebook users due to 3rd party restrictions. | |
| username | string | Username of the user who posted this entry | |
| user_profile_url | string | URL of the posting user's profile in the originating service. | |
| user_profile_picture_url | string | URL of the posting user's profile picture in the originating service. Only available for Twitter entries and some Facebook entries. Instagram and Facebook partially restrict 3rd party access to this information. | |
| users_in_photo | none | Not available. | |
| score | float | Score calculated for this entry based on likes, comments and popularity of posting user. | |
| stat1 | integer | The amount of likes on this entry. | |
| stat2 | integer | The amount of comments or replies on this entry. | |
| stat3 | integer | The amount of shares or retweets on this entry. Not available for Instagram entries. No such concept exists on Instagram. |
GET
/campaigns/campaign-id/entries/item-type/item-id
Get single entry by external service id. This endpoint redirects (302) to the /campaigns/:campaign_id/entries/:id endpoint.
Examples
GET https://analytics-api.flockler.com/v1/campaigns/92/entries/instagram/1278122143431192819_1737814539
Fields
| Field | Data type | Description | values |
|---|---|---|---|
| flockler_article_id | integer | ID of this entry in Flockler API | |
| followers | integer | The amount of followers for the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| following | integer | The amount of users being followed by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| id | string | ID of this entry | |
| image_url | string | URL of the image in the entry. Empty for text-only entries. Facebook URLs will expire after a while | |
| item_id | string | ID of this entry in the originating service (e.g. Twitter) | |
| item_url | string | URL of this entry in the originating service | |
| item_type | string | Type of this entry. | instagram, twitter, facebook |
| published_at | datetime | Entry publish time | |
| posts_published | integer | Total amount of posts made by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| text | string | Text content of this entry | |
| user_id | integer | ID of the user who posted this entry. Global IDs not available for Facebook users due to 3rd party restrictions. | |
| username | string | Username of the user who posted this entry | |
| user_profile_url | string | URL of the posting user's profile in the originating service. | |
| user_profile_picture_url | string | URL of the posting user's profile picture in the originating service. Only available for Twitter entries and some Facebook entries. Instagram and Facebook partially restrict 3rd party access to this information. | |
| users_in_photo | none | Not available. | |
| score | float | Score calculated for this entry based on likes, comments and popularity of posting user. | |
| stat1 | integer | The amount of likes on this entry. | |
| stat2 | integer | The amount of comments or replies on this entry. | |
| stat3 | integer | The amount of shares or retweets on this entry. Not available for Instagram entries. No such concept exists on Instagram. |
GET
/campaigns/campaign-id/entries/flockler/flockler_article_id
Get single entry by Flockler article id. This endpoint redirects (302) to the /campaigns/:campaign_id/entries/:id endpoint.
Examples
GET https://analytics-api.flockler.com/v1/campaigns/92/entries/flockler/4334955
Fields
| Field | Data type | Description | values |
|---|---|---|---|
| flockler_article_id | integer | ID of this entry in Flockler API | |
| followers | integer | The amount of followers for the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| following | integer | The amount of users being followed by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| id | string | ID of this entry | |
| image_url | string | URL of the image in the entry. Empty for text-only entries. Facebook URLs will expire after a while | |
| item_id | string | ID of this entry in the originating service (e.g. Twitter) | |
| item_url | string | URL of this entry in the originating service | |
| item_type | string | Type of this entry. | instagram, twitter, facebook |
| published_at | datetime | Entry publish time | |
| posts_published | integer | Total amount of posts made by the user who posted this entry. Only available for Twitter entries. Facebook and Instagram restrict 3rd party access to this information. | |
| text | string | Text content of this entry | |
| user_id | integer | ID of the user who posted this entry. Global IDs not available for Facebook users due to 3rd party restrictions. | |
| username | string | Username of the user who posted this entry | |
| user_profile_url | string | URL of the posting user's profile in the originating service. | |
| user_profile_picture_url | string | URL of the posting user's profile picture in the originating service. Only available for Twitter entries and some Facebook entries. Instagram and Facebook partially restrict 3rd party access to this information. | |
| users_in_photo | none | Not available. | |
| score | float | Score calculated for this entry based on likes, comments and popularity of posting user. | |
| stat1 | integer | The amount of likes on this entry. | |
| stat2 | integer | The amount of comments or replies on this entry. | |
| stat3 | integer | The amount of shares or retweets on this entry. Not available for Instagram entries. No such concept exists on Instagram. |