Register record·API·FR·AGENCYSTALE · checked 3d ago
A
API to query theses.fr dataAPI Interroger les Données de theses.fr
API Interroger les Données de theses.frAPI to query theses.fr data
This API allows searching the theses.fr database, which describes doctoral theses and people linked to them, such as authors and supervisors. Data can be retrieved in JSON format. It is intended for anyone who wants to query the theses.fr website and obtain data on French doctoral theses programmatically rather than through the web interface. The service is maintained by the Agence bibliographique de l'enseignement supérieur (ABES), the French agency responsible for higher education bibliographic data, and provides free access without authentication.It covers France nationally.It applies to education.It supports open data initiatives.L’API permet de lancer une recherche dans les données de theses.fr décrivant les thèses et les personnes liées aux thèses. Les données sont récupérables au format JSON. L'API s'adresse à toutes les personnes qui souhaitent interroger le site theses.fr, récupérer les données relatives aux thèses de…
education
Trust score
How is this computed?64
good
Weighted across five axes. Tap a ring for what it measures.
Data schema (90 fields)
Filterable via the API (9)
idqtrifiltresdebutnombreppnnumSujetindex
| Field | Type | Description |
|---|---|---|
| id | string | Internal record identifier.Internal record identifier. |
| q | string | Search query string to look up in theses.fr.chaine à rechercher |
| tri | string | Sort order applied to search results.Type de tri |
| filtres | string | Filters applied to the thesis search.filtres |
| debut | integer (int32) | Index of the first thesis in the returned batch.indice de la première thèse du lot |
| nombre | integer (int32) | Number of theses to return in the batch.nombre de thèse du lot |
| ppn | string | PPN identifier of the institution or organization.PPN de l'établissement/organisme |
| numSujetNum sujet | string | Identifier number of the subject.Identifier number of the subject. |
| index | string | Name of the index to query.nom de l'index à réquêter |
| tokenSignalerErreurDto | string | Security token for the error report submission.Security token for the error report submission. |
| urlSignalerErreurDto | string | URL of the page where the error was found.URL of the page where the error was found. |
| nomSignalerErreurDto | string | Last name of the person submitting the report.Last name of the person submitting the report. |
| prenomSignalerErreurDto | string | First name of the person submitting the report.First name of the person submitting the report. |
| mailSignalerErreurDto | string | Email address of the person submitting the report.Email address of the person submitting the report. |
| domaineSignalerErreurDto | string | Domain or category of the reported issue.Domain or category of the reported issue. |
| objetSignalerErreurDto | string | Subject/title of the error report.Subject/title of the error report. |
| questionSignalerErreurDto | string | Description of the reported question or issue.Description of the reported question or issue. |
| appSourceSignalerErreurDto | string | Application from which the report was sent.Application from which the report was sent. |
| etabPpnSignalerErreurDto | string | PPN of the institution related to the report.PPN of the institution related to the report. |
| typeOrganismeResponseDto | string | Type of the organization.Type of the organization. |
| keywordSujetsToMap | string | Keyword used to look up related subjects.Keyword used to look up related subjects. |
| querySujetsToMap | string | Query string used for subject mapping.Query string used for subject mapping. |
| titrePrincipalTheseResponseDto | string | Main title of the thesis.Main title of the thesis. |
| nntTheseResponseDto | string | National thesis number (NNT) identifier.National thesis number (NNT) identifier. |
| doiTheseResponseDto | string | Digital Object Identifier of the thesis.Digital Object Identifier of the thesis. |
| dateSoutenanceTheseResponseDto | string | Date the thesis was defended.Date the thesis was defended. |
| datePremiereInscriptionDoctoratTheseResponseDto | string | Date of first enrollment in doctoral studies.Date of first enrollment in doctoral studies. |
| disciplineTheseResponseDto | string | Academic discipline of the thesis.Academic discipline of the thesis. |
| titresTheseResponseDto | object | Titles of the thesis in different languages.Titles of the thesis in different languages. |
| resumesTheseResponseDto | object | Abstracts of the thesis in different languages.Abstracts of the thesis in different languages. |
| etabSoutenanceTheseResponseDto | object | Institution where the thesis was defended.Institution where the thesis was defended. |
| codeEtabTheseResponseDto | string | Code identifying the institution.Code identifying the institution. |
| etabCotutelleTheseResponseDto | array<object> | Co-supervising institutions involved in the thesis.Co-supervising institutions involved in the thesis. |
| partenairesRechercheTheseResponseDto | array<object> | Research partner organizations of the thesis.Research partner organizations of the thesis. |
| mapSujetsTheseResponseDto | object | Mapping of subject keywords associated with the thesis.Mapping of subject keywords associated with the thesis. |
| membresJuryTheseResponseDto | array<object> | Members of the thesis defense jury.Members of the thesis defense jury. |
| rapporteursTheseResponseDto | array<object> | Reviewers/referees of the thesis.Reviewers/referees of the thesis. |
| auteursTheseResponseDto | array<object> | Authors of the thesis.Authors of the thesis. |
| directeursTheseResponseDto | array<object> | Supervisors/directors of the thesis.Supervisors/directors of the thesis. |
| languesTheseResponseDto | array<string> | Languages the thesis is written in.Languages the thesis is written in. |
| casTheseResponseDto | string | Case or status code of the thesis record.Case or status code of the thesis record. |
| accessibleTheseResponseDto | string | Accessibility status of the thesis document.Accessibility status of the thesis document. |
| ecolesDoctoralesTheseResponseDto | array<object> | Doctoral schools associated with the thesis.Doctoral schools associated with the thesis. |
| presidentJuryTheseResponseDto | object | President of the thesis defense jury.President of the thesis defense jury. |
| sourceTheseResponseDto | string | Data source of the thesis record.Data source of the thesis record. |
| statusTheseResponseDto | string | Status of the thesis.Status of the thesis. |
| isSoutenueTheseResponseDto | boolean | Whether the thesis has been defended.Whether the thesis has been defended. |
| contentTypeView | string | Content type of the returned view.Content type of the returned view. |
| totalHitsResponseTheseLiteDto | integer (int64) | Total number of theses matching the search.Total number of theses matching the search. |
| tookResponseTheseLiteDto | integer (int64) | Time taken to execute the search, in milliseconds.Time taken to execute the search, in milliseconds. |
| thesesResponseTheseLiteDto | array<object> | List of thesis records returned by the search.List of thesis records returned by the search. |
| langueSujet | string | Language of the subject label.Language of the subject label. |
| libelleSujet | string | Label or name of the subject.Label or name of the subject. |
| titreENTheseLiteResponseDto | string | English title of the thesis.English title of the thesis. |
| etabSoutenanceNTheseLiteResponseDto | string | Name of the institution where the thesis was defended.Name of the institution where the thesis was defended. |
| etabSoutenancePpnTheseLiteResponseDto | string | PPN of the institution where the thesis was defended.PPN of the institution where the thesis was defended. |
| examinateursTheseLiteResponseDto | array<object> | Examiners on the thesis defense jury.Examiners on the thesis defense jury. |
| presidentTheseLiteResponseDto | object | President of the thesis defense jury.President of the thesis defense jury. |
| ecolesDoctoraleTheseLiteResponseDto | array<object> | Doctoral schools associated with the thesis.Doctoral schools associated with the thesis. |
| partenairesDeRechercheTheseLiteResponseDto | array<object> | Research partner organizations of the thesis.Research partner organizations of the thesis. |
| sujetsTheseLiteResponseDto | array<object> | Subjects/keywords describing the thesis.Subjects/keywords describing the thesis. |
| sujetsRameauTheseLiteResponseDto | array<object> | RAMEAU subject headings describing the thesis.RAMEAU subject headings describing the thesis. |
| totalHitsetabSoutenanceThesesByOrganismeResponseDto | integer (int64) | Total number of theses defended at the institution.Total number of theses defended at the institution. |
| totalHitsetabSoutenanceEnCoursThesesByOrganismeResponseDto | integer (int64) | Total number of ongoing theses at the institution.Total number of ongoing theses at the institution. |
| etabSoutenanceEnCoursThesesByOrganismeResponseDto | array<object> | Ongoing theses being prepared at the institution.Ongoing theses being prepared at the institution. |
| totalHitspartenaireRechercheThesesByOrganismeResponseDto | integer (int64) | Total number of theses linked to this research partner.Total number of theses linked to this research partner. |
| partenaireRechercheThesesByOrganismeResponseDto | array<object> | Research partner organizations linked to the institution.Research partner organizations linked to the institution. |
| totalHitspartenaireRechercheEnCoursThesesByOrganismeResponseDto | integer (int64) | Total number of ongoing theses linked to this research partner.Total number of ongoing theses linked to this research partner. |
| partenaireRechercheEnCoursThesesByOrganismeResponseDto | array<object> | Ongoing theses linked to this research partner.Ongoing theses linked to this research partner. |
| totalHitsetabCotutelleThesesByOrganismeResponseDto | integer (int64) | Total number of theses with this co-supervising institution.Total number of theses with this co-supervising institution. |
| totalHitsetabCotutelleEnCoursThesesByOrganismeResponseDto | integer (int64) | Total number of ongoing theses with this co-supervising institution.Total number of ongoing theses with this co-supervising institution. |
| etabCotutelleEnCoursThesesByOrganismeResponseDto | array<object> | Ongoing theses with this co-supervising institution.Ongoing theses with this co-supervising institution. |
| totalHitsecoleDoctoraleThesesByOrganismeResponseDto | integer (int64) | Total number of theses linked to this doctoral school.Total number of theses linked to this doctoral school. |
| ecoleDoctoraleThesesByOrganismeResponseDto | array<object> | Doctoral schools linked to the institution.Doctoral schools linked to the institution. |
| totalHitsecoleDoctoraleEnCoursThesesByOrganismeResponseDto | integer (int64) | Total number of ongoing theses linked to this doctoral school.Total number of ongoing theses linked to this doctoral school. |
| ecoleDoctoraleEnCoursThesesByOrganismeResponseDto | array<object> | Ongoing theses linked to this doctoral school.Ongoing theses linked to this doctoral school. |
| nameCheckbox | string | Internal name of the checkbox filter option.Internal name of the checkbox filter option. |
| labelCheckbox | string | Display label of the checkbox filter option.Display label of the checkbox filter option. |
| valueCheckbox | integer (int64) | Count of results matching the checkbox filter option.Count of results matching the checkbox filter option. |
| parentNameCheckbox | string | Name of the parent category for this filter.Name of the parent category for this filter. |
| searchBarFacet | boolean | Whether a search bar is displayed for this facet.Whether a search bar is displayed for this facet. |
| checkboxesFacet | array<object> | List of checkbox filter options within this facet.List of checkbox filter options within this facet. |
| has_idrefPersonneLiteResponseDto | boolean | Whether the person has an IdRef identifier.Whether the person has an IdRef identifier. |
| rolesPersonneLiteResponseDto | object | Roles held by the person in theses (author, director, etc.).Roles held by the person in theses (author, director, etc.). |
| disciplinesPersonneLiteResponseDto | array<string> | Academic disciplines associated with the person.Academic disciplines associated with the person. |
| etablissementsPersonneLiteResponseDto | array<string> | Institutions associated with the person.Institutions associated with the person. |
| personnesRechercheResponseDto | array<object> | List of person records returned by the search.List of person records returned by the search. |
| mots_clesPersonneResponseDto | object | Keywords associated with the person.Keywords associated with the person. |
| suggestionSuggestionPersonneResponseDto | string | Suggested person name matching the search.Suggested person name matching the search. |
| thematiquesSuggestionResponseDto | array<object> | Thematic suggestions related to the search query.Thematic suggestions related to the search query. |
Schema captured from openapi 1 month ago.
Verification Status
Using the API
Configuration
- Base URL
- https://theses.fr
- Format
- openapi
Query examples
curl -s 'https://theses.fr/api/v1/recherche/openapi.yaml' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.