What is a taxonomy?
A taxonomy is an object describing a label associated with content (diffusion or show). This label always includes a type (theme or tag), a title, and a description (standFirst).
On the Open API, two types of taxonomies are available:
Themes: There are three levels of themes (theme, sub-theme, sub-sub-theme).
For example, a theme page on the Radio France platform can be accessed at the following address: https://www.radiofrance.fr/sciences-savoirs. The theme path can be identified by observing the science-savoirs part in the URL. This thematic area may include several sub-themes under paths like sciences-savoirs/philosophie or sciences-savoirs/histoire.
tipTheme pages are recognizable as they generally offer sub-themes.
Slashes in the path indicate the hierarchy of a theme.
Tags: These are typically keywords associated with content. Taking the example of a diffusion, at the bottom of the page, there is a list of clickable keywords, including the tag Forest. This tag redirects to a page listing all diffusions associated with this keyword.
Unlike themes, there is no hierarchy for tags.
info
There are two sets of taxonomies: one for France Bleu stations and the other for the rest of the brands. These can be distinguished by selecting the source in the GraphQL query "taxonomies," as indicated below.
List the first ten taxonomies
{
taxonomies(source: UNIFIED, first: 10) {
edges {
cursor
node {
id
path
type
title
standFirst
}
}
}
}
Response
{
"data": {
"taxonomies": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "0002545a-6f7a-461a-9a9d-557a08e6aafc_0",
"path": "sciences-savoirs/sciences-sociales/sociologie",
"type": "theme",
"title": "Sociologie",
"standFirst": " "
}
},
{
"cursor": "Mg==",
"node": {
"id": "0074d1d8-3618-11e1-a6ab-842b2b72cd1d_1",
"path": "dossiers/usa-2012-les-primaires",
"type": "dossier",
"title": "USA 2012 : les primaires",
"standFirst": null
}
},
{
"cursor": "Mw==",
"node": {
"id": "00769a73-2df5-43ec-a514-1d632fe9a5b1_5",
"path": "dossiers/eric-rohmer-l-integrale-en-cinq-entretiens-2004",
"type": "dossier",
"title": "Eric Rohmer, l'intégrale en cinq entretiens (2004)",
"standFirst": null
}
},
{
"cursor": "NA==",
"node": {
"id": "008aa4ec-6a9e-480e-a5e6-7433ca1e2612_5",
"path": "dossiers/la-nuit-speciale-feydeau-13-par-philippe-garbit",
"type": "dossier",
"title": "La Nuit spéciale - Feydeau 1/3 Par Philippe Garbit",
"standFirst": null
}
},
{
"cursor": "NQ==",
"node": {
"id": "00a6cd5a-9dd8-11e1-a502-842b2b72cd74_1",
"path": "dossiers/le-nouveau-gouvernement-cazeneuve-6-decembre-2016",
"type": "dossier",
"title": "Le nouveau gouvernement Cazeneuve - 6 décembre 2016",
"standFirst": null
}
},
{
"cursor": "Ng==",
"node": {
"id": "00d82e97-7aec-4572-9f83-61cba47db749_0",
"path": "sujets/tsiganes-roms",
"type": "tag",
"title": "Tsiganes – Roms",
"standFirst": null
}
},
{
"cursor": "Nw==",
"node": {
"id": "0107ffb2-3a40-4d67-af58-db1ed2079e64_0",
"path": "sujets/chasse",
"type": "tag",
"title": "Chasse",
"standFirst": null
}
},
{
"cursor": "OA==",
"node": {
"id": "010c22fb-6cee-4a10-a404-c32a31056b89_5",
"path": "dossiers/atelier-de-creation-radiophonique",
"type": "dossier",
"title": "Atelier de Création Radiophonique",
"standFirst": null
}
},
{
"cursor": "OQ==",
"node": {
"id": "011bc873-7431-4710-8460-f6c81fa1e155_0",
"path": "sujets/emirats-arabes-unis",
"type": "tag",
"title": "Émirats Arabes Unis",
"standFirst": " "
}
},
{
"cursor": "MTA=",
"node": {
"id": "011cb498-bc0a-4a3e-953a-0b47f6fb3470_5",
"path": "dossiers/nuit-cop-24-par-philippe-garbit",
"type": "dossier",
"title": "Nuit COP 24, Par Philippe Garbit",
"standFirst": null
}
}
]
}
}
}
Retrieve the id of a taxonomy by its path
Example for a sub-theme:
{
taxonomies(source: UNIFIED, paths: ["sciences-savoirs/sciences"]) {
edges {
cursor
node {
id
path
type
title
standFirst
}
}
}
}
Response
{
"data": {
"taxonomies": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "cc6810e9-da63-4398-b8b6-efccd8d089da_0",
"path": "sciences-savoirs/sciences",
"type": "theme",
"title": "Sciences",
"standFirst": "Écoutez des podcasts de sciences : biologie, physique, astronomie, mathématiques, géographie, archéologie... Vous pourrez comprendre les sciences par des entretiens avec les scientifiques d'aujourd'hui, apprendre l'histoire des sciences et connaître l'actualité de la recherche scientifique."
}
}
]
}
}
}
Retrieve diffusions from one or more taxonomies
Let's take the example where we want to retrieve only content related to the politics theme. We could obtain the theme's identifier by querying the taxonomies field, and then execute the following query:
{
diffusions(
station: FRANCEINTER
themes: ["f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0"]
) {
edges {
cursor
node {
id
title
standFirst
url
published_date
taxonomiesConnection {
edges {
node {
id
path
title
}
}
}
}
}
}
}
Response
{
"data": {
"diffusions": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "52ff3a44-55b2-401b-9ce9-7364ea69d801_1",
"title": "Thomas Piketty et Philippe Manière : Argentine, les enseignements de l'élection de Javier Milei",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/le-debat-du-7-10/le-debat-du-7-10-du-mardi-21-novembre-2023-3460671",
"published_date": "1700553980",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "Mg==",
"node": {
"id": "ffb84f4d-a1fe-4ee1-8990-c4be8421d649_1",
"title": "L'Invité de 7H50 du mardi 21 novembre 2023",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/l-invite-de-7h50/l-invite-de-7h50-du-mardi-21-novembre-2023-9305095",
"published_date": "1700549340",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "cd07ffad-cb10-4f6b-9020-2668d539fa89_0",
"path": "info",
"title": "Info"
}
},
{
"node": {
"id": "ef694d8a-2ca2-4d45-bcb2-cc87cebbff8d_0",
"path": "societe",
"title": "Société"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "Mw==",
"node": {
"id": "1cc39a72-12d7-4856-b4a3-12e7a856e14e_1",
"title": "IA : votre robot conversationnel est-il militant ?",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/l-edito-politique/l-edito-politique-du-mardi-21-novembre-2023-5718865",
"published_date": "1700549010",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "NA==",
"node": {
"id": "2d560a9e-0e68-4ae1-bde1-4872c3000905_1",
"title": "La question migratoire, carburant des populistes en Europe",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/dominique-reynie-en-toute-subjectivite/dominique-reynie-en-toute-subjectivite-du-mardi-21-novembre-2023-2023080",
"published_date": "1700547590",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "NQ==",
"node": {
"id": "6b4221eb-eef2-4402-a8fa-31efbd09f15d_1",
"title": "Trump, modèle ambigu pour Marine Le Pen",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/histoires-politiques/histoires-politiques-du-mardi-21-novembre-2023-3148840",
"published_date": "1700545340",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
}
]
}
}
}
If it is a sub-theme, be sure to replace the theme argument with subtheme or subsubtheme if it is a third-level theme.
Example of retrieving diffusions by sub-theme:
{
# sous theme: politique/democratie-et-vie-citoyenne
diffusions(
station: FRANCEINTER
subthemes: ["90a83929-c886-414e-a3b7-82b6c08908b4_0"]
) {
edges {
cursor
node {
id
title
standFirst
url
published_date
taxonomiesConnection {
edges {
node {
id
path
title
}
}
}
}
}
}
}
Response
{
"data": {
"diffusions": {
"edges": [
{
"cursor": "MQ==",
"node": {
"id": "52ff3a44-55b2-401b-9ce9-7364ea69d801_1",
"title": "Thomas Piketty et Philippe Manière : Argentine, les enseignements de l'élection de Javier Milei",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/le-debat-du-7-10/le-debat-du-7-10-du-mardi-21-novembre-2023-3460671",
"published_date": "1700553980",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
},
{
"cursor": "Mg==",
"node": {
"id": "2d560a9e-0e68-4ae1-bde1-4872c3000905_1",
"title": "La question migratoire, carburant des populistes en Europe",
"standFirst": "",
"url": "https://www.franceinter.fr/franceinter/podcasts/dominique-reynie-en-toute-subjectivite/dominique-reynie-en-toute-subjectivite-du-mardi-21-novembre-2023-2023080",
"published_date": "1700547590",
"taxonomiesConnection": {
"edges": [
{
"node": {
"id": "90a83929-c886-414e-a3b7-82b6c08908b4_0",
"path": "politique/democratie-et-vie-citoyenne",
"title": "Vie citoyenne"
}
},
{
"node": {
"id": "f15e4e03-0f8d-4d43-abaf-e1d6a9b98ea6_0",
"path": "politique",
"title": "Politique"
}
}
]
}
}
}
]
}
}
}
danger
Each filter is exclusive, operating on logical AND operations rather than logical OR operations.