Sections

GET
/sites/site-id/sections

Get a list of sections on this site.

Query parameters

fields Return only requested fields in the response (ex. ?fields=id,section_url)
GET https://api.flockler.com/v1/sites/609/sections
{
  "meta": {
    "total_count": 3,
    "count": 3
  },
  "sections": [
    {
      "brand_color": "",
      "category_id": 997,
      "cover_url": "",
      "description": "",
      "full_url": "http://sites.flockler.com/api-demo/social-media",
      "id": 3907,
      "locale": "en",
      "name": "Social Media",
      "name_in_menus": "",
      "order_number": 1,
      "real_time": false,
      "section_url": "social-media",
      "show_in_menu": true,
      "site_id": 609,
      "state": "public",
      "title_text": ""
    },
    {
      "brand_color": null,
      "category_id": null,
      "cover_url": null,
      "description": "",
      "full_url": "http://sites.flockler.com/api-demo/blog",
      "id": 3908,
      "locale": "en",
      "name": "Blog",
      "name_in_menus": null,
      "order_number": 2,
      "real_time": false,
      "section_url": "blog",
      "show_in_menu": true,
      "site_id": 609,
      "state": "public",
      "title_text": null
    },
    {
      "brand_color": null,
      "category_id": null,
      "cover_url": null,
      "description": "",
      "full_url": "http://sites.flockler.com/api-demo/projects",
      "id": 3909,
      "locale": "en",
      "name": "Projects",
      "name_in_menus": null,
      "order_number": 3,
      "real_time": false,
      "section_url": "projects",
      "show_in_menu": true,
      "site_id": 609,
      "state": "public",
      "title_text": null
    }
  ],
  "categories": [
    {
      "category_url": "example",
      "color": null,
      "id": 997,
      "name": "Example",
      "order_number": 1
    }
  ]
}
Field Data type Description values
brand_color (no description available)
category_id integer ID of the category section belongs to. Category is sideloaded in the response and for fields description, see categories endpoint.
created_at datetime Section creation time
description string Description of this section
full_url string URL of this section
id integer ID of this section
links (no description available)
locale string Localization in use in this section en, se, fi, ru, de
name string Name of this section
name_in_menus (no description available)
order_number integer Order number of this section on the site
real_time (no description available)
section_url string Slug of this section
show_in_menus (no description available)
site_id integer ID of the site this section belongs to
state (no description available)
title_text (no description available)
updated_at datetime Section edited time (any content edited)
GET
/sites/site-id/sections/section-id

Get information about a single section.

Query parameters

fields Return only requested fields in the response (ex. ?fields=id,section_url)
GET https://api.flockler.com/v1/sites/609/sections/3908
{
  "meta": {
    "articles": "https://api.flockler.com/v1/sites/609/sections/3908/articles"
  },
  "section": {
    "brand_color": null,
    "category_id": null,
    "cover_url": null,
    "description": "",
    "full_url": "http://sites.flockler.com/api-demo/blog",
    "id": 3908,
    "locale": "en",
    "name": "Blog",
    "name_in_menus": null,
    "order_number": 2,
    "real_time": false,
    "section_url": "blog",
    "show_in_menu": true,
    "site_id": 609,
    "state": "public",
    "title_text": null
  }
}
Field Data type Description values
brand_color (no description available)
category_id integer ID of the category section belongs to. Category is sideloaded in the response and for fields description, see categories endpoint.
created_at datetime Section creation time
description string Description of this section
full_url string URL of this section
id integer ID of this section
links (no description available)
locale string Localization in use in this section en, se, fi, ru, de
name string Name of this section
name_in_menus (no description available)
order_number integer Order number of this section on the site
real_time (no description available)
section_url string Slug of this section
show_in_menus (no description available)
site_id integer ID of the site this section belongs to
state (no description available)
title_text (no description available)
updated_at datetime Section edited time (any content edited)
GET
/sites/site-id/sections/section-id/articles

Get all the articles in this section.

Query parameters

count Set the number of articles to return per response
fields Return only requested fields in the response (ex. ?fields=id,title,body)
tag Return only articles with this tag (ex. ?tag=marketing)
max_id Return articles older (=with a lower id) than this max_id
since_id Return articles newer (=with a higher id) than this since_id
GET https://api.flockler.com/v1/sites/609/sections/3908/articles
{
  "meta": {
    "total_count": 6,
    "count": 6
  },
  "pagination": {
    "refresh": "https://api.flockler.com/v1/sites/609/sections/3908/articles?since_id=878397",
    "base": "https://api.flockler.com/v1/sites/609/sections/3908/articles",
    "older": "https://api.flockler.com/v1/sites/609/sections/3908/articles?max_id=878396"
  },
  "articles": [
    {
      "article_url": "why-you-need-to-adapt-your-content-for-mobile",
      "author_ids": [
        1421
      ],
      "body": "<p><img alt=\"\" src=\"https://flockler.com/thumbs/1246/gylling-162_s638x0_q80_noupscale.jpg\" style=\"height:auto; margin-bottom:30px; margin-top:30px\" /></p>\n\n<p>The number of people reading content on a mobile device is at an all time high.&nbsp; Established British media outlets from the BBC, The FT, The Mirror, The Guardian through to new comers like the entertainment gossip site Digital Spy have all reported that now over half their audiences view their content on mobile and tablet devices. With 61% of U.K. adults now claiming to own a smartphone and 44% of households owning a tablet, according to Ofcom&rsquo;s latest Communications Market&nbsp;<a href=\"http://stakeholders.ofcom.org.uk/market-data-research/market-data/communications-market-reports/cmr14/uk/\">report</a>, mobile is becoming the preferred mode of access for British web users. For content marketers this highlights the need to create content that is optimised for mobile and social consumption &ndash; such as short form content like quizzes, polls, mini video clips and one-touch easy to read stories.</p>\n\n<p>The vast growth in people accessing the internet via mobile is not just happening in the UK. In Europe, Norway is leading the way on mobile connectedness with 63.5% of its population&nbsp;using a mobile device to access the web says research from the&nbsp;<a href=\"http://www.cmocouncil.org/europe/mobile-marketing.php?start=60\">CMO Council</a>. Over in the United States, Americans are using smartphones and tablet apps more than PCs to access the internet according to the news channel CNN. It says this is the first time that has ever happened.</p>\n\n<p>Social networking and reading the news are the two of smartphone users most popular activities says Ofcom, which conducted consumer research in October 2014. The survey found that the Italians and Spanish were the most sociable mobile users -with more than seven in 10 people using their smartphones to access social networks in these countries. In the UK just under two thirds of smartphone users regularly visited sites like Facebook, Twitter or LinkedIn and nearly half (44%) now read the news on their mobile.</p>\n\n<p>Such is the ubiquitous nature of our mobile devices we are now spending more time on them consuming media and communicating than we are spending asleep, says the Ofcom report. The average adult in the UK spends over eight and a half hours on a laptop, watching TV or on their smartphone/tablet and only just over eight hours on sleep. The report said although desktop is still the prevalent method to access to the internet, mobile is fast catching up. In Briton alone 43% of adults use their smartphone out of the home for checking and responding to their emails, 41% use it for social networking, 32% browsing the net, 27% checking maps and using GPS and 4% use it to stream films, tv programmes, video clips and music.</p>\n\n<p>The millennial generation (16-24) lead the way in mobile usage &ndash; spending the majority of their time online (77%) on social networks. It&rsquo;s little wonder, then, that Facebook had its largest year-on-year increase in mobile visitors in April 2014 when its audience went from 19m to 21.1 million, an 11% increase. In the same year, Twitter, Google+ and&nbsp;LinkedIn all added 0.5m to their mobile audience, growing by 6.3%, 19.2% and 20.8% respectively.</p>\n\n<p>Content creators and marketers are responding to the change in viewing preferences by adapting the types of content they are creating and publishing. Here are examples of how three media companies have done it:</p>\n\n<p><strong><span>The BBC</span></strong>&nbsp;&ndash; with its smartphone and tablet user base growing from less than 15% in 2011 to more than 50% in 2014 the BBC has had to adapt its content for mobile. On Instagram it has created a series of short video clips, dubbed &lsquo;shorties&rsquo;, of the latest news. Each clip lasts no longer than 30 seconds and gives no more than 3 sentences summarising the main events from that story. On the sidebar it includes links to deeper content that&rsquo;s carried on its main site.</p>\n\n<p><strong><span>The Mirror&nbsp;</span></strong>&ndash; the former red-top daily newspaper&rsquo;s mobile traffic exceeded that of its desktop for the first time ever in July 2014. Its unique mobile user base nearly trebled in the year from 2013 to 2014 - going from 10.3 million to 30.6 million. It responded by diversifying the type of content it produced - increasing the number of quizzes and polls across the site along with upping lightweight content said Malcolm Coles, from Trinity Mirror in an interview with Digiday.</p>\n\n<p><strong><span>NBC&nbsp;</span></strong><span>&ndash;&nbsp;</span>The American broadcaster NBC bought the New York Start up NowThis News,&nbsp;which creates short-form news segments tailored for distribution over social media sites like Vine, Instagram and Snapchat, when it realised most of its viewers now get their news by glancing at their smartphone rather than tuning in to a half an hour TV show. NBC&rsquo;s investment in this arena is seen as an effort to keep pace with the vast changes happening in how people consume news.</p>\n",
      "canonical_url": null,
      "category_id": null,
      "cover_pos_x": 50,
      "cover_pos_y": 0,
      "cover_url": "https://flockler.com/thumbs/1246/gylling-162_s600x0_q80_noupscale.jpg",
      "display_style": "article",
      "full_url": "http://sites.flockler.com/api-demo/blog/why-you-need-to-adapt-your-content-for-mobile",
      "id": 878397,
      "pinned_index": 0,
      "published_at": "2015-03-03T13:18:56Z",
      "published_at_l10n": "2015-03-03T13:18:56+00:00",
      "section_id": 3908,
      "site_id": 609,
      "site_pinned_index": null,
      "source": "newsroom",
      "summary": "",
      "tags": [

      ],
      "title": "Why you need to adapt your content for mobile",
      "type": "article",
      "url": null,
      "author_credit": "ajk"
    },
    {
      "article_url": "5-ways-to-curate-content-for-your-blog",
      "author_ids": [
        1421
      ],
      "body": "<p><img alt=\"\" src=\"https://flockler.com/thumbs/1246/3yngiu4yrto4ddifrefa__mg_2885_s638x0_q80_noupscale.jpg\" style=\"height:auto; margin-bottom:30px; margin-top:30px\" /></p>\n\n<p>Curating content is a simple way to generate unique content for your own blog. Successful curators&nbsp;follow an etiquette along the lines of: &nbsp;writing a summary of the work they&rsquo;ve mentioned, crediting&nbsp;the original author and always including a link to the original post. It is good practice to thank the&nbsp;blogs, writers or sources afterwards by either Tweeting them or mentioning them in your intro.&nbsp;Tweeting a thank you which includes a Bitly.com link to your piece is a great way to drive traffic to&nbsp;your post as many of the bloggers you mention will retweet your message to their followers.&nbsp;There are many ways you can curate content, here we&rsquo;ve picked five of our favourite ways to do it.</p>\n\n<h2 class=\"article__heading--h2\">1. Listicles</h2>\n\n<p>These are the blog posts that are written in bullet point or feature pictorial collections all&nbsp;based on one theme. They are presented in the form of a list. People love and loath them in&nbsp;equal measure. But what&rsquo;s for sure, is that they are a great way to pr&eacute;cis a large topic in a&nbsp;condensed format that people can browse whilst on the go. Plus, the good thing about them&nbsp;is you don&rsquo;t need a great deal of writing skill to do one (i.e. you don&rsquo;t have to link each point&nbsp;to the next to make it work). To get inspiration for creating your own listicle take a look at&nbsp;Listverse.com which publishes lists like &lsquo;10 ways politicians are holding back future&nbsp;technologies&rsquo; to unusual lists like &lsquo;top 10 evil serial killers&rsquo;.</p>\n\n<h2 class=\"article__heading--h2\">2. News reviews</h2>\n\n<p>A news review does exactly what it says - reviews current affairs in your field. Newspapers&nbsp;have been doing them for years. There are even magazines, such as The Week (now online &amp;&nbsp;via an app), that people subscribe which condense news and editorial on a daily/weekly&nbsp;basis. You can recreate something akin to this for your blog that can be used again in your&nbsp;weekly/monthly newsletter. You can play around with how you do it such as taking a&nbsp;satirical look the news (like the way the BBC TV&rsquo;s show Have I Got News For You does) or do&nbsp;something more conventional &ndash; like short summaries. Make sure you give a balanced view&nbsp;and remain impartial so you represent the stories you choose to cover fairly (this builds trust&nbsp;with your followers and will mean they will come back and read more from you).</p>\n\n<h2 class=\"article__heading--h2\">3. Bloggers</h2>\n\n<p>The bloggers who write for a living have to come up with content day in and day out. They&nbsp;are adept at creating unique content and seeking out unusual, interesting and relevant&nbsp;information on their area of interest. &nbsp;By regularly checking in with several, say five, each&nbsp;week, you can update and refresh your knowledge and select pieces that you&rsquo;d like to share&nbsp;with your audience. Bookmark your favourite posts, save them in somewhere like Evernote&nbsp;or Pocket, and write a short round up of what each blogger has said that week/month that&nbsp;you like or you think is relevant to your audience.</p>\n\n<h2 class=\"article__heading--h2\">4. The &ldquo;best of&rdquo; collection</h2>\n\n<p>A great way to fill your blog with visual content (that you don&rsquo;t have to make and pay for&nbsp;yourself) is to collate a &ldquo;best of&rdquo; collection &ndash; these can be made up of things on social such&nbsp;as: best of Instagram campaigns like the Huffington Post recently did, or best YouTube&nbsp;videos which Time magazine covered or best of Facebook campaigns which Econsultancy&nbsp;regularly does posts, Your &lsquo;best ofs&rsquo; can be anything that catches your eye and has relevance&nbsp;to your subject matter. Lots of big brands are spending vast proportions of their marketing&nbsp;budgets on highly visual social campaigns that you can collate and showcase in your blog.&nbsp;You just need to find them.</p>\n\n<h2 class=\"article__heading--h2\">5. Stats and facts</h2>\n\n<p>Researching and bringing together a collection of stats and facts about your industry is a&nbsp;good way to curate content. Pulling it altogether in one place makes it easy for your reader&nbsp;to digest. Better still, if you can create a simple visual infographic with the information you&rsquo;ll&nbsp;have just created a unique piece of sharable content. There are tools on the web which&nbsp;enable you to do this for free. Here creativeblog.com has selected 10 that you can use for&nbsp;free. Once you&rsquo;ve created the infographic you can always write a blog post about the&nbsp;information you&rsquo;ve found out about&hellip; which doubles your output for a single piece of&nbsp;research.</p>\n",
      "canonical_url": null,
      "category_id": null,
      "cover_pos_x": 50,
      "cover_pos_y": 0,
      "cover_url": "https://flockler.com/thumbs/1246/3yngiu4yrto4ddifrefa__mg_2885_s600x0_q80_noupscale.jpg",
      "display_style": "article",
      "full_url": "http://sites.flockler.com/api-demo/blog/5-ways-to-curate-content-for-your-blog",
      "id": 878403,
      "pinned_index": null,
      "published_at": "2015-03-03T13:21:13Z",
      "published_at_l10n": "2015-03-03T13:21:13+00:00",
      "section_id": 3908,
      "site_id": 609,
      "site_pinned_index": null,
      "source": "newsroom",
      "summary": "Curating content is a simple way to generate unique content for your own blog. Successful curators follow an etiquette along the lines of:  writing a summary of the work they’ve mentioned, crediting the original author and always including a link to the original post.",
      "tags": [

      ],
      "title": "5 ways to curate content for your blog",
      "type": "article",
      "url": null,
      "author_credit": "ajk"
    },
    {
      "article_url": "how-to-source-images-for-your-blog-for-free",
      "author_ids": [

      ],
      "body": "<div class=\"article-content\">\n<div class=\"article-body\" itemprop=\"articleBody\">\n<p><img alt=\"\" src=\"https://flockler.com/thumbs/1246/ca4akeipqrerbnp1yghv_img_9534-3-2_s638x0_q80_noupscale.jpg\" style=\"height:auto; margin-bottom:30px; margin-top:30px\" /></p>\n\n<p>It&rsquo;s a fact that the best way to attract attention on social media and increase engagement with your blog is to use strong, bold and eye catching imagery to accompany each post. But there&rsquo;s a problem. It&rsquo;s a costly business due to the copyright rules that protect the artists&rsquo; material. Signing up to one of many picture sharing sites can cost in the upward region of &pound;100+ (&euro;130) a month.</p>\n\n<p>But there are ways around this. Many sites offer a free service if you register with them (they hope you&rsquo;ll sign up for a paid-for subscription if you can&rsquo;t find what you&rsquo;re looking for) or increasingly the artists and photographers themselves are cutting out the middle man and offering their shots for free on their own sites, you just need to know where to look.</p>\n\n<p><span>Here we&rsquo;ve selected 5 of the best sources of free images out there</span>:</p>\n\n<h3 class=\"article__heading--h3\"><a href=\"http://www.gettyimages.co.uk/embed\">Getty Images</a></h3>\n\n<p>The world&rsquo;s largest and most prestigious image library, Getty Images, this year opened its doors to its online catalogue of 35 million+ images for bloggers and social media users to use for free (commercial users of Getty&#39;s library - including newspapers, television channels and advertisers - will continue to be charged). Its collection boasts an impressive selection of photos ranging from celebrities to iconic images of news and sporting events. Its new embedding tool will allow you to select an image that&rsquo;s &quot;framed&quot; with a code that links back to Getty&#39;s website. Its code, which can be cut and pasted onto any website, is similar to the tool YouTube provides for sharing its videos. Images cannot be resized and they will all incorporate a Getty Images logo, as well as a credit for the photographer.</p>\n\n<h3 class=\"article__heading--h3\"><a href=\"http://www.dreamstime.com/\">Dreamstime</a></h3>\n\n<p>The royalty free stock photography website, Dreamstime, offers customers a basic &ldquo;free&rdquo; searchable package of images from photographers from all over the globe. It&rsquo;s been going for 10 years and has 6 million registered users. It works by inviting fledgling photographers to upload their images fee free &ndash; so that they get exposure (magazines, newspapers and Fortune 500 companies use the service) whilst the blogger gets to use free images (which they have to credit when they use as part of the deal). The beauty is that thousands of new photos are uploaded by photographers on a daily basis. You can upgrade to a subscription service for more advanced searches and a wider collection of images &ndash; packages start from &pound;131 GBP per month for 750 images.</p>\n\n<h3 class=\"article__heading--h3\"><a href=\"http://www.gratisography.com/\">Gratisography</a></h3>\n\n<p>This site is the brain child of New York photographer and artist&nbsp;<a href=\"http://www.laughandpee.com/\">Ryan McGuire</a>. His pictures are of high resolution and can be downloaded and used commercially, for free (he adds new pictures each week).&nbsp; His collection is eclectic, arty and out of the box, making his photos unique and very entertaining to look at. This is his hobby and his images really convey his passion for his art in every shot. For his day job he&rsquo;s a commercial graphic designer and web designer &ndash; so he&rsquo;s got a good eye for what works digitally. The best thing about this site is that you don&rsquo;t have to sign up. The one downside is that he doesn&rsquo;t have a search function or ways to select images based on &lsquo;categories&rsquo;.</p>\n\n<h3 class=\"article__heading--h3\"><a href=\"http://picjumbo.com/\">Picjumbo</a></h3>\n\n<p>Picjumbo, which has only been going for a year, offers a free and premium service. The selection of free photos, under different categories&nbsp;such as&nbsp;<em>fashion</em><em>,</em>&nbsp;<em>food</em>&nbsp;and&nbsp;<em>nature (&amp; more), are creative and interesting</em>. The site has a good keyword search function so it&rsquo;s easy to find images that you are looking for. All these photos, which are all taken by Viktor Hanacek, can be used for commercial purposes &ndash; all he asks for in return is that you attribute his work. Victor is a web designer and offers all his high resolution photos at a good size (3888 px in wide).</p>\n\n<h3 class=\"article__heading--h3\"><a href=\"http://splitshire.com/\">SplitShire</a></h3>\n\n<p>The Italian photographer and graphic designer, Daniel Nanescu, has created a beautiful site packed with his amazing photography that you can use for free. He has categorised his photos from food, fashion, weddings, blurred backgrounds and more. His passion for his art is his reason for sharing it for free (plus he wants to get noticed too!). Working in the digital world himself he knows how hard it is to get decent images, at the right size without restrictions &ndash; this is why his pictures are perfect for designers, bloggers, web creators and social media marketers to use.&nbsp; He does offer a premium service, at a ridiculously low rate of $5.50 a month, if you need a larger number of prints or a wider selection.</p>\n\n<div>&nbsp;</div>\n</div>\n</div>\n",
      "canonical_url": null,
      "category_id": 357,
      "cover_pos_x": 50,
      "cover_pos_y": 0,
      "cover_url": "https://flockler.com/thumbs/1246/ca4akeipqrerbnp1yghv_img_9534-3-2_s600x0_q80_noupscale.jpg",
      "display_style": "image",
      "full_url": "http://sites.flockler.com/api-demo/blog/how-to-source-images-for-your-blog-for-free",
      "id": 878402,
      "pinned_index": null,
      "published_at": "2015-03-03T13:20:46Z",
      "published_at_l10n": "2015-03-03T13:20:46+00:00",
      "section_id": 3908,
      "site_id": 609,
      "site_pinned_index": null,
      "source": "newsroom",
      "summary": "It’s a fact that the best way to attract attention on social media and increase engagement with your blog is to use strong, bold and eye catching imagery to accompany each post. But there’s a problem.",
      "tags": [

      ],
      "title": "How to source images for your blog (for free)",
      "type": "article",
      "url": null,
      "author_credit": "ajk"
    },
    {
      "article_url": "examples-of-content-and-social-media-marketing-from-travel-brands",
      "author_ids": [
        1420
      ],
      "body": "<p><img alt=\"\" src=\"https://flockler.com/thumbs/1246/vo7ybyqq8iyoo4j9booj_ggb24_s638x0_q80_noupscale.jpg\" style=\"height:auto; margin-bottom:30px; margin-top:30px\" /></p>\n\n<p class=\"article__lead-paragraph\">The marketing world has fully embraced content creation this year and come up with some content gems. Here we&rsquo;ve selected some of our favourite examples of content and social media marketing from 2014.</p>\n\n<h2 class=\"article__heading--h2\">Blog</h2>\n\n<p><a href=\"http://discovergreatbritain.tumblr.com/\">Discover Great Britain</a>&nbsp;has bucked the conventional tourist information site by using Tumblr to host its blog. It is fresh and engaging and a visual feast. It features Vine videos, crisp and clear photography combined with interestingly written blog posts. Instead of offering users a choice to explore Britain by region it allows tourists to decide where they should go based on the type of activity they want to do: from fashion, food, music, adventure, culture sport, history, outdoors etc. It encourages users to upload their own content in its &lsquo;submit&rsquo; section. Here visitors can add their own images, photos, photosets, gif sets or cinemagraphs of the&nbsp;<span>&ldquo;</span><span><em>outstanding places, glorious landscapes or exhilarating experiences of Britain</em></span><span>&rdquo; they have been to.</span></p>\n\n<h2 class=\"article__heading--h2\">Content campaign</h2>\n\n<p>Last minute.com has again come up with a fantastic piece of content marketing with its&nbsp;<a href=\"http://www.lastminute.com/inspiration/100-things-in-london/\">100 things in London</a>&nbsp;inspiration site. It&rsquo;s a pocket guide with a difference. Designed for mobile (it uses geographic location based tech to offer tourists unusual places to visit in the area they are in right now) it has fantastic visuals. This is everything content marketing should be: fun, easy to use and informative. The home site displays beautiful visuals, both photos and old sketches or Victorian posters, of off the tourist trail places to see in London - for example a mural on a wall in Hackney Wick, inside the Horse Guard&rsquo;s hotel with its brilliant staircase or finding one of the last of the remnants of a 16th Century priory in Clerkenwell. One click on the image and it offers a snippet of info about what it is, where it is and how to get there.</p>\n\n<h2 class=\"article__heading--h2\">User generated content</h2>\n\n<p><a href=\"http://flockler.com/blog/our-work/virgin-holidays-florida-uncovered\">Virgin Holidays Florida</a>&nbsp;really captured and capitalised on the nation&rsquo;s love of posting and boasting when it created Florida Uncovered. It asked its fans and followers to share their moments of fun in Florida along with their travel tips about this popular holiday destination. It is a great piece of user generated content incentivised by prize &ndash; an all expenses paid trip to Florida. It had hundreds of users upload their photos, blog posts and pulled in their Tweets with the hashtag #FloridaUncovered.</p>\n\n<h2 class=\"article__heading--h2\">Twitter</h2>\n\n<p>Hats off to&nbsp;<a href=\"http://www.thedrum.com/news/2014/10/21/waterstones-airbnb-join-forces-social-competition-after-customer-locked-bookstore\">Waterstones</a>&nbsp;for turning a PR disaster into a marketing win, all within the same week. Little did the American tourist from Texas know that being locked in a bookstore in central London and tweeting for help would capture the imagination of a nation and inspire a real life (voluntary) lock-in. When David Willis tweeted: &quot;<span><em>Hi Waterstones, I&#39;ve been locked inside of your Trafalgar Square bookstore for two hours now. Please let me out</em></span>.&quot; thousands of people responded, retweeted and claimed they would love to be in his position. Fast forward a week and Waterstones, teaming up with AirBnB, offered ten people (plus partners) the chance to have a sleepover in its London Piccadilly store. All the entrants had to do was say which book they&rsquo;d like to read if they were locked in for the night.</p>\n\n<h2 class=\"article__heading--h2\">Vine</h2>\n\n<p>The simple, but effective Vine created by&nbsp;<a href=\"https://vine.co/BritishAirways\">British Airways</a>&nbsp; of edited together footage of popular destinations such as Rome, Paris and Barcelona was made to look like it was created by some of their customers. The 7 second Vine clip gives the well travelled the chance to spot which favourite haunts from the European cities have been included.</p>\n\n<h2 class=\"article__heading--h2\">Instagram</h2>\n\n<p>The Sydney-side&nbsp;<a href=\"http://instagram.com/watsonsbayboutiquehotel\">Watsons Bay Boutique Hotel</a>&nbsp;has an Instagram account oozing with interesting content. The exclusive harbour side retreat, which has panoramic views of Sydney, includes their own events, mouth-watering food and drink they offer in their ultra cool Beach Club, plus images uploaded from their customers.</p>\n\n<h2 class=\"article__heading--h2\">Video</h2>\n\n<p>Branching away from branded film the British Filmmaker&nbsp;<span>Philip Bloom</span>demonstrates why he is one of the best videographers in the business with his five minute take on Thailand&rsquo;s island of Koh Yao Noi. Shot by using a drone and hosted on&nbsp;<a href=\"http://vimeo.com/97455734\">Vimeo</a>&nbsp;this film really captures the spirit and magic of the tiny island.&nbsp; To accompany the video his&nbsp;<a href=\"http://philipbloom.net/2014/06/06/kohyaonoi/\">blog</a>&nbsp;gives wannabe filmmakers a blow by blow account of how he made the film, which equipment he used and editing techniques too.</p>\n\n<h2 class=\"article__heading--h2\">Facebook</h2>\n\n<p><a href=\"https://www.facebook.com/AbercrombieKent\"><span>Abercrombie &amp; Kent</span></a>, the British luxury tour company, packs its Facebook page with stunning imagery, adventures of their staff and travel related content. They post interesting snippets of little known facts about various destinations that they travel to &ndash; the latest was a Halloween related post about how Mexicans celebrate Dia de los Muertos (The Day of the Dead) instead of Halloween. It has travel experts sourcing unique content whilst on tour plus promotes its charitable efforts in less developed countries.</p>\n\n<h2 class=\"article__heading--h2\">Pinterest</h2>\n\n<p>The&nbsp;<a href=\"http://www.pinterest.com/smithhotels/\">Mr &amp; Mrs Smith</a>&nbsp;Pinterest board is brimming with ideas of where to go. It has 82 boards filled with hotels, spas, glamping sites, wedding venues and fab places their team have visited too. This luxury boutique and luxury hotel provider has really maxed out the benefits of this social site which largely attracts female followers.</p>\n",
      "canonical_url": null,
      "category_id": null,
      "cover_pos_x": 50,
      "cover_pos_y": 0,
      "cover_url": "https://flockler.com/thumbs/1246/vo7ybyqq8iyoo4j9booj_ggb24_s600x0_q80_noupscale.jpg",
      "display_style": "article",
      "full_url": "http://sites.flockler.com/api-demo/blog/examples-of-content-and-social-media-marketing-from-travel-brands",
      "id": 878401,
      "pinned_index": null,
      "published_at": "2015-03-03T13:20:19Z",
      "published_at_l10n": "2015-03-03T13:20:19+00:00",
      "section_id": 3908,
      "site_id": 609,
      "site_pinned_index": null,
      "source": "newsroom",
      "summary": "",
      "tags": [

      ],
      "title": "Examples of content & social media marketing from travel brands",
      "type": "article",
      "url": null,
      "author_credit": "ajk"
    },
    {
      "article_url": "3-examples-of-brands-creating-content-on-a-budget",
      "author_ids": [
        1422
      ],
      "body": "<p><img alt=\"\" src=\"https://flockler.com/thumbs/1246/m6rt4myfq7ct8j9m2aec_jakegivens-sunset-in-the-park_s638x0_q80_noupscale.jpeg\" style=\"height:auto; margin-bottom:30px; margin-top:30px\" /></p>\n\n<p>Some of the best examples of content and social media marketing come from brands that have created content on a shoestring. It&rsquo;s easier for the big named brands with the budgets to boot to create innovative content. &nbsp;But it&rsquo;s much harder for smaller, niche, unknown or unsexy brands to do it.&nbsp; So when you find a great piece of content, done on the cheap, it&rsquo;s worth celebrating. Here we applaud these three brands for their efforts.</p>\n\n<h3 class=\"article__heading--h3\"><span><a href=\"https://www.facebook.com/EpilepsyResearchUK\">Epilepsy Research UK</a></span></h3>\n\n<p>The charity and non-profit organisation is a good example of how to use Facebook effectively on a limited budget. It strikes a balance between posting original, unique content on its page, such as downloadable leaflets about the condition written by endorsed experts, mixed in with curated content from around the web. It shares articles from the likes of buzzfeed.com to complementary campaigns such as the one being spearheaded by an MP Norman Lamb &ndash; which costs nothing for the organisation to do. They&rsquo;ve capitalised on their highly engaged 8,000+ followers &ndash; collaborating with them in physical fundraising events&ndash; such as &lsquo;donate a toy&rsquo; campaign as well as promoting local events that they are hosting, like Christmas fayres etc &ndash; which are examples of user-generated content. Plus it regularly engages its community by thanking them for the money they&rsquo;ve raised on its behalf. What&rsquo;s particularly good about this charity&rsquo;s content is that it costs very little to do, it stays focused on its core purpose of providing valuable, informative and helpful information that its audience is after.</p>\n\n<h3 class=\"article__heading--h3\"><span><a href=\"https://www.facebook.com/GardeningGoddesses\">Roundup Weed Killer</a></span></h3>\n\n<p>Creating sexy content for a weed killing product is tough. What the marketers behind this brand have done successfully is side-step the product itself and focused on creating a lovely piece of content all about gardening, in the guise of a women&rsquo;s forum on Facebook, called Gardening Goddesess. On this page they post a mixture of curated content such as mini YouTube clips on planting tips, articles from other gardening blogs plus their own original material such as strong images of flowers, engaging questions about gardening with a smattering of recommended placed products to buy here and there (but not enough to put you off). This is definitely a low cost and pretty low maintenance content strategy. With almost 9,000 followers this is a good effort for a brand that doesn&rsquo;t have a presence on this social media channel at all, as who is going to &lsquo;like&rsquo; it?</p>\n\n<h3 class=\"article__heading--h3\"><span>Gatwick Airport</span></h3>\n\n<p>This brand successfully collaborated with the big-named shops it plays host to earlier this year by creating an engaging, but low cost competition called The X-ray collection. The content was aimed at regular fliers from this airport as it challenged people to guess the products photographed within a bag in an airport scanner. It released one x-ray style photo a week for eight weeks on its Facebook page and entrants could respond with their guesses on either Twitter, using the hashtag&nbsp; #XrayCollection, or Facebook. The competition was aimed at engaging its customers as well as showcasing what was on offer to buy whilst passengers were waiting for their flights. All correct entries submitted were entered into a prize draw for the chance of winning a &pound;150 Gatwick shopping voucher &ndash; with one lucky winner at the end of the eight weeks walking away with a &pound;900 Aspinal handbag. This was an low-cost, easy to manage social media campaign that added some spark to an otherwise rather dull Facebook page.</p>\n",
      "canonical_url": null,
      "category_id": null,
      "cover_pos_x": 50,
      "cover_pos_y": 0,
      "cover_url": "https://flockler.com/thumbs/1246/m6rt4myfq7ct8j9m2aec_jakegivens-sunset-in-the-park_s600x0_q80_noupscale.jpeg",
      "display_style": "image",
      "full_url": "http://sites.flockler.com/api-demo/blog/3-examples-of-brands-creating-content-on-a-budget",
      "id": 878400,
      "pinned_index": null,
      "published_at": "2015-03-03T13:19:38Z",
      "published_at_l10n": "2015-03-03T13:19:38+00:00",
      "section_id": 3908,
      "site_id": 609,
      "site_pinned_index": null,
      "source": "newsroom",
      "summary": "",
      "tags": [

      ],
      "title": "3 examples of brands creating content on a budget",
      "type": "article",
      "url": null,
      "author_credit": "ajk"
    },
    {
      "article_url": "content-is-better-on-a-responsively-designed-site",
      "author_ids": [
        1421
      ],
      "body": "<div class=\"article-content\">\n<div class=\"article-body\" itemprop=\"articleBody\">\n<p><img alt=\"\" src=\"https://flockler.com/thumbs/1246/gylling-1-2_s638x0_q80_noupscale.jpg\" style=\"height:auto; margin-bottom:30px; margin-top:30px\" /></p>\n\n<p>For publishers of content having a responsively designed site is more than about pleasing Google&rsquo;s algorithms, boosting SEO or abandoning a two URL strategy (one for desktop and one for mobile). Yes these are some of the positive outcomes, but more importantly content just looks and feels better on a responsive site, whatever the device it&rsquo;s being viewed on. In our modern world, where there are multiple ways to access the net (be it on a PC, laptop, smartphone, tablet, console, TV, watch, wristband and with new tech being created all the time), viewers want a smoother, more fluid&nbsp;transition when they&rsquo;re interacting with brands &ndash; regardless of the device they&rsquo;re on.</p>\n\n<p>The editorial giant The BBC, which receives nearly half of its 115 million weekly visits to its news site from mobile devices, launched its responsive site last year in 2014. It said that from now on all of its new online products will be mobile first so that it can &ldquo;<em>offer the best experience possible to our audiences, no matter what combination of device, browser, connection etc... they are using</em>.&rdquo; Other media outlets are following suit. The latest to roll out a truly responsive site is The Guardian, which launched at the end of January 2015.</p>\n\n<p>Here we take a look at why the Guardian&rsquo;s creative director, Alex Breuer, chose &ldquo;responsive&rdquo; over any other web design and how this has improved their reader&rsquo;s experience online as well as enabled their journalists to create new types of content. In a&nbsp;<a href=\"http://responsivewebdesign.com/podcast/guardian.html\">podcast</a>&nbsp;interview (with responsivewebdesign.com founders Karen McGrance and Ethan Marcotte) Breuer spoke of an 18 month journey that he and his team took to modernise&nbsp;the Guardian&rsquo;s site (it was last relaunched in 2007). It&rsquo;s gone from offering readers multiple content platforms (it had an Android app, an iPhone app, an iPad app, mobile website &amp; desktop site), that were all being produced in different ways and all had a different look and feel to them, to one &ldquo;fidelity of design and familiarity of interaction in content forms&quot;.The change has given its readers, who were accessing its different platforms at different times of the day, brand continuity.</p>\n\n<p>From Breuer&rsquo;s comments on responsivewebdesign.com and from the Guardian&rsquo;s director of digital strategy Wolfgang Blau&rsquo;s&nbsp;<a href=\"http://www.theguardian.com/help/insideguardian/2015/jan/28/welcome-to-the-new-guardian-website\">article</a>&nbsp;on the redesign we&rsquo;ve picked out 9 benefits of The Guardian choosing a responsively designed site:</p>\n\n<h2 class=\"article__heading--h2\">Benefits for the readers</h2>\n\n<ol>\n\t<li><span>An intuitive view:</span>&nbsp;It&rsquo;s enabled the Guardian to break down traditional subject structures that it used to use to categorise its content to offer readers a more intuitive perspective. Stories are now more compact, and there are more visual clues about each story&rsquo;s relative importance and its editorial tone - i.e.&nbsp;whether it is a breaking news story or a live blog, a piece of analysis, a piece of opinion, a feature or a review.</li>\n\t<li><span>Visuals have been prioritised</span>. Videos are no longer tucked away and treated as separate pieces of content. They, along with images and interactive elements, have taken centre stage. Reflecting the new way people consume news.</li>\n\t<li><span>Reader&rsquo;s views are more prominent:</span>&nbsp;The new style site allows readers to comment in the first screen, rather than pushing them onto another page. This acknowledges a key content trend of giving readers a voice, which in turn will enable people to become more engaged. Plus this enables the Guardian to keep the conversation its readers are having on its site.</li>\n\t<li><span>Breaking news and live updates:</span>&nbsp;The live blogs and up-to-date, to the minute reporting, is now carried in two ways &ndash; there&rsquo;s a bullet point list for a quick scan reading (for those on the go &amp; on their mobile) and a separate list of key events that details what has happened since the reader last visited that blog (better for those on desktop-type devices).&nbsp;</li>\n\t<li><span>Personalised content:</span>&nbsp;In a nod to the personalisation trend that marketers have been using for some time the new site&rsquo;s navigation contains a personalised element. It directs readers to the areas of the site they go to most often. They&rsquo;ve included a&nbsp;preferences page&nbsp;which enables readers to edit or to deactivate these personalised links.</li>\n\t<li><span>Faster content:</span>&nbsp;the speed with which a reader can access the content has increased dramatically (much better for mobile users) and is part of the core way the site has been developed. It has restricted&nbsp;unnecessary JavaScript on the site which has enabled this to happen. The new site also has truncated copy, especially for mobile viewers, to stop readers having to spend a long time scrolling through the article.</li>\n</ol>\n\n<h2 class=\"article__heading--h2\">Better for the content creators</h2>\n\n<p><strong><span>1. New ways of storytelling:</span></strong></p>\n\n<p>The new format and layouts have been adapted to keep up with insights the Guardian team found about how people were consuming their content. They have given their content creators, journalists, film-makers, podcasters and photographers new ways to bring their stories to life. The new format is helping to re-educate journalists about the power of short form content and is enabling them to experiment with new, visual styles of reporting. Editors &amp; writers have been encouraged to think web-first when starting to create their stories (rather than print first which is a mentality that has dominated the industry for almost 200 years!). The new technology, which the Guardian has built internally from the ground up and spent millions on, has forced a mind-shift within the organisation. Using the in-house specially designed technology, Composer, journalists can now write their copy, insert visuals and interactive media alongside their piece &ndash; creating a more interesting package of news. The unique nature of this tech allows journalists/editors to do all this remotely &ndash; away from their desks &ndash; if needed. This will enhance the Guardian&rsquo;s delivery of breaking news stories.</p>\n\n<p><strong><span>2. Future technology:</span></strong></p>\n\n<p>Breuer and his team&nbsp;recognised that new and future technology will change the way people consume content. Its new site has been built with the capacity to accommodate this. Breuer said that reading an article form on the likes of Google Glasses isn&rsquo;t very exciting. The new site has been designed to host more audio or short form videos for when new types of tech become more mainstream. Consumers of content on new forms of tech will not want to read but will prefer to&nbsp;be &#39;alerted&#39; to stories &ndash; this will ultimately shape the style and type of content that the Guardian journalists will produce.</p>\n\n<p><strong><span>3. Faster content:</span></strong></p>\n\n<p>The dynamic layout promises faster stories &ndash; but also more dynamic copy. The flexible layout, says Breuer, allows editors to &ldquo;show change, show aliveness, show a really dynamic change or importance of an individual story over the course of a period of time, either as its presence changes or as it moves through the architecture of the site.&rdquo; The responsive nature of the new site lets the editor boost an image or headline as the story evolves as part of an editor-curated layout system. Speed has been the core foundation and building block of the new site &ndash; conscious, Breuer says, of those still accessing the net on a 3G connection on their phones when out and about. Any animation tools, differing navigation and some amount of Java Script have been removed to keep the site as fast as possible. Breuer says: &ldquo;We&rsquo;ve really been quite brutal in what we do and don&rsquo;t choose to bring to life in that way. Because we know that compromising speed is a fundamental compromise to the overall experience of the whole site.&rdquo;</p>\n\n<div>&nbsp;</div>\n</div>\n</div>\n",
      "canonical_url": null,
      "category_id": null,
      "cover_pos_x": 50,
      "cover_pos_y": 0,
      "cover_url": "https://flockler.com/thumbs/1246/gylling-1-2_s600x0_q80_noupscale.jpg",
      "display_style": "article",
      "full_url": "http://sites.flockler.com/api-demo/blog/content-is-better-on-a-responsively-designed-site",
      "id": 878396,
      "pinned_index": null,
      "published_at": "2015-03-03T13:18:02Z",
      "published_at_l10n": "2015-03-03T13:18:02+00:00",
      "section_id": 3908,
      "site_id": 609,
      "site_pinned_index": null,
      "source": "newsroom",
      "summary": "",
      "tags": [

      ],
      "title": "Content is better on a responsively designed site",
      "type": "article",
      "url": null,
      "author_credit": "ajk"
    }
  ],
  "authors": [
    {
      "about": "",
      "avatar": "https://pbs.twimg.com/profile_images/378800000596708958/e75062d76192446ddd7758e34c9e1c6a_400x400.jpeg",
      "firstname": "Peter",
      "id": 1421,
      "job_title": "Designer",
      "lastname": "Party",
      "links": {
      },
      "name": "Peter Party",
      "short_description": "Designer / Developer at Flockler"
    },
    {
      "about": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec ullamcorper nulla non metus auctor fringilla. Sed posuere consectetur est at lobortis. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus. Maecenas faucibus mollis interdum.</p>\n",
      "avatar": "https://s3.amazonaws.com/uifaces/faces/twitter/jsa/128.jpg",
      "firstname": "James",
      "id": 1420,
      "job_title": "Writer",
      "lastname": "Anderson",
      "links": {
        "twitter": "http://twitter.com/jsa"
      },
      "name": "James Anderson",
      "short_description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec ullamcorper nulla non metus auctor fringilla. Sed posuere consectetur est at lobortis."
    },
    {
      "about": "<div class=\"profile-pic\">I&rsquo;m a full-stack developer and designer from Finland. I live with my wife whom I married in New York City. I love crafting products that help get things&nbsp;done.</div>\n\n<div class=\"about-me\">\n<p>I&rsquo;ve worked at a successful product startup, in aUX&nbsp;team consulting for the biggest and smallest clients in Finland, failed a consumer iPhone app and set up sales terminals into Africa and Australia (remotely, sadly). I&nbsp;actively&nbsp;<a href=\"https://github.com/Darep\">contribute to the&nbsp;OSS&nbsp;community</a>. I also&nbsp;<a href=\"mailto:ajk@ajk.fi\">freelance</a>&nbsp;via my own company whenever a cool opportunity presents&nbsp;itself.</p>\n\n<p>In design, be it&nbsp;UX&nbsp;design or software architecture design, I feel that empathy is key. Empowering your users while making sure the user feels good are the goals I aim&nbsp;for.</p>\n\n<p>In software development, my empathy-oriented philosophy means that I specialise in creating products that are easy to use, easy to maintain and easy to develop further. This is my passion; I want to create code, architecture and frameworks that empower users and other developers and give them that amazing feeling of &ldquo;wow, that&rsquo;s so simple, this system is&nbsp;beautiful&rdquo;.</p>\n\n<p>I&rsquo;m also a skilled graphic designer (though I do that less and less these&nbsp;days).</p>\n</div>\n",
      "avatar": "https://flockler.com/files/sites/609/e9faac3b52d792d37943c60d62e4156f.jpeg",
      "firstname": "AJ",
      "id": 1422,
      "job_title": "Designineer",
      "lastname": "Hardwick",
      "links": {
        "email": "ajk@ajk.fi",
        "github": "http://github.com/Darep",
        "instagram": "http://instagram.com/darep",
        "twitter": "http://www.twitter.com/darep",
        "youtube": "https://www.youtube.com/user/darep/videos"
      },
      "name": "AJ Hardwick",
      "short_description": "My name is Antti-Jussi Kovalainen (or ajk for short). I’m currently working for Flockler as a startup polymath, and also finishing my studies at Tampere University of Technology."
    }
  ],
  "categories": [
    {
      "category_url": "tutorial",
      "color": null,
      "id": 357,
      "name": "Tutorial",
      "order_number": 1
    }
  ],
  "sections": [
    {
      "brand_color": null,
      "category_id": null,
      "cover_url": null,
      "description": "",
      "full_url": "http://sites.flockler.com/api-demo/blog",
      "id": 3908,
      "locale": "en",
      "name": "Blog",
      "name_in_menus": null,
      "order_number": 2,
      "real_time": false,
      "section_url": "blog",
      "show_in_menu": true,
      "site_id": 609,
      "state": "public",
      "title_text": null
    }
  ]
}
Field Data type Description values
article_url string Slug of the article
author_ids array of integers ID's of the sideloaded authors of this article. For fields description, see authors endpoint
body string Article text in HTML format
category_id integer ID of the category article belongs to. Category is sideloaded in the response and for fields description, see categories endpoint.
cover_pos_x integer Cover's X position in percentage without the %, easy to use with "background-position" CSS attribute
cover_pos_y integer Cover's Y position in percentage without the %, easy to use with "background-position" CSS attribute
cover_url string Url to the full size version of the cover image, see Image resizing
display_style string Article display style (on Flockler magazine layout) article, text, video, image, facebook-post, tweet, instagram
full_url string Full URL of this article
id integer ID of this article
pinned_index integer Section articles endpoint only! Index where this article is pinned at starting from 0 in section
published_at datetime Article publish time
published_at_l10n datetime Article publish time with localization
section_id integer ID of the section article belongs to. Section is sideloaded in the response and for fields description, see section endpoint.
site_id integer ID of the section article belongs to. Section is sideloaded in the response and for fields description, see section endpoint.
site_pinned_index integer Site articles endpoint only! Index where this article is pinned at starting from 0 on frontpage
source string Source of the article newsroom, guest_api, feed, email, upload_form, media_tracker
summary string Article summary
tags string Keywords that article is tagged with. Notice that you can filter with these by using tag-parameter.
title string Article title
type string Type of the article article, video, image, facebook_post, tweet, instagram, link, pinterest
url string Source URL for article if it's a "link" article
attachments embedded Hash containing the attachments that the article has (e.g. a tweet). See also, field descriptions of attachments. facebook_post, instagram_item, tweet, video
author_credit string Author(s) of article as a easily representable string