irrepressible.info API and RSS

Irrepressible.info features a powerful API which can be used to build custom applications using the same database of irrepressible content, currently used to to power our banners.

How to use the API

You can find the API at: http://irrepressible.info/query

By default it returns an easy to understand custom xml. It supports the following parameters which you can combine freely. Omitted parameters will simply use a default value or no value.

parameter	values	description
lang	"en", "es", "ar", "fr"	to specify the language of the site description (not the fragment)
limit	"all", [integer] (default 10)	to limit the number of items returned
random	"false" (default), "true"	to return the results in a random order. To work properly this must be combined with a 'limit' param to restrict the number of entries returned to less than the total available matching the query.
country	[keywords]	to filter the results for countries containing containing one or more of the supplied keywords
domain	[keywords]	to filter the results for domains containing containing one or more of the supplied keywords
organisation	[keywords]	to filter the results for organisations containing one or more of the supplied keywords
description	[keywords]	to filter the results for descriptions containing one or more of the supplied keywords
fragment	[keywords]	to filter the results for fragments containing containing one or more of the supplied keywords
format	"XML" (default), "RSS"	format of the returned results

Examples

Logic of complex queries

http://irrepressible.info/auery?lang=es&country=china+iran&description=derechos+humanos will search for fragments censored in China OR Iran whose site description contains any combination of 'derechos' OR 'humanos'. Parameters within each keyword are OR-ed together but the keywords are AND-ed.

How to use specific languages

The language specified in the lang parameter also governs the text that's searched, so if you set lang=es and try to search for a description=humanity it is likely that you won't find anything. Instead use the language parameter like this:

Advanced RSS feeds

Choosing the format "rss" you can reformat any possible query into a valid RSS 2.0 feed. Use it to build a custom feed to use with RSS compatible applications - for example a China and Iran RSS feed.

Irrepressible.info also features a RSS 2.0 Feed of the various censored sites in the database. The feed is available in English, Spanish, French and Arabic and will return a different set of 10 randomly chosen excerpts every day.

If you want more control but still require a RSS feed you can turn any result returned by the API into a valid RSS feed, too. Please consult the information about the API on the left for more details.