Skip to content
AveraAveraAvera Documentation

Search external literature databases

POST
/api/v1/literature/external/search
curl --request POST \
  --url https://app.avera.io/api/v1/literature/external/search \
  --header 'Content-Type: application/json' \
  --data '{ "query": "example", "databases": [ "example" ], "maxResults": 1, "condition": "example", "intervention": "example", "trialStatus": [ "example" ] }'

Proxies one search across the requested external databases, PubMed and ClinicalTrials.gov, and returns structured article and study metadata that can seed literature search records and appraisals.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
query
required
string
databases
required
Array<string>
maxResults
integer | null format: int32
condition
string | null
intervention
string | null
trialStatus
Array<string> | null

Example generated

{
  "query": "example",
  "databases": [
    "example"
  ],
  "maxResults": 1,
  "condition": "example",
  "intervention": "example",
  "trialStatus": [
    "example"
  ]
}

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media type*/*
object
pubmed
One of:
object
totalCount
required
integer format: int32
articles
required
Array<object>
object
pmid
required
string
title
string | null
authors
required
Array<string>
journal
string | null
publicationDate
string | null
volume
string | null
issue
string | null
pages
string | null
doi
string | null
publicationType
string | null
queryTranslation
string | null
clinicalTrials
One of:
object
totalCount
required
integer format: int32
studies
required
Array<object>
object
nctId
required
string
briefTitle
string | null
officialTitle
string | null
overallStatus
string | null
studyType
string | null
phases
required
Array<string>
conditions
required
Array<string>
enrollment
integer | null format: int32
sponsor
string | null
startDate
string | null
completionDate
string | null
briefSummary
string | null