L'API Poisson diffuse les données collectées lors d'opérations de pêches scientifiques à l'électricité réalisées par l'Office français de la biodiversité (OFB) et et ses partenaires. Ces données concernent les observations, les indicateurs, les opérations et les stations de prélèvement. Elles couvrent la France hexagonale (Corse comprise) sur plus de 50 années de collecte. Elles sont bancarisées dans l'outil Aspe opéré par l'OFB.
L'API Poisson donne accès à la quasi totalité des données de l'outil de gestion Aspe opéré par l'OFB. Celui-ci est ouvert à l'ensemble des producteurs désireux de bancariser leurs données piscicoles. Pour toute demande d'information, merci de vous rendre sur le site aspe.eaufrance.fr.
La v0 de l'API, basée sur les données de l'ancienne base IMAGE, n'est désormais plus accessible.
Faites-nous part de vos commentaires sur le forum de contribution Github 
25/03/2025 : Diffusion des lots de type G
21/11/2023 : ajout de trois nouveaux endpoints
09/02/2023 : arrêt de la v0 de l'API
16/06/2022 : v1.0.0
03/01/2019 : v0.3.1
22/05/2018 : v0.3.0
29/11/2017 : ajout de dans la réponse de l'attribut api_version (string) : version de l'API (https://semver.org/)
04/05/2017 : mise à jour de l'adresse de l'API api.hubeau.fr vers hubeau.eaufrance.fr/api/
21/09/2016 : ajout des libellés SANDRE à côté des codes SANDRE dans la réponse
08/08/2016 : ajout du paramètre fields, la valeur est une liste des champs souhaités dans la réponse (fonctionnalité expérimentale), par exemple fields=code_station,localisation
Les formats supportés sont : JSON, GeoJSON et CSV.
L'API est accessible :
Pour gérer le cross-domain, l'API supporte les protocoles :
Chaque page renvoie un nombre de résultats égal au paramètre size.
L'API Poisson utilise un type de pagination non séquentiel qui permet de sauter d'une page à l'autre de résultats dans n'importe quel ordre. En contre-partie, la profondeur d'accès aux résultats est limitée.
Un tutoriel sur l'API Qualité des cours d'eau explique, dans la partie Taille des pages de réponse, la mise en oeuvre pratique de la pagination à l'aide d'un cas concret.
Enfin, des exemples de code en Python, R et php sont disponibles dans la partie Exemples de la page de contribution GitHub de Hub'Eau.
Les résultats sont paginés avec une valeur par défaut et une valeur maximum de taille de page pour chaque opération.
Cette valeur est indiquée dans les commentaires de l'opération. Par exemple : "taille de page par défaut : 5000, taille max de la page : 20000."
la profondeur d'accès aux résultats (numéro de la page * nombre maximum de résultats dans une page) est limitée à 20 000 enregistrements. Cette limite peut empêcher la récupération de l'intégralité des résultats d'une requête ; il faut alors découper la requête en plusieurs requêtes à l'aide de critères plus discriminants.
La longueur maximale d'une URL est de 2 083 caractères, la requête est bloquée si la limite de longueur est dépassée.
Elle permet d'accéder aux données des opérations de prélèvement réalisées sur les stations de mesure de la qualité des cours d'eau.
Elle permet d'accéder aux données des observations piscicoles réalisées lors des opérations de prélèvement.
Les observations piscicoles sont regroupées par lots de différentes natures (cf. nomenclature Sandre de code 434)
| Code | Mnémonique | Libellé |
| G | Lot G | Lot de groupe sans mesures individuelles |
| I | Lot I | Lot de groupe avec mesure individuelle |
| N | Lot N | Mesure individuelle |
| S_L | Lot S/L | Lot de groupe avec sous échantillon |
| S | Lot S | Sous échantillon associé à un lot de groupe |
| L | Lot L | Lot de groupe avec sous échantillon |
Concernant les lots dits S/L, les codes de type de lot "S_L" et "S" ne sont pas usités. L’ensemble des informations se trouvent dans les lignes associées au lot L.
Ainsi :
Elle permet d'accéder aux données des indicateurs IPR et IPRPlus calculés à partir des observations piscicoles.
Elle permet d'accéder aux données des stations de mesure de la qualité des cours d'eau.
URL appelée : https://hubeau.eaufrance.fr/api/v1/etat_piscicole/observations?code_alternatif_taxon=ABL&size=20
Résultats : Voir les résultats
URL appelée : https://hubeau.eaufrance.fr/api/v1/etat_piscicole/observations?libelle_commune=Longuyon&size=100
Résultats : Voir les résultats
URL appelée : https://hubeau.eaufrance.fr/api/v1/etat_piscicole/observations?code_station=05001800&nom_commun_taxon=gardon&date_operation_min=2021-01-01&date_operation_max=2021-12-31&size=50
Résultats : Voir les résultats
URL appelée : https://hubeau.eaufrance.fr/api/v1/etat_piscicole/observations?libelle_entite_hydro=loire&nom_commun_taxon=chevaine&taille_individu_min=530&size=20
Résultats : Voir les résultats
Observations piscicoles des lots G
URL appelée : https://hubeau.eaufrance.fr/api/v1/etat_piscicole/observations?code_type_lot=G&size=20
Résultats : Voir les résultats
Exemple d’URL d’interrogation des observations piscicoles des lots G et N
URL appelée : https://hubeau.eaufrance.fr/api/v1/etat_piscicole/observations?code_type_lot=G,N&size=20
Résultats : Voir les résultats