{"openapi":"3.1.0","info":{"title":"MGnify API","version":"1.0.0","description":"MGnify as an API, powered by EMBL-EBI — the world's largest free resource for the analysis and archiving of microbiome sequencing data, and the metagenomics sister to PRIDE (proteomics) and MetaboLights (metabolomics). MGnify holds tens of thousands of public metagenomics and metabarcoding studies spanning the human gut microbiome, marine and freshwater environments, soils, wastewater, the built environment and host-associated communities. Search the studies by keyword, getting each study's MGnify accession (MGYS...), name, abstract, biome, sample count and the source sequencing BioProject; read a study's full metadata including its name and abstract, biome classification, number of samples, submitting centre, public status, data origination and last-update date; and browse the GOLD-style biome classification tree — from root:Host-associated:Human:Digestive system to root:Environmental:Aquatic:Marine — with per-biome sample and study counts, for discovery by environment. Ideal for microbiome and environmental-genomics research, dataset reuse and meta-analysis, bioinformatics pipelines and teaching. Study accessions look like MGYS00006862. Data from EMBL-EBI MGnify.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mgnify-api","description":"oanor gateway"}],"tags":[{"name":"Metagenomics"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/biomes":{"get":{"operationId":"get_v1_biomes","tags":["Metagenomics"],"summary":"Biome classification tree","description":"","parameters":[{"name":"page","in":"query","required":false,"description":"Page (1-based)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max biomes (1-200)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":50,"total":491,"biomes":[{"biome":"root:Engineered","samples_count":291},{"biome":"root:Engineered:Biogas plant","samples_count":126},{"biome":"root:Engineered:Biogas plant:Wet fermentation","samples_count":111},{"biome":"root:Engineered:Bioreactor","samples_count":1003},{"biome":"root:Engineered:Bioreactor:Continuous culture","samples_count":648},{"biome":"root:Engineered:Bioreactor:Continuous culture:Marine intertidal flat sediment inoculum","samples_count":23},{"biome":"root:Engineered:Bioreactor:Continuous culture:Marine intertidal flat sediment inoculum:Wadden Sea-Germany","samples_count":5},{"biome":"root:Engineered:Bioreactor:Continuous culture:Marine sediment inoculum","samples_count":35},{"biome":"root:Engineered:Bioreactor:Continuous culture:Marine sediment inoculum:Wadden Sea-Germany","samples_count":8},{"biome":"root:Engineered:Bioremediation","samples_count":49},{"biome":"root:Engineered:Bioremediation:Hydrocarbon","samples_count":65},{"biome":"root:Engineered:Bioremediation:Hydrocarbon:Benzene","samples_count":0},{"biome":"root:Engineered:Bioremediation:Hydrocarbon:Benzene:Bioreactor","samples_count":2},{"biome":"root:Engineered:Bioremediation:Metal","samples_count":0},{"biome":"root:Engineered:Bioremediation:Persistent organic pollutants (POP)","samples_count":53},{"biome":"root:Engineered:Bioremediation:Persistent organic pollutants (POP):Polycyclic aromatic hydrocarbons","samples_count":0},{"biome":"root:Engineered:Bioremediation:Terephthalate","samples_count":0},{"biome":"root:Engineered:Bioremediation:Terephthalate:Wastewater","samples_count":92},{"biome":"root:Engineered:Bioremediation:Terephthalate:Wastewater:Activated sludge","samples_count":0},{"biome":"root:Engineered:Bioremediation:Terephthalate:Wastewater:Bioreactor","samples_count":4},{"biome":"root:Engineered:Bioremediation:Tetrachloroethylene and derivatives","samples_count":0},{"biome":"root:Engineered:Bioremediation:Tetrachloroethylene and derivatives:Chloroethene","samples_count":0},{"biome":"root:Engineered:Bioremediation:Tetrachloroethylene and derivatives:Chloroethene:Bioreactor","samples_count":0},{"biome":"root:Engineered:Bioremediation:Tetrachloroethylene and derivatives:Tetrachloroethylene","samples_count":0},{"biome":"root:Engineered:Bioremediation:Tetrachloroethylene and derivatives:Tetrachloroethylene:Bioreactor","samples_count":0},{"biome":"root:Engineered:Biotransformation","samples_count":13},{"biome":"root:Engineered:Biotransformation:Microbial enhanced oil recovery","samples_count":8},{"biome":"root:Engineered:Biotransformation:Microbial solubilization of coal","samples_count":0},{"biome":"root:Engineered:Biotransformation:Mixed alcohol bioreactor","samples_count":25},{"biome":"root:Engineered:Built environment","samples_count":758},{"biome":"root:Engineered:Food production","samples_count":394},{"biome":"root:Engineered:Food production:Dairy products","samples_count":1829},{"biome":"root:Engineered:Food production:Fermented beverages","samples_count":270},{"biome":"root:Engineered:Food production:Fermented seafood","samples_count":26},{"biome":"root:Engineered:Food production:Fermented vegetables","samples_count":395},{"biome":"root:Engineered:Food production:Silage fermentation","samples_count":12},{"biome":"root:Engineered:Industrial production","samples_count":13},{"biome":"root:Engineered:Industrial production:Engineered product","samples_count":0},{"biome":"root:Engineered:Lab enrichment","samples_count":259},{"biome":"root:Engineered:Lab enrichment:Defined media","samples_count":80},{"biome":"root:Engineered:Lab enrichment:Defined media:Aerobic media","samples_count":0},{"biome":"root:Engineered:Lab enrichment:Defined media:Anaerobic media","samples_count":63},{"biome":"root:Engineered:Lab enrichment:Defined media:Marine media","samples_count":53},{"biome":"root:Engineered:Lab enrichment:Defined media:Marine media:Algoconsortia","samples_count":0},{"biome":"root:Engineered:Lab enrichment:Undefined media","samples_count":0},{"biome":"root:Engineered:Lab Synthesis","samples_count":176},{"biome":"root:Engineered:Lab Synthesis:Genetic cross","samples_count":26},{"biome":"root:Engineered:Modeled","samples_count":99},{"biome":"root:Engineered:Modeled:Simulated communities (DNA mixture)","samples_count":89},{"biome":"root:Engineered:Modeled:Simulated communities (microbial mixture)","samples_count":656}]},"meta":{"timestamp":"2026-06-01T16:24:05.959Z","request_id":"ba1b8ef0-c00b-4f78-9706-ff1ccb5c4341"},"status":"ok","message":"Biomes retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/studies":{"get":{"operationId":"get_v1_studies","tags":["Metagenomics"],"summary":"Search metagenomics studies","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search text, e.g. marine","schema":{"type":"string"},"example":"marine"},{"name":"page","in":"query","required":false,"description":"Page (1-based)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":20,"query":"marine","total":953,"studies":[{"id":"MGYS00006861","name":"Marine metagenomic library of Baltic Sea collected in Latvia","biome":"root:Environmental:Aquatic:Marine","abstract":"Marine metagenomic library of Baltic Sea from three distinct locations collected during the period from August to October 2024 in Latvia","bioproject":"PRJEB88144","last_update":"2026-01-16T10:55:30","samples_count":25},{"id":"MGYS00006848","name":"EMG produced TPA metagenomics assembly of PRJNA553005 data set (Metagenomic views of microbial dynamics influenced by hydrocarbon seepages in sediments of Gulf of Mexico).","biome":"root:Environmental:Aquatic:Marine:Sediment","abstract":"The Third Party Annotation (TPA) assembly was derived from the primary whole genome shotgun (WGS) data set PRJNA553005, and was assembled with metaspades v3.15.3. This project includes samples from the following biomes: root:Environmental:Aquatic:Marine:Sediment.","bioproject":"PRJEB75476","last_update":"2025-08-26T14:50:09","samples_count":7},{"id":"MGYS00006491","name":"EMG produced TPA metagenomics assembly of PRJEB4352 data set (Shotgun Sequencing of Tara Oceans DNA samples corresponding to size fractions for protist).","biome":"root:Environmental:Aquatic:Marine","abstract":"The Third Party Annotation (TPA) assembly was derived from the primary whole genome shotgun (WGS) data set PRJEB4352, and was assembled with megahit v1.2.9. This project includes samples from the following biomes: root:Environmental:Aquatic:Marine.","bioproject":"PRJEB60351","last_update":"2025-07-04T02:30:33","samples_count":827},{"id":"MGYS00006813","name":"EMG produced TPA metagenomics assembly of PRJNA375455 data set (Marine microbial communities from the Southern Atlantic ocean transect to study dissolved organic matter and carbon cycling - Knorr_S15_td_AAIW_ad_750m_LV_A metagenome).","biome":"root:Environmental:Aquatic:Marine","abstract":"The Third Party Annotation (TPA) assembly was derived from the primary whole genome shotgun (WGS) data set PRJNA375455, and was assembled with metaspades v3.15.3. This project includes samples from the following biomes: root:Environmental:Aquatic:Marine.","bioproject":"PRJEB68340","last_update":"2025-05-30T12:57:44","samples_count":1},{"id":"MGYS00006784","name":"EMG produced TPA metagenomics assembly of PRJEB52452 data set (Malaspina Expedition 2010 Microbial Vertical Profiles Metagenomes).","biome":"root:Environmental:Aquatic:Marine","abstract":"The Third Party Annotation (TPA) assembly was derived from the primary whole genome shotgun (WGS) data set PRJEB52452, and was assembled with metaspades v3.15.3. This project includes samples from the following biomes: root:Environmental:Aquatic:Marine.","bioproject":"PRJEB73722","last_update":"2025-03-21T09:53:45","samples_count":81},{"id":"MGYS00006762","name":"Atlantic salmon gut microbiome after nutritional programming across development","biome":"root:Host-associated:Fish:Digestive system","abstract":"In this study, we investigated the impact of NP with a plant-based (V) diet at first feeding in Atlantic salmon on gut microbial composition, diversity, and microbial community functions, compared to fish fed a traditional marine-based (M) diet. We fed the fish for a brief period of two weeks at fir","bioproject":"PRJNA1054346","last_update":"2025-03-11T18:25:20","samples_count":137},{"id":"MGYS00006761","name":"Microbiome of different gut regions after nutritional programming","biome":"root:Host-associated:Fish:Digestive system","abstract":"The aim of this study is to investigate the impact of NP using either plant (V) diet in comparison to marine (M) diet (as control) on the microbiota of three gut regions (pyloric caeca, middle and distal intestines) in Atlantic salmon. A 22-week feeding experiment was conducted in a recirculating aq","bioproject":"PRJNA1061573","last_update":"2025-03-11T12:16:00","samples_count":125},{"id":"MGYS00006758","name":"The response of salmon intestinal microbiota to nutritional programming and its interaction with genotype","biome":"root:Host-associated:Fish:Digestive system","abstract":"A full life cycle feeding trial was performed on two groups of Atlantic salmon selected based on their pigment retention (high or low pigment; HP and LP, respectively,) which at first feeding were either offered a diet rich in marine (M) or terrestrial (V) ingredients. The impact that first feeding ","bioproject":"PRJEB73592","last_update":"2025-03-07T17:02:25","samples_count":135},{"id":"MGYS00006756","name":"Metagenomic exploration of Surface waters from the Andaman and Nicobar Islands, India.","biome":"root:Environmental:Aquatic:Marine","abstract":"The 16s rRNA gene amplicon and shotgun metagenomic sequencing was carried out to examine the taxonomic and functional diversity analysis of microbial communities in surface waters from Andaman and Nicobar Islands, India. The potential effects of Anthropogenic activities in coastal marine waters on m","bioproject":"PRJNA822508","last_update":"2025-03-07T12:48:23","samples_count":14},{"id":"MGYS00006724","name":"Annual Dynamics of Bacterial & Archaeal Communities in the West Spitsbergen Current (2018-2019)","biome":"root:Environmental:Aquatic:Marine","abstract":"This dataset contains 16S rRNA amplicon sequences, derived from autonomous sampling between August 2018 to August 2019 in the West Spitsbergen Current (mooring F4-S-3). The data is part of the LTER \"FRAM\" (Fram Strait, Arctic Ocean) of the Alfred Wegener Institute Helmholtz Centre for Polar and Mari","bioproject":"PRJEB65742","last_update":"2024-08-12T11:21:43","samples_count":27},{"id":"MGYS00006722","name":"Annual Dynamics of Microeukaryotic Communities in the West Spitsbergen Current (2018-2019)","biome":"root:Environmental:Aquatic:Marine","abstract":"18S rRNA amplicon sequences derived from autonomous sampling in the West Spitsbergen Current (mooring F4-S-3).","bioproject":"PRJEB66212","last_update":"2024-08-12T11:17:27","samples_count":27},{"id":"MGYS00006723","name":"Annual Dynamics of Microeukaryotic Communities in the West Spitsbergen Current (2019-2020)","biome":"root:Environmental:Aquatic:Marine","abstract":"18S rRNA amplicon sequences derived from autonomous sampling in the West Spitsbergen Current (mooring F4-S-4).","bioproject":"PRJEB66220","last_update":"2024-08-12T11:16:58","samples_count":24},{"id":"MGYS00006720","name":"Annual Dynamics of Bacterial & Archaeal Communities in the West Spitsbergen Current (2018-2019)","biome":"root:Environmental:Aquatic:Marine","abstract":"16S rRNA amplicon sequences derived from autonomous sampling in the West Spitsbergen Current (mooring F4-S-3).","bioproject":"PRJEB67813","last_update":"2024-08-12T11:10:40","samples_count":27},{"id":"MGYS00006719","name":"Annual Dynamics of Bacterial & Archaeal Communities in the East Greenland Current (2018-2019)","biome":"root:Environmental:Aquatic:Marine","abstract":"16S rRNA amplicon sequences derived from autonomous sampling in the East Greenland Current (mooring EGC-5).","bioproject":"PRJEB54562","last_update":"2024-08-12T11:10:20","samples_count":26},{"id":"MGYS00006717","name":"Annual Dynamics of Microeukaryotic Communities in Fram Strait (2016-2017)","biome":"root:Environmental:Aquatic:Marine","abstract":"18S rRNA amplicon sequences derived from moored autonomous samplers. Moorings: F4-S-1, HG-IV-S-1, Fevi-34, EGC-3","bioproject":"PRJEB43504","last_update":"2024-08-12T11:08:03","samples_count":95},{"id":"MGYS00006718","name":"Annual Dynamics of Bacterial & Archaeal Communities in the East Greenland Current (2019-2020)","biome":"root:Environmental:Aquatic:Marine","abstract":"16S rRNA amplicon sequences derived from autonomous sampling in the East Greenland Current (mooring EGC-6).","bioproject":"PRJEB54586","last_update":"2024-08-12T11:03:58","samples_count":13},{"id":"MGYS00006714","name":"Regional and vertical patterns in microbial communities across Fram Strait (2015-2019)","biome":"root:Environmental:Aquatic:Marine","abstract":"This study portrays bacterial and archaeal community composition over five summers in the Arctic Fram Strait (80°N). The dataset includes 16S rRNA gene amplicons derived from annual samplings along a longitudinal transect (6°W–12°E) from the surface to the lower photic zone, covering Arctic- / Atlan","bioproject":"PRJEB66267","last_update":"2024-08-12T11:01:27","samples_count":205},{"id":"MGYS00006716","name":"Annual Dynamics of Microeukaryotic Communities in Fram Strait (2017-2018)","biome":"root:Environmental:Aquatic:Marine","abstract":"18S rRNA amplicon sequences derived from moored autonomous samplers. Moorings: F4-S-2, HG-IV-S-2, Fevi-36, EGC-4.","bioproject":"PRJEB43885","last_update":"2024-08-12T11:00:38","samples_count":88},{"id":"MGYS00006715","name":"Pelagic free-living and particle-associated microbial communities across Fram Strait","biome":"root:Environmental:Aquatic:Marine","abstract":"Water samples were collected in Fram Strait during the Polarstern cruise PS99.2 (June 24th – July 16th 2016) from Greenland shelf to west coast of Spitsbergen. For assessing bacterial and archaeal community composition 4-8 L of water were filtered with peristaltic pump through successive membrane fi","bioproject":"PRJEB30254","last_update":"2024-08-12T10:44:02","samples_count":65},{"id":"MGYS00006712","name":"Annual Dynamics of Bacterial & Archaeal Communities in Fram Strait (2016-2017)","biome":"root:Environmental:Aquatic:Marine","abstract":"16S rRNA amplicon sequences derived from moored autonomous samplers. Moorings: F4-S-1, HG-IV-S-1, Fevi-34, EGC-3.","bioproject":"PRJEB43890","last_update":"2024-08-12T10:39:02","samples_count":94}]},"meta":{"timestamp":"2026-06-01T16:24:08.536Z","request_id":"81cf9c21-44ab-4c91-81cd-f6358d69e51f"},"status":"ok","message":"Studies retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/study":{"get":{"operationId":"get_v1_study","tags":["Metagenomics"],"summary":"A study metadata","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"MGnify accession, e.g. MGYS00006862","schema":{"type":"string"},"example":"MGYS00006862"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"study":{"id":"MGYS00006862","url":"https://www.ebi.ac.uk/metagenomics/studies/MGYS00006862","name":"Metagenome assembly of PRJNA715245 data set (human gut metagenome Metagenome)","biome":"root:Host-associated:Human:Digestive system:Large intestine","abstract":"The Third Party Annotation (TPA) assembly was derived from the primary data set PRJNA715245","bioproject":"PRJEB92327","centre_name":"EMG","last_update":"2026-04-24T07:54:59","samples_count":84,"data_origination":"SUBMITTED","secondary_accession":"ERP175206"}},"meta":{"timestamp":"2026-06-01T16:24:08.688Z","request_id":"736f0eee-fd5f-4ea0-8571-e5845ce5baf3"},"status":"ok","message":"Study retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"MGnify is EMBL-EBI's resource for the analysis and archiving of microbiome sequencing data — the metagenomics sister to PRIDE (proteomics) and MetaboLights (metabolomics). /v1/studies?search=marine = search public metagenomics & metabarcoding studies (gut microbiome, marine, soil, wastewater, host-associated and environmental), returning each study's MGnify accession (MGYS…), name, abstract, biome, sample count and source BioProject; /v1/study?id=MGYS00006862 = a study's full metadata (name, abstract, biome classification, sample count, submitting centre, public status, source BioProject, last update); /v1/biomes (paginate with page & limit) = the GOLD-style biome classification tree (e.g. root:Host-associated:Human:Digestive system:Large intestine, root:Environmental:Aquatic:Marine) with per-biome sample and study counts, for discovery by environment. Study accessions look like MGYS00006862. Data from EMBL-EBI MGnify. For proteomics datasets see the PRIDE API, for metabolomics MetaboLights, for protein sequences UniProt.","source":"EMBL-EBI MGnify metagenomics API (ebi.ac.uk/metagenomics)","endpoints":["/v1/studies","/v1/study","/v1/biomes","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:24:08.776Z","request_id":"d99bf91e-21ad-4fc5-aacd-a26c0c8fc877"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":562,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":21400,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2010,"monthly_call_quota":90800,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5620,"monthly_call_quota":393000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mgnify-api"}