Breaking News

Bulawayo24 News API Documentation

Welcome to the Bulawayo24 News API documentation. An easy way to integrate latest news or a selection of stories on your website.

With Byo24News API you wont need to search for any news stories instead all the stories will be published to your website every time Bulawayo24 News is updated.

Listed below are examples of who the API can be embedded into you website or blog.

For assistance with Byo24News API contact our team at developers[at]bulawayo24[dot]com.

Example 1 (Dynamic)

<iframe width="100%" scrolling="no" height="410" frameborder="0" src="http://bulawayo24.com/public/wedgets/api.php?fc=9A875C&h=400&f=Tahoma,Verdana,Arial,Helvetica,sans-serif&max_words=400&l=2&align=left&border_bottom=1px dotted&img_w=150&img_padding=10 " allowtransparency="true" marginwidth="0" marginheight="0"></iframe>

Render

The above code sample renders this: working example http://www.zimbabweactiongroup.org/index.php?id=News

Example 2 (Selected story)

<!-- STORY O1 --> <iframe width="199" scrolling="no" height="200" frameborder="0" marginheight="0" marginwidth="0" allowtransparency="true" src="http://bulawayo24.com/public/wedgets/api.php?w=189&amp;img_w=199&amp;max_words=0&amp;align_img&amp;l=1&amp;h=200&amp;border_bottom&amp;byo=7390&amp;title=bottom&amp;date=off"></iframe> <!-- STORY O2 --> <iframe width="199" scrolling="no" height="200" frameborder="0" marginheight="0" marginwidth="0" allowtransparency="true" src="http://bulawayo24.com/public/wedgets/api.php?w=189&amp;img_w=199&amp;max_words=0&amp;align_img&amp;l=1&amp;h=200&amp;border_bottom&amp;byo=7391&amp;title=bottom&amp;date=off"></iframe> <!-- STORY O3 --> <iframe width="199" scrolling="no" height="200" frameborder="0" marginheight="0" marginwidth="0" allowtransparency="true" src="http://bulawayo24.com/public/wedgets/api.php?w=189&amp;img_w=199&amp;max_words=0&amp;align_img&amp;l=1&amp;h=200&amp;border_bottom&amp;byo=7388&amp;title=bottom&amp;date=off"></iframe> <!-- STORY O4 --> <iframe width="199" scrolling="no" height="200" frameborder="0" marginheight="0" marginwidth="0" allowtransparency="true" src="http://bulawayo24.com/public/wedgets/api.php?w=189&amp;img_w=199&amp;max_words=0&amp;align_img&amp;l=1&amp;h=200&amp;border_bottom&amp;byo=7488&amp;title=bottom&amp;date=off"></iframe>

Render

The above code sample renders these four selected stories: working example wwww.visionsfm.com
To select a story use the byo number which is found on the url of every story, as shown below

http://bulawayo24.com/index-id-news-sc-national-byo-7390-article-new-born+baby+butchered+to+conceal+affair+with+uncle%27s+wife.html

The byo number is 7390

Example 3 (Full story) Dynamic

<iframe width="100%" scrolling="yes" height="600" frameborder="0" src="http://bulawayo24.com/public/wedgets/api.php?fc=9A875C&h=&f=Tahoma,Verdana,Arial,Helvetica,sans-serif&max_words=full_story&l=2&align=left&border_bottom=1px dotted&img_w=400&img_padding=10 " allowtransparency="true" marginwidth="0" marginheight="0"></iframe>

Render

With the max_words set to full_story as above you get a full story as show below:

A few components of Byo24News API

  • Number of stories, value (l) default: 6
  • IMAGES ALIGN value (align_img) default: left
  • Maximum words per story value (max_words) default 400
  • Width of the frame value (w) default: 100%
  • height of the frame value (h) default:
  • Font-family value (f) default: Tahoma,Verdana,Arial,Helvetica,sans-serif";
  • Font-size in pixels value (fz) default: 11
  • Font color in hexadecimal without # value (color) default:333333
  • Background color value (bg) default:transparent
  • Image width value (img_w) default: 67
  • Border_bottom value (border_bottom) default: 1px dotted silver
  • Image padding value (padding) default:0
  • Positioning the story title there are 2 options top or bottom, value (title) default:top
  • The date can be turned off by using value (date) set to (off)