{"id":"0a6b896e-77bf-4f81-b0f2-2d64bbfcd8aa","type":"API","name":"API Gallica Recherche","slug":"api-gallica-recherche","description":"L'API Recherche permet d'interroger le fonds de la bibliothèque numérique de la BnF, [Gallica](https://gallica.bnf.fr/). Les documents résultats d'une requête peuvent ensuite être exploités par le moyen de l'[API Document](/les-api/api_gallica_document). ### A quoi sert-elle ? L’API Recherche s'i…","free_access_class":"FREE_KEY_REQUIRED","auth_type":"API_KEY","homepage_url":"https://www.data.gouv.fr/dataservices/api-gallica-recherche","docs_url":"http://api.bnf.fr/api-gallica-de-recherche","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["business","culture","digital","weather"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/f0/7d02be08b749529c3e58d34ff8c504-100.png","primary_source_url":"https://www.data.gouv.fr/dataservices/api-gallica-recherche","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:35.699Z","updated_at":"2026-08-14T20:16:26.522Z","last_verified_at":"2026-08-11T20:10:00.423Z","deprecated_at":null,"ranking_score":58,"last_ranked_at":"2026-08-04T07:50:41.646Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-05T15:04:54.473Z","search_vector":"'/).':25B,175B '/les-api/api_gallica_document':43B,193B 'a':194B,244B 'access':127B,279B 'across':73B,225B 'actual':109B,261B 'allow':54B 'allows':206B 'an':278B 'and':234B,264B,276B,286B 'api':1A,6A,8B,41B,50B,53B,105B,151A,156A,158B,191B,200B,205B,257B 'applic':137B 'applications':289B 'as':229B 'be':249B 'bibliotheque':167B,217B,272B 'bibliothèqu':17B,65B,120B 'bnf':21B,69B,171B,221B 'book':78B 'books':230B 'build':136B 'building':288B 'busi':147C 'by':243B,270B 'can':247B 'collect':57B,146B 'collections':209B,298B 'companion':102B,254B 'content':111B,263B 'cultur':148C 'd':11B,29B,161B,179B 'de':15B,19B,39B,67B,122B,165B,169B,189B,219B,274B 'develop':133B 'developers':285B 'digit':61B,74B,144B,149C 'digital':213B 'digitized':226B,296B 'document':27B,42B,75B,104B,110B,192B,256B,262B 'documents':177B,227B 'ell':48B 'elle':198B 'enabl':71B 'enables':223B 'ensuit':33B 'ensuite':183B 'etre':184B 'exploites':185B 'exploité':35B 'fond':14B 'fonds':164B 'for':284B 'franc':68B,123B,141B 'france':220B,275B,293B 'further':250B 'gallica':2A,4A,22B,59B,86B,103B,152A,154A,172B,211B,238B,255B 'gallica.bnf.fr':24B,174B 'gallica.bnf.fr/).':23B,173B 'held':84B,236B 'heritag':145B 'heritage':297B 'hold':88B 'holdings':240B 'i':203B 'imag':81B 'images':233B 'in':237B 'institut':135B 'institutions':287B 'intend':131B 'intended':283B 'interrog':12B 'interroger':162B 'is':268B,282B 'it':222B,281B 'key':128B,280B 'l':7B,40B,49B,157B,190B,199B 'la':16B,20B,166B,170B 'le':13B,37B,163B,187B 'les':26B,176B 'librari':62B 'library':214B 'maintain':117B 'maintained':269B 'manuscript':80B 'manuscripts':232B 'map':83B 'maps':235B 'metadata':113B,265B 'moyen':38B,188B 'nation':143B 'national':66B,121B,295B 'nationale':218B,273B 'newspap':79B 'newspapers':231B 'numerique':168B 'numériqu':18B 'of':210B,215B,292B 'on':290B 'par':36B,186B 'permet':10B,160B 'peuvent':32B,182B 'process':99B 'processed':251B 'queri':55B,94B 'query':246B 'querying':207B 'quoi':45B,195B 'recherch':3A,9B,51B 'recherche':153A,159B,201B 'requete':181B 'requir':125B 'requires':277B 'requêt':31B 'result':89B 'resultats':178B 'results':241B 'retriev':107B 'retrieves':259B 'return':90B 'returned':242B 'résultat':28B 's':202B,239B,294B 'search':5A,72B,93B,155A,224B,245B 'sert':47B,197B 'sert-ell':46B 'sert-elle':196B 'servic':115B 'service':267B 'such':228B 'the':208B,212B,216B,253B,260B,266B,271B 'then':248B 'this':204B 'top':139B,291B 'une':30B,180B 'use':100B 'using':252B 'weather':150C 'which':258B 'être':34B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"90e341c1-ab58-4ccf-8a64-940a03e70433","institution_type":"AGENCY","country_code":"FR","official_confidence":40,"proof_summary":"official domain (data.gouv.fr) (catalog: api_gouv_fr)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-07T22:08:35.699Z","geographic_scope":"NATIONAL","name_en":"Gallica Search API","description_en":"This API allows querying the collections of Gallica, the digital library of the Bibliothèque nationale de France (BnF). It enables search across digitized documents such as books, newspapers, manuscripts, images, and maps held in Gallica's holdings. Results returned by a search query can then be further processed using the companion Gallica Document API, which retrieves the actual document content and metadata. The service is maintained by the Bibliothèque nationale de France and requires an access key. It is intended for developers and institutions building applications on top of France's national digitized heritage collections.","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"sample","trust_score":63.25,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://gallica.bnf.fr","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://gallica.bnf.fr","source":"probe","runnable":true},{"kind":"spec","label":"OpenAPI spec","method":"GET","url":"https://api.bnf.fr/sites/default/files/2021-02/api-gallica-recherche.yaml","source":"openapi","runnable":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"http://api.bnf.fr/api-gallica-de-recherche","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-gallica-recherche","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"0a6b896e-77bf-4f81-b0f2-2d64bbfcd8aa","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":"verified","rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":false,"reached":false,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"90e341c1-ab58-4ccf-8a64-940a03e70433","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"www.data.gouv.fr","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-08-16T13:59:39.217Z"},"api_details":{"id":"5e023517-7b50-427c-b88f-8e293b15a3da","entry_id":"0a6b896e-77bf-4f81-b0f2-2d64bbfcd8aa","base_url":"https://gallica.bnf.fr","openapi_url":"https://api.bnf.fr/sites/default/files/2021-02/api-gallica-recherche.yaml","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://gallica.bnf.fr","created_at":"2026-06-07T22:08:35.718Z","updated_at":"2026-06-07T22:08:35.718Z"},"dataset_details":null,"license":{"id":"lo-2.0","spdx_id":"etalab-2.0","name":"Licence Ouverte 2.0 (France / Etalab)","url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","is_open":true,"is_redistributable":true,"requires_attribution":true,"category":"national","notes":null,"created_at":"2026-06-12T16:29:19.729Z"},"reuse":{"license_id":"lo-2.0","license_name":"Licence Ouverte 2.0 (France / Etalab)","license_url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","commercial_use":{"status":"yes","value":true},"redistribution":{"status":"yes","value":true},"attribution_required":{"status":"yes","value":true},"share_alike":{"status":"no","value":false},"personal_data_warning":{"status":"yes","value":true},"cache_and_mirror":{"status":"yes","value":true},"undetermined":[],"basis":"licence_text","confidence":0.95,"confidence_tier":"high","source_text":"Texte de la licence - le reutilisateur est libre \"de la communiquer, la reproduire, la copier ; de l'adapter, la modifier, l'extraire et la transformer, notamment pour creer des Informations derivees ; de la diffuser, la redistribuer, la publier et la transmettre, de l'exploiter a titre commercial\". Seule obligation : \"mentionner la paternite de l'Information : sa source (a minima le nom du Concedant) et la date de la derniere mise a jour\". Le texte rappelle que le reutilisateur doit respecter \"le cadre legal relatif a la protection des donnees a caractere personnel\". Aucune clause de partage a l'identique n'est imposee.","source_url":"https://github.com/etalab/licence-ouverte/blob/master/LO.md","reviewed_at":null},"license_raw":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","latest_check":{"id":"853efb16-7bfa-4c73-830b-c52cf01d9238","entry_id":"0a6b896e-77bf-4f81-b0f2-2d64bbfcd8aa","status":"VERIFIED","last_checked_at":"2026-08-11T20:10:00.101Z","p50_latency_ms":2161,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:07.926Z","updated_at":"2026-08-11T20:10:00.101Z","consecutive_successes":40,"probe_url":"https://gallica.bnf.fr","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html; charset=UTF-8","probe_succeeded_at":"2026-08-11T20:10:00.101Z"},"data_profile":{"id":"71681d5d-0ef0-4dbc-aee3-f6e45c3c6388","entry_id":"0a6b896e-77bf-4f81-b0f2-2d64bbfcd8aa","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"version","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/SRU","filterable":true,"description":"la version de la norme SRU implémentée (ici 1.2)","enum_values":["1.2"],"description_en":"Version of the SRU protocol implemented (currently 1.2)."},{"name":"operation","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/SRU","filterable":true,"description":"l'opération à  effectuer (ici, searchRetrieve)","enum_values":["searchRetrieve"],"description_en":"The SRU operation to perform, here searchRetrieve."},{"name":"query","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/SRU","filterable":true,"description":"la requête à effectuer pour obtenir les résultats souhaités, écrite en langage CQL (\"Contextual Query Language\", https://www.loc.gov/standards/sru/cql)","description_en":"Search query expressed in CQL (Contextual Query Language)."},{"name":"startRecord","role":"parameter","type":"integer (int64)","label":null,"format":"int64","param_in":"query","container":"/SRU","filterable":true,"description":"l'index du système de pagination, compris entre 1 et le nombre maximal de résultats renvoyés par la requête (information fournie dans le flux XML : balise <srw:numberOfRecords>).","description_en":"Pagination index of the first result to return."},{"name":"maximumRecords","role":"parameter","type":"integer (int64)","label":null,"format":"int64","param_in":"query","container":"/SRU","filterable":true,"description":"le nombre de résultats retournés par le service (compris entre 0 et au maximum 50). Par défaut, si ce paramètre est absent, la valeur est de 15.","description_en":"Number of results to return, from 0 up to 50 (default 15)."},{"name":"collapsing","role":"parameter","type":"boolean","label":null,"param_in":"query","container":"/SRU","filterable":true,"description":"ce paramètre permet d'agréger (valeur \"true\") les résultats dans le cas d'un document multivolume ou d'un périodique. La valeur \"disabled\" permet d'obtenir tous les documents.","description_en":"Whether to group results for multivolume documents or periodicals."},{"name":"SRU","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/services/Categories","filterable":true,"description":"le paramètre SRU est la requête écrite en CQL (voir service searchRetrieve)","description_en":"CQL query parameter used for the searchRetrieve service."}],"field_count":7,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://api.bnf.fr/sites/default/files/2021-02/api-gallica-recherche.yaml","curl":"curl -s 'https://api.bnf.fr/sites/default/files/2021-02/api-gallica-recherche.yaml' -H 'Accept: application/json'","label":"OpenAPI spec","method":"GET","description":"Machine-readable API description (use it to generate clients)."}],"status":"partial","error_message":null,"profiled_at":"2026-07-21T23:53:48.156Z","run_id":"7c1d8efa-36e6-4743-9052-7bccad27a1de","created_at":"2026-06-12T19:23:06.698Z","updated_at":"2026-07-21T23:53:48.156Z","license_raw":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","license_id":"lo-2.0","consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false},"datasets":[],"limits":[]}