Skip to main content

Introduction

Radio France's Open API now provides access to the program grid for all the group's stations in a programmatic manner (e.g. knowing which program is playing at a given time on a given station), including information on the stations, shows, and podcasts.

Format

Radio France's Open API is in the Graphql format. We advise you to begin by familiarising yourself with the Graphql syntax, described on the official website GraphQL | A query language for your API

First steps

API calls are made via POST queries to the URL https://openapi.radiofrance.fr Access to the Open API (including its documentation) is protected by a key, also known as an API token.

To request an API key :

  • visit the portal https://developers.radiofrance.fr
  • create an account
  • then click on "request an API key" in the "my account" section. You will need to briefly enter the name of your project, as well as its purpose. Your request will then be processed by our teams, and you will subsequently receive your API key by email.

You will need to use this key for each Open API call:

  • either in the x-token HTTP header
  • or by adding the x-token setting to the URL

The documentation is (briefly) self-documented at the following address https://openapi.radiofrance.fr/v1/graphql?x-token=votre-token-d-api

caution

Ensure that you correctly enter your API key in the URL field of the API explorer