Retrieve Job
curl --request GET \
--url https://discover.veritus.ai/api/v1/job/{jobId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://discover.veritus.ai/api/v1/job/{jobId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://discover.veritus.ai/api/v1/job/{jobId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://discover.veritus.ai/api/v1/job/{jobId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"status": "<string>",
"results": [
{
"abstract": "<string>",
"authors": "<string>",
"doi": "<string>",
"downloadable": true,
"engine": "<string>",
"fieldsOfStudy": [
"<string>"
],
"id": "<string>",
"impactFactor": {
"citationCount": 123,
"influentialCitationCount": 123,
"referenceCount": 123
},
"isOpenAccess": true,
"isPrePrint": true,
"journalName": "<string>",
"link": "<string>",
"pdfLink": "<string>",
"publicationType": "<string>",
"publishedAt": "<string>",
"score": 123,
"semanticLink": "<string>",
"title": "<string>",
"titleLink": "<string>",
"tldr": "<string>",
"v_country": "<string>",
"v_journal_name": "<string>",
"v_publisher": "<string>",
"v_quartile_ranking": "<string>",
"year": 123
}
]
}Search Jobs
Retrieve Job
Check the status of a job and retrieve results
GET
/
v1
/
job
/
{jobId}
Retrieve Job
curl --request GET \
--url https://discover.veritus.ai/api/v1/job/{jobId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://discover.veritus.ai/api/v1/job/{jobId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://discover.veritus.ai/api/v1/job/{jobId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://discover.veritus.ai/api/v1/job/{jobId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"status": "<string>",
"results": [
{
"abstract": "<string>",
"authors": "<string>",
"doi": "<string>",
"downloadable": true,
"engine": "<string>",
"fieldsOfStudy": [
"<string>"
],
"id": "<string>",
"impactFactor": {
"citationCount": 123,
"influentialCitationCount": 123,
"referenceCount": 123
},
"isOpenAccess": true,
"isPrePrint": true,
"journalName": "<string>",
"link": "<string>",
"pdfLink": "<string>",
"publicationType": "<string>",
"publishedAt": "<string>",
"score": 123,
"semanticLink": "<string>",
"title": "<string>",
"titleLink": "<string>",
"tldr": "<string>",
"v_country": "<string>",
"v_journal_name": "<string>",
"v_publisher": "<string>",
"v_quartile_ranking": "<string>",
"year": 123
}
]
}Get the status of a job by its job ID. Returns job status and results if the job has completed.
Parameters
string
required
The job ID returned from job creation
Response
Returns job status and results (if completed).string
Job status. Possible values:
queued: Job is queued for processingsuccess: Job completed successfullyerror: Job failed with an error
object[]
Array of paper results (only present when
status is success)Show child attributes
Show child attributes
string
Paper abstract text (string or null)
string
Comma-separated list of author names
string
Digital Object Identifier (string or null)
boolean
Whether the paper PDF is downloadable
string
Search engine used (optional)
string[]
Array of field of study categories
string
Unique paper identifier
object
boolean
Whether the paper is open access (optional)
boolean
Whether the paper is a preprint (optional)
string
Name of the journal (string or null)
string
URL to the paper (optional)
string
URL to the PDF (optional)
string
Type of publication (string or null)
string
Publication date (string or null)
number
Relevance score (number or null)
string
Link to Semantic Scholar page (optional)
string
Paper title
string
Link to paper title page (optional)
string
TLDR summary of the paper (string or null)
string
Country of publication venue (string or null)
string
Journal name from venue data (string or null)
string
Publisher name (string or null)
string
Quartile ranking (Q1, Q2, Q3, Q4, or null)
number
Publication year (number or null)
Example
After creating a job, use the returnedjobId to check status. Poll this endpoint or use a callback URL to be notified when the job completes.⌘I