{"openapi":"3.1.0","info":{"title":"Apizie: research","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://www.apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/research:pubmed/abstract":{"get":{"operationId":"research_pubmed_abstract","summary":"Abstract","description":"Title, abstract, authors, journal and identifiers for PubMed IDs (parsed from efetch XML).","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"description":"PMID or comma-separated PMIDs (max 50)","schema":{"type":"string","description":"PMID or comma-separated PMIDs (max 50)"},"example":"33301246"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/annotation-search":{"get":{"operationId":"research_pubmed_annotation_search","summary":"Annotation Search","description":"Search PubTator3 by free text or entity ID (e.g. @CHEMICAL_remdesivir).","tags":["research"],"parameters":[{"name":"text","in":"query","required":true,"schema":{"type":"string"},"example":"@CHEMICAL_remdesivir"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","date"],"default":"relevance"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/annotations":{"get":{"operationId":"research_pubmed_annotations","summary":"Annotations","description":"PubTator3 entity annotations (genes, diseases, chemicals, …) for PMIDs.","tags":["research"],"parameters":[{"name":"pmids","in":"query","required":true,"schema":{"type":"string"},"example":"29355051"},{"name":"full","in":"query","required":false,"description":"Use PMC full text when available","schema":{"type":"boolean","default":false,"description":"Use PMC full text when available"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/citation-export":{"get":{"operationId":"research_pubmed_citation_export","summary":"Citation Export","description":"Formatted citation for a PubMed/PMC article (NCBI Literature Citation Exporter).","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"db","in":"query","required":false,"schema":{"type":"string","enum":["pubmed","pmc"],"default":"pubmed"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["csl","ris","medline"],"default":"csl"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/citation-match":{"get":{"operationId":"research_pubmed_citation_match","summary":"Citation Match","description":"Find a PMID from journal, year, volume, first page and author (ecitmatch).","tags":["research"],"parameters":[{"name":"journal","in":"query","required":true,"schema":{"type":"string"},"example":"proc natl acad sci u s a"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","minimum":1800,"maximum":2100},"example":1991},{"name":"volume","in":"query","required":false,"schema":{"type":"string"},"example":"88"},{"name":"firstPage","in":"query","required":false,"schema":{"type":"string"},"example":"3248"},{"name":"author","in":"query","required":false,"schema":{"type":"string"},"example":"mann bj"},{"name":"key","in":"query","required":false,"schema":{"type":"string","default":"q1"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/citation-metrics":{"get":{"operationId":"research_pubmed_citation_metrics","summary":"Citation Metrics","description":"Citation counts, Relative Citation Ratio and NIH percentile for PMIDs (NIH iCite).","tags":["research"],"parameters":[{"name":"pmids","in":"query","required":true,"schema":{"type":"string"},"example":"23456789,27599104"},{"name":"includeCitationLists","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/database-info":{"get":{"operationId":"research_pubmed_database_info","summary":"Database Info","description":"Record count, last update, searchable fields and link names of one Entrez database.","tags":["research"],"parameters":[{"name":"db","in":"query","required":true,"schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"]},"example":"pubmed"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/databases":{"get":{"operationId":"research_pubmed_databases","summary":"Databases","description":"List all Entrez databases (einfo).","tags":["research"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/research:pubmed/entity-autocomplete":{"get":{"operationId":"research_pubmed_entity_autocomplete","summary":"Entity Autocomplete","description":"Look up PubTator3 entity IDs by name.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"remdes"},{"name":"concept","in":"query","required":false,"schema":{"type":"string","enum":["gene","disease","chemical","species","variant","cellline"]}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":50,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/entity-relations":{"get":{"operationId":"research_pubmed_entity_relations","summary":"Entity Relations","description":"Entities related to a PubTator3 entity, optionally filtered by relation type and target.","tags":["research"],"parameters":[{"name":"e1","in":"query","required":true,"schema":{"type":"string"},"example":"@CHEMICAL_Doxorubicin"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["ANY","treat","cause","cotreat","compare","interact","inhibit","stimulate","drug_interact","associate","prevent","positive_correlate","negative_correlate"],"default":"ANY"}},{"name":"e2","in":"query","required":false,"schema":{"type":"string"},"example":"disease"},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":20,"minimum":1,"maximum":200,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/fetch-records":{"get":{"operationId":"research_pubmed_fetch_records","summary":"Fetch Records","description":"Raw efetch output (XML, text or ASN.1) for IDs in any Entrez database.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"db","in":"query","required":false,"description":"Entrez database","schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed","description":"Entrez database"}},{"name":"rettype","in":"query","required":false,"schema":{"type":"string","enum":["abstract","medline","uilist","fasta","gb","gp","docsum","full","native","xml"]}},{"name":"retmode","in":"query","required":false,"schema":{"type":"string","enum":["xml","text","asn.1"],"default":"xml"}},{"name":"retstart","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"retmax","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500}},{"name":"strand","in":"query","required":false,"schema":{"type":"string","enum":["1","2"]}},{"name":"seqStart","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"seqStop","in":"query","required":false,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/gene-report/{symbol}/{taxon}":{"get":{"operationId":"research_pubmed_gene_report","summary":"Gene Report","description":"Gene description, location, synonyms and optional GO terms from the NCBI Datasets v2 API.","tags":["research"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"example":"BRCA1"},{"name":"taxon","in":"path","required":true,"description":"Taxon name or NCBI tax ID","schema":{"type":"string","description":"Taxon name or NCBI tax ID"},"example":"human"},{"name":"includeGeneOntology","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/id-convert":{"get":{"operationId":"research_pubmed_id_convert","summary":"Id Convert","description":"Convert between PMID, PMCID, DOI and manuscript IDs (PMC ID Converter API).","tags":["research"],"parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"example":"PMC3531190,23193287"},{"name":"idtype","in":"query","required":false,"schema":{"type":"string","enum":["pmid","pmcid","doi","mid"]}},{"name":"versions","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/link-check":{"get":{"operationId":"research_pubmed_link_check","summary":"Link Check","description":"Check which links exist for IDs (elink acheck/ncheck/lcheck). Returns the raw linkset.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"dbfrom","in":"query","required":false,"schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed"}},{"name":"cmd","in":"query","required":false,"schema":{"type":"string","enum":["acheck","ncheck","lcheck"],"default":"acheck"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/link-provider":{"get":{"operationId":"research_pubmed_link_provider","summary":"Link Provider","description":"LinkOut providers / full-text URLs for IDs (elink llinks/prlinks). Returns the raw linkset.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"dbfrom","in":"query","required":false,"schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed"}},{"name":"cmd","in":"query","required":false,"schema":{"type":"string","enum":["llinks","prlinks"],"default":"prlinks"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/link":{"get":{"operationId":"research_pubmed_link","summary":"Link","description":"Related records in the same or another Entrez database (elink).","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"dbfrom","in":"query","required":false,"schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed"}},{"name":"db","in":"query","required":false,"schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed"}},{"name":"cmd","in":"query","required":false,"schema":{"type":"string","enum":["neighbor","neighbor_score","neighbor_history"],"default":"neighbor"}},{"name":"linkname","in":"query","required":false,"schema":{"type":"string"},"example":"pubmed_pubmed_citedin"},{"name":"maxLinks","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/post":{"get":{"operationId":"research_pubmed_post","summary":"Post","description":"Store IDs on the Entrez history server (epost) and return the WebEnv + query key.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246,32109013"},{"name":"db","in":"query","required":false,"description":"Entrez database","schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed","description":"Entrez database"}},{"name":"webEnv","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/research:pubmed/search":{"get":{"operationId":"research_pubmed_search","summary":"Search","description":"Run an Entrez query and return matching IDs (enable `summaries` to fetch PubMed metadata in the same call).","tags":["research"],"parameters":[{"name":"term","in":"query","required":true,"description":"Entrez query","schema":{"type":"string","description":"Entrez query"},"example":"covid vaccine efficacy"},{"name":"db","in":"query","required":false,"description":"Entrez database","schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed","description":"Entrez database"}},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":20,"minimum":1,"maximum":200,"description":"Results per page"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","pubDate","author","journalName","mostRecent"],"default":"relevance"}},{"name":"field","in":"query","required":false,"description":"Restrict search to a field, e.g. title","schema":{"type":"string","description":"Restrict search to a field, e.g. title"}},{"name":"datetype","in":"query","required":false,"schema":{"type":"string","enum":["pdat","edat","mdat"]}},{"name":"mindate","in":"query","required":false,"description":"YYYY or YYYY/MM/DD","schema":{"type":"string","description":"YYYY or YYYY/MM/DD"}},{"name":"maxdate","in":"query","required":false,"description":"YYYY or YYYY/MM/DD","schema":{"type":"string","description":"YYYY or YYYY/MM/DD"}},{"name":"reldate","in":"query","required":false,"description":"Only items from the last N days","schema":{"type":"integer","minimum":1,"description":"Only items from the last N days"}},{"name":"usehistory","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"summaries","in":"query","required":false,"description":"Also fetch esummary for the returned PubMed IDs","schema":{"type":"boolean","default":false,"description":"Also fetch esummary for the returned PubMed IDs"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":900,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/spell":{"get":{"operationId":"research_pubmed_spell","summary":"Spell","description":"Spelling suggestions for an Entrez query (espell).","tags":["research"],"parameters":[{"name":"term","in":"query","required":true,"schema":{"type":"string"},"example":"asthmaa"},{"name":"db","in":"query","required":false,"description":"Entrez database","schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed","description":"Entrez database"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/summary":{"get":{"operationId":"research_pubmed_summary","summary":"Summary","description":"Document summaries (esummary) for one or more comma-separated IDs.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246,32109013"},{"name":"db","in":"query","required":false,"description":"Entrez database","schema":{"type":"string","enum":["pubmed","protein","nuccore","ipg","nucleotide","structure","genome","grasp","annotinfo","assembly","bioproject","biosample","blastdbinfo","books","cdd","clinvar","dbvar","gene","gds","geoprofiles","medgen","mesh","nlmcatalog","omim","orgtrack","pmc","proteinclusters","pcassay","protfam","pccompound","pcsubstance","seqannot","snp","sra","taxonomy","biocollections","gtr"],"default":"pubmed","description":"Entrez database"}},{"name":"version","in":"query","required":false,"schema":{"type":"string","enum":["1.0","2.0"],"default":"2.0"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/trials-detail/{nctId}":{"get":{"operationId":"research_pubmed_trials_detail","summary":"Trials Detail","description":"Full ClinicalTrials.gov record for an NCT ID.","tags":["research"],"parameters":[{"name":"nctId","in":"path","required":true,"schema":{"type":"string"},"example":"NCT04368728"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:pubmed/trials-search":{"get":{"operationId":"research_pubmed_trials_search","summary":"Trials Search","description":"Search ClinicalTrials.gov studies (API v2) by condition, keyword and status.","tags":["research"],"parameters":[{"name":"condition","in":"query","required":false,"schema":{"type":"string"},"example":"diabetes"},{"name":"term","in":"query","required":false,"schema":{"type":"string"},"example":"insulin"},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["NOT_YET_RECRUITING","RECRUITING","ENROLLING_BY_INVITATION","ACTIVE_NOT_RECRUITING","SUSPENDED","TERMINATED","COMPLETED","WITHDRAWN","AVAILABLE","NO_LONGER_AVAILABLE","TEMPORARILY_NOT_AVAILABLE","APPROVED_FOR_MARKETING","WITHHELD","UNKNOWN"]}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}},{"name":"cursor","in":"query","required":false,"description":"nextCursor from a previous page","schema":{"type":"string","description":"nextCursor from a previous page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/article-by-doi/{doi}":{"get":{"operationId":"research_doaj_article_by_doi","summary":"Article By Doi","description":"Find a DOAJ article by DOI.","tags":["research"],"parameters":[{"name":"doi","in":"path","required":true,"schema":{"type":"string"},"example":"10.3390/su12010001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/article/{articleId}":{"get":{"operationId":"research_doaj_article","summary":"Article","description":"One DOAJ article by its DOAJ ID.","tags":["research"],"parameters":[{"name":"articleId","in":"path","required":true,"schema":{"type":"string"},"example":"0001a2b3c4d5e6f7a8b9c0d1e2f3a4b5"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/articles-by-journal":{"get":{"operationId":"research_doaj_articles_by_journal","summary":"Articles By Journal","description":"Articles published in the journal with this ISSN.","tags":["research"],"parameters":[{"name":"issn","in":"query","required":true,"schema":{"type":"string"},"example":"2071-1050"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/harvest-articles":{"get":{"operationId":"research_doaj_harvest_articles","summary":"Harvest Articles","description":"Bulk-harvest article records via DOAJ's OAI-PMH endpoint.","tags":["research"],"parameters":[{"name":"verb","in":"query","required":false,"schema":{"type":"string","enum":["ListRecords","ListIdentifiers"],"default":"ListRecords"}},{"name":"metadataPrefix","in":"query","required":false,"schema":{"type":"string","enum":["oai_dc","oai_doaj"],"default":"oai_dc"}},{"name":"set","in":"query","required":false,"description":"OAI set spec (see harvest-sets)","schema":{"type":"string","description":"OAI set spec (see harvest-sets)"}},{"name":"from","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string","description":"YYYY-MM-DD"}},{"name":"until","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string","description":"YYYY-MM-DD"}},{"name":"cursor","in":"query","required":false,"description":"resumptionToken from a previous page","schema":{"type":"string","description":"resumptionToken from a previous page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/research:doaj/harvest-journals":{"get":{"operationId":"research_doaj_harvest_journals","summary":"Harvest Journals","description":"Bulk-harvest journal records via DOAJ's OAI-PMH endpoint.","tags":["research"],"parameters":[{"name":"verb","in":"query","required":false,"schema":{"type":"string","enum":["ListRecords","ListIdentifiers"],"default":"ListRecords"}},{"name":"set","in":"query","required":false,"description":"OAI set spec (see harvest-sets)","schema":{"type":"string","description":"OAI set spec (see harvest-sets)"}},{"name":"from","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string","description":"YYYY-MM-DD"}},{"name":"until","in":"query","required":false,"description":"YYYY-MM-DD","schema":{"type":"string","description":"YYYY-MM-DD"}},{"name":"cursor","in":"query","required":false,"description":"resumptionToken from a previous page","schema":{"type":"string","description":"resumptionToken from a previous page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/research:doaj/harvest-sets":{"get":{"operationId":"research_doaj_harvest_sets","summary":"Harvest Sets","description":"List the OAI-PMH sets (subject classes) DOAJ exposes.","tags":["research"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/research:doaj/journal-by-issn/{issn}":{"get":{"operationId":"research_doaj_journal_by_issn","summary":"Journal By Issn","description":"Find a DOAJ journal by print or electronic ISSN.","tags":["research"],"parameters":[{"name":"issn","in":"path","required":true,"schema":{"type":"string"},"example":"2071-1050"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/journal/{journalId}":{"get":{"operationId":"research_doaj_journal","summary":"Journal","description":"One DOAJ journal by its DOAJ ID.","tags":["research"],"parameters":[{"name":"journalId","in":"path","required":true,"schema":{"type":"string"},"example":"f3f2e7f23d444370ae5f5199f85bc100"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/journals-by-country":{"get":{"operationId":"research_doaj_journals_by_country","summary":"Journals By Country","description":"Journals whose publisher is in a country (ISO 3166-1 alpha-2 code).","tags":["research"],"parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"string"},"example":"ID"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/journals-by-publisher":{"get":{"operationId":"research_doaj_journals_by_publisher","summary":"Journals By Publisher","description":"Journals from a publisher name.","tags":["research"],"parameters":[{"name":"publisher","in":"query","required":true,"schema":{"type":"string"},"example":"MDPI"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/journals-by-subject":{"get":{"operationId":"research_doaj_journals_by_subject","summary":"Journals By Subject","description":"Journals classified under a subject term.","tags":["research"],"parameters":[{"name":"subject","in":"query","required":true,"schema":{"type":"string"},"example":"Medicine"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/search-articles":{"get":{"operationId":"research_doaj_search_articles","summary":"Search Articles","description":"Search DOAJ articles (Elasticsearch query-string syntax).","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"climate change"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","createdAt","updatedAt","title","year"],"default":"relevance"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:doaj/search-journals":{"get":{"operationId":"research_doaj_search_journals","summary":"Search Journals","description":"Search DOAJ journals.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"public health"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Results per page"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","createdAt","updatedAt","title"],"default":"relevance"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/annotations-by-article":{"get":{"operationId":"research_europepmc_annotations_by_article","summary":"Annotations By Article","description":"Text-mined annotations (genes, diseases, organisms, …) for articles, e.g. MED:28585529 or PMC:PMC4357394.","tags":["research"],"parameters":[{"name":"articleIds","in":"query","required":true,"schema":{"type":"string"},"example":"MED:28585529"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["Gene_Proteins","Chemicals","Diseases","Organisms","Accession Numbers","Gene Ontology","Sequence Ontology","Experimental Methods","Cell","Cell Line","Body Part"]}},{"name":"section","in":"query","required":false,"schema":{"type":"string","enum":["Title","Abstract","Introduction","Methods","Results","Discussion","Conclusion"]}},{"name":"annotationProvider","in":"query","required":false,"schema":{"type":"string"},"example":"Europe PMC"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/annotations-by-provider":{"get":{"operationId":"research_europepmc_annotations_by_provider","summary":"Annotations By Provider","description":"Page through all articles annotated by a given provider.","tags":["research"],"parameters":[{"name":"annotationProvider","in":"query","required":true,"schema":{"type":"string"},"example":"Europe PMC"},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":8,"minimum":1,"maximum":8,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/article":{"get":{"operationId":"research_europepmc_article","summary":"Article","description":"Core metadata (incl. abstract) for one article by source + ID.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["MED","PMC","PPR","AGR","CBA","CTX","ETH","HIR","PAT","NBK"],"default":"MED"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/citations":{"get":{"operationId":"research_europepmc_citations","summary":"Citations","description":"Articles that cite the given article.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["MED","PMC","PPR","AGR","CBA","CTX","ETH","HIR","PAT","NBK"],"default":"MED"}},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":25,"minimum":1,"maximum":1000,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/database-links":{"get":{"operationId":"research_europepmc_database_links","summary":"Database Links","description":"Cross-references from an article to biological databases (UniProt, PDB, ENA, …).","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["MED","PMC","PPR","AGR","CBA","CTX","ETH","HIR","PAT","NBK"],"default":"MED"}},{"name":"database","in":"query","required":false,"schema":{"type":"string"},"example":"UNIPROT"},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":25,"minimum":1,"maximum":1000,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/full-text":{"get":{"operationId":"research_europepmc_full_text","summary":"Full Text","description":"Open-access full text (JATS XML) of a PMC article, with title, abstract and plain-text body.","tags":["research"],"parameters":[{"name":"pmcid","in":"query","required":true,"schema":{"type":"string"},"example":"PMC3531190"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/labs-links":{"get":{"operationId":"research_europepmc_labs_links","summary":"Labs Links","description":"External 'Labs' links (data, reviews, recommendations) for an article.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["MED","PMC","PPR","AGR","CBA","CTX","ETH","HIR","PAT","NBK"],"default":"MED"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/profile":{"get":{"operationId":"research_europepmc_profile","summary":"Profile","description":"Hit counts for a query broken down by source and publication type.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"malaria"},{"name":"synonym","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/references":{"get":{"operationId":"research_europepmc_references","summary":"References","description":"Reference list of the given article.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"33301246"},{"name":"source","in":"query","required":false,"schema":{"type":"string","enum":["MED","PMC","PPR","AGR","CBA","CTX","ETH","HIR","PAT","NBK"],"default":"MED"}},{"name":"page","in":"query","required":false,"description":"1-based page number","schema":{"type":"integer","default":1,"minimum":1,"maximum":500,"description":"1-based page number"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":25,"minimum":1,"maximum":1000,"description":"Results per page"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/search-post":{"post":{"operationId":"research_europepmc_search_post","summary":"Search Post","description":"Same as search, but takes a JSON body (for very long queries).","tags":["research"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"},"resultType":{"type":"string","enum":["idlist","lite","core"],"default":"lite"},"cursor":{"type":"string","description":"nextCursor from a previous page"},"limit":{"type":"integer","default":25,"minimum":1,"maximum":1000,"description":"Results per page"},"sort":{"type":"string","enum":["relevance","dateAsc","dateDesc","citedAsc","citedDesc"],"default":"relevance"},"synonym":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":900,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:europepmc/search":{"get":{"operationId":"research_europepmc_search","summary":"Search","description":"Search Europe PMC publications with its query syntax; paginate with `cursor`.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"malaria AND OPEN_ACCESS:y"},{"name":"resultType","in":"query","required":false,"schema":{"type":"string","enum":["idlist","lite","core"],"default":"lite"}},{"name":"cursor","in":"query","required":false,"description":"nextCursor from a previous page","schema":{"type":"string","description":"nextCursor from a previous page"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","default":25,"minimum":1,"maximum":1000,"description":"Results per page"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["relevance","dateAsc","dateDesc","citedAsc","citedDesc"],"default":"relevance"}},{"name":"synonym","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":900,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/works":{"get":{"operationId":"research_openalex_works","summary":"Search works","description":"Papers, books and datasets.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"retrieval augmented generation"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"filter","in":"query","required":false,"schema":{"type":"string"},"example":"publication_year:2024,is_oa:true"},{"name":"sort","in":"query","required":false,"schema":{"type":"string"},"example":"cited_by_count:desc"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/work":{"get":{"operationId":"research_openalex_work","summary":"Work","description":"One work by OpenAlex id or DOI.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"doi:10.1038/nature14539"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/authors":{"get":{"operationId":"research_openalex_authors","summary":"Search authors","description":"Authors with works and citation counts.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"Yoshua Bengio"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/institutions":{"get":{"operationId":"research_openalex_institutions","summary":"Search institutions","description":"Universities and research organizations.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"MIT"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:openalex/topics":{"get":{"operationId":"research_openalex_topics","summary":"Search topics","description":"Research topics with work counts.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"climate change"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:crossref/works":{"get":{"operationId":"research_crossref_works","summary":"Search works","description":"Bibliographic search.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"attention is all you need"},{"name":"rows","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":1000,"description":"Number of results"}},{"name":"filter","in":"query","required":false,"schema":{"type":"string"},"example":"from-pub-date:2023-01-01,type:journal-article"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:crossref/doi":{"get":{"operationId":"research_crossref_doi","summary":"DOI","description":"Metadata for one DOI.","tags":["research"],"parameters":[{"name":"doi","in":"query","required":true,"schema":{"type":"string"},"example":"10.1038/s41586-021-03819-2"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:crossref/journals":{"get":{"operationId":"research_crossref_journals","summary":"Journals","description":"Search journals by title.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"nature"},{"name":"rows","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":1000,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:semantic-scholar/search":{"get":{"operationId":"research_semantic_scholar_search","summary":"Search papers","description":"Relevance search.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"large language models"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Number of results"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","default":"title,year,authors,citationCount,url,tldr"}},{"name":"year","in":"query","required":false,"schema":{"type":"string"},"example":"2023-2025"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:semantic-scholar/paper":{"get":{"operationId":"research_semantic_scholar_paper","summary":"Paper","description":"One paper by S2 id, DOI:, ARXIV: or CorpusId:.","tags":["research"],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"},"example":"ARXIV:1706.03762"},{"name":"fields","in":"query","required":false,"schema":{"type":"string","default":"title,year,abstract,authors,citationCount,referenceCount,url,tldr"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:semantic-scholar/author-search":{"get":{"operationId":"research_semantic_scholar_author_search","summary":"Search authors","description":"Authors by name.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"Fei-Fei Li"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":1000,"description":"Number of results"}},{"name":"fields","in":"query","required":false,"schema":{"type":"string","default":"name,hIndex,citationCount,paperCount,affiliations"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:gbif/species-match":{"get":{"operationId":"research_gbif_species_match","summary":"Match species","description":"Best match in the GBIF backbone for a name.","tags":["research"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"example":"Puma concolor"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:gbif/species-search":{"get":{"operationId":"research_gbif_species_search","summary":"Search species","description":"Full-text taxon search.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"oak"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":1000,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:gbif/occurrences":{"get":{"operationId":"research_gbif_occurrences","summary":"Occurrences","description":"Observation and specimen records.","tags":["research"],"parameters":[{"name":"scientificName","in":"query","required":false,"schema":{"type":"string"},"example":"Panthera tigris"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"example":"IN"},{"name":"year","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":300,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:inaturalist/observations":{"get":{"operationId":"research_inaturalist_observations","summary":"Observations","description":"Recent research-grade observations.","tags":["research"],"parameters":[{"name":"taxon","in":"query","required":false,"schema":{"type":"string"},"example":"Monarch butterfly"},{"name":"placeId","in":"query","required":false,"schema":{"type":"integer"}},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":20,"minimum":1,"maximum":200,"description":"Number of results"}},{"name":"qualityGrade","in":"query","required":false,"schema":{"type":"string","enum":["research","needs_id","casual"],"default":"research"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":900,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/research:inaturalist/taxa":{"get":{"operationId":"research_inaturalist_taxa","summary":"Taxa","description":"Search taxa by name.","tags":["research"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"fox"},{"name":"perPage","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}