{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"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"}}},"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"}}}}}}}