The entire Facts website was built simply for the purpose of providing an API to a very simple WordPress shortcode. The name of the website was used simply to utilise an old domain that had no purpose in life.
The API retrieves XML output and is primarily used to renders the content on a WordPress blog with ShortCode (WordPress will cache the data locally for a specified time).
If you're interested in any of the initiatives we use to generate web traffic, head over to the BeliefMedia
website and subscribe.
More facts are added daily so be sure to subscribe to our Facebook Page
so you're made aware of significant additions.
You can find some sample PHP functions and WordPress shortcode here
on our Internoetics blog.
Retrieving a Fact
We cache results (normally) for 5-minutes. With the shortcode we provide it utilises the WordPress cache functionality and we'd expect you to do the same. As such, unreasonable requests result in a short block (detailed below).
You can see some example code to implement this XML into your website over at Jokz.net
Error (and other) Codes
Example XML Error:
|420||Rate Limited (Block active for Rule: X - unlock in -XX Sec.)|
Rate Limiting Rules
Generally speaking, it would be challenging to find yourself rate-limited. Having said that, intentional abuse results in a block. Abuse determined to be aggresive in nature results in a permanent block. If you require your application to be white-listed, please contact us.