Categories

GET
/sites/site-id/article-categories

Get a list of the article categories on this site.

Query parameters

fields Return only requested fields in the response (ex. ?fields=id,name)
GET https://api.flockler.com/v1/sites/609/article-categories
{
  "meta": {
    "total_count": 3,
    "count": 3
  },
  "categories": [
    {
      "category_url": "tutorial",
      "color": null,
      "id": 357,
      "name": "Tutorial",
      "order_number": 1
    },
    {
      "category_url": "example",
      "color": null,
      "id": 997,
      "name": "Example",
      "order_number": 1
    },
    {
      "category_url": "in-finnish",
      "color": null,
      "id": 358,
      "name": "In Finnish",
      "order_number": 2
    }
  ]
}
Field Data type Description values
category_url string Category slug
id integer Unique ID for fetching single category
name string Name of the category
order_number integer Order number of this category on the site
GET
/sites/site-id/article-categories/article-category-id

Get information about an article category.

Query parameters

fields Return only requested fields in the response (ex. ?fields=id,name)
GET https://api.flockler.com/v1/sites/609/article-categories/357
{
  "category": {
    "category_url": "tutorial",
    "color": null,
    "id": 357,
    "name": "Tutorial",
    "order_number": 1
  }
}
Field Data type Description values
category_url string Category slug
id integer Unique ID for fetching single category
name string Name of the category
order_number integer Order number of this category on the site
GET
/sites/site-id/article-categories/article-category-id/articles

Get articles for an article category.

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)
tags Return articles including one or more of the listed tags
(ex. ?tags=product_a,product_b)
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/article-categories/357/articles
{
  "meta": {
    "total_count": 1,
    "count": 1
  },
  "pagination": {
    "refresh": "https://api.flockler.com/v1/sites/609/article-categories/357/articles?since_id=878402",
    "base": "https://api.flockler.com/v1/sites/609/article-categories/357/articles",
    "older": "https://api.flockler.com/v1/sites/609/article-categories/357/articles?max_id=878402"
  },
  "articles": [
    {
      "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,
      "modified_at": null,
      "modified_at_l10n": null,
      "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",
      "photo_credit": null,
      "open_graph": {
        "og_title": "How to source images for your blog (for free)",
        "og_description": "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.",
        "og_url": "http://sites.flockler.com/api-demo/blog/how-to-source-images-for-your-blog-for-free",
        "og_image": "https://flockler.com/thumbs/1246/ca4akeipqrerbnp1yghv_img_9534-3-2_s600x0_q80_noupscale.jpg"
      },
      "article_links": [

      ],
      "featured_articles": [

      ],
      "cta": null,
      "alt_text": null
    }
  ],
  "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,
      "open_graph": {
        "og_title": "Blog",
        "og_description": "",
        "og_url": "http://sites.flockler.com/api-demo/blog",
        "og_image": ""
      }
    }
  ]
}
Field Data type Description values
alt_text string Alt text for the main image if available
article_url string Slug of the 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
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 tags-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