Documentation for BBC News Labs APIs & #newsHACK events
DEPRECATED! Please use the new Juicer v2 API
The BBC Labs News Juicer is the software responsible for fetching content from the web - articles, videos and images from the BBC and other sources - parsing the content and tagging it with people, organisations and places that correspond to DBpedia entries.
The public Juicer API allows you to specify start and end dates for articles, select which sources or concepts you wish to search for and to free text search in real time, as articles, tweets and other content is ingested.
If you are not using Ruby or Node.JS (or just want to use the REST API directly) see the documentation for REST API endpoints below.
If you install the free Postman REST Client you can import the Juicer API into using this URL:
This allows you to easily try out the API and explore how it works without writing any code.
You will need to configure an "Environment" within Postman to be able to make calls:
You can filter and sort the articles returned from the
articles endpoint. Parameters can be provided in the query string.
text: keywords to search for. Searches in title, description and body of the article.
product: scopes the results to certain products. Multiple products can be specified by adding multiple
productkeys and values. Just specify 'NewsWeb' to return only BBC News articles.
content_format: scopes the results to certain formats. Multiple formats can be specified by adding multiple
content_formatkeys and values.
section: scopes the results to certain sections. Multiple sections can be specified by adding multiple
sectionkeys and values.
site: scopes the results to certain sites. Multiple sites can be specified by adding multiple
sitekeys and values.
published_after: fetch articles published after
published_after. The date format is
published_before: fetch articles published before
published_before. The date format is
recent_first: Specify 'yes' to sort results by date (with most recent first) instead of by relevance to keywords.
All parameters are optional. If parameters are omitted, the endpoint will just return the latest articles.
The Juicer supports doing complex queries across multiple sources. For example, the following query uses the search phrase
kenya || nairobi AND (government || president || "Uhuru Kenyatta") which returns articles only from the listed products that match that specific query.
You can get the full text of a specific article by using it's
id (this property is sometimes called the
Get the a list of
products currently indexed and avalible from the Juicer.
"Products" are newspapers, broadcast TV channels and other sources.
To return only BBC News articles, specify
product=NewsWeb when calling
All comments are moderated for approval.